Panel kontrol cumi-cumi

Antarmuka browser WebRTC default untuk Cuttlefish menyertakan panel kontrol yang memungkinkan lebih banyak cara untuk berinteraksi dengan perangkat virtual.

Panel kontrol menampilkan tombol default untuk menyimulasikan tindakan umum perangkat fisik seperti tombol daya atau tombol volume, serta rotasi perangkat.

Tindakan kustom

Anda dapat menyesuaikan panel kontrol untuk menambahkan lebih banyak tombol yang memungkinkan perangkat virtual Anda mengemulasi perangkat fisik Anda dengan lebih dekat. Hal ini berguna untuk menguji fitur yang unik untuk perangkat Anda, seperti tombol hardware atau gestur khusus yang memicu tindakan unik di OS. Anda juga dapat menggunakan tombol kustom untuk mengaktifkan pengujian lebih banyak fitur yang berfokus pada QA seperti perilaku OS saat baterai perangkat lemah.

Panel kontrol Cuttlefish default menyertakan dukungan untuk tindakan kustom "colokkan" tanpa perlu mengubah project AOSP Cuttlefish utama. Perangkat virtual Anda hanya perlu menyertakan file konfigurasi minimal untuk mulai menggunakan tindakan kustom. Lihat contoh file konfigurasi tindakan kustom ini.

  1. Buat file JSON yang menentukan tindakan kustom perangkat Anda. Anda dapat menempatkan file ini di direktori apa pun yang Anda miliki. Struktur file ini dijelaskan di bagian ADB shell dan Server Action.

  2. Buat modul prebuilt_etc_host untuk konfigurasi JSON Anda. Pastikan sub_dir sama dengan cvd_custom_action_config.

    prebuilt_etc_host {
    // Use any name you choose.
    name: "my_custom_action_config.json",
    src: "my_custom_action_config.json",
    // Always use this sub_dir.
    sub_dir: "cvd_custom_action_config",
}

  3. Tetapkan variabel build konfigurasi Soong di makefile produk perangkat Anda untuk mengonfigurasi paket host perangkat virtual guna menyertakan file konfigurasi tindakan kustom Anda.

    # Set these variables exactly as shown here to enable the host package to see
# your custom config module name.
SOONG_CONFIG_NAMESPACES += cvd
SOONG_CONFIG_cvd += custom_action_config

# Set this value to the name of your JSON module.
SOONG_CONFIG_cvd_custom_action_config := my_custom_action_config.json

Ada dua metode yang didukung untuk menerapkan tindakan kustom:

  • Perintah shell ADB
  • Server tindakan

File konfigurasi JSON Anda dapat menentukan beberapa instance dari setiap jenis implementasi.

Perintah shell ADB

Anda dapat menentukan satu tombol yang diterapkan dengan menjalankan satu perintah adb shell. Misalnya, cuplikan JSON berikut menentukan satu tombol yang meluncurkan halaman web:

{
  "shell_command":"am start -a android.intent.action.VIEW -d https://www.android.com/",
  "button":{
      "command":"web",
      "title":"Web Page",
      "icon_name":"language"
  }
}

Kolomnya adalah:

  • shell_command: Perintah yang akan dieksekusi di adb shell saat tombol ditekan
  • button: Satu objek tombol dengan subkolom berikut:

Server tindakan

Server tindakan memungkinkan kontrol lebih besar atas perilaku tindakan Anda. Server tindakan adalah biner host yang memproses peristiwa penekanan tombol dari WebRTC menggunakan pasangan soket. WebRTC meneruskan peristiwa ke server tindakan, lalu server tindakan memutuskan cara menerapkan tindakan.

Server tindakan memungkinkan kontrol yang lebih kuat, seperti mempertahankan status (misalnya untuk peristiwa yang dapat diganti statusnya) atau bahkan menjalankan "tindakan meta" seperti mematikan perangkat saat ini, meluncurkan lebih banyak perangkat, atau memulai ekstensi browser perekaman layar. Kemungkinannya hanya dibatasi oleh apa yang Anda putuskan untuk diimplementasikan di dalam biner host.

Cuplikan JSON berikut menentukan server tindakan yang memproses peristiwa di dua tombol:

{
  "server":"cuttlefish_example_action_server",
  "buttons":[
    {
      "command":"settings",
      "title":"Quick Settings",
      "icon_name":"settings"
    },
    {
      "command":"alert",
      "title":"Do Not Disturb",
      "icon_name":"notifications_paused"
    }
  ]
}

Kolomnya adalah:

  • server: Nama modul biner host Anda
  • buttons: Array tombol, dengan subkolom yang sama seperti di atas

Setelah memperbarui konfigurasi JSON, tambahkan nama modul server tindakan ke variabel build konfigurasi Soong cvd_custom_action_servers. Contoh:

# Append to this variable exactly as shown here.
SOONG_CONFIG_cvd += custom_action_servers

# Append the name of your action server(s) to this variable.
SOONG_CONFIG_cvd_custom_action_servers += cuttlefish_example_action_server

Setiap biner host server tindakan harus melakukan langkah-langkah berikut:

  1. Menerima nomor deskripsi file soket sebagai argumen program pertama dan satu-satunya.

    Soket ini dibuat oleh launch_cvd menggunakan socketpair dengan domain AF_LOCAL, jenis SOCK_STREAM, dan protokol 0.

  2. Dalam satu loop, coba baca 128 byte dari soket. Byte ini berisi peristiwa penekanan tombol yang dikirim oleh klien WebRTC dalam format command:state. command seperti yang disediakan dalam konfigurasi JSON, dan state adalah status penekanan tombol (down atau up).

  3. Tindakan pada peristiwa yang masuk untuk menyimulasikan tindakan kustom.