Panel Kontrol Sotong

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 mensimulasikan tindakan perangkat fisik umum 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 meniru perangkat fisik Anda secara lebih dekat. Ini berguna untuk menguji fitur unik untuk perangkat Anda, seperti tombol perangkat keras atau gerakan khusus yang memicu tindakan unik di OS. Anda juga dapat menggunakan tombol khusus untuk mengaktifkan pengujian lebih banyak fitur yang berfokus pada QA seperti perilaku OS Anda saat baterai perangkat lemah.

Panel kontrol Sotong default menyertakan dukungan untuk "menyambungkan" tindakan kustom tanpa perlu memodifikasi proyek AOSP Sotong 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 mendefinisikan tindakan kustom perangkat Anda. Anda dapat meletakkan file ini di direktori mana pun yang Anda miliki. Struktur file ini dijelaskan di bagian shell ADB dan server Action .

  2. Buat modul prebuilt_etc_host untuk konfigurasi JSON Anda. Pastikan bahwa 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. Setel variabel build Soong config di makefile produk perangkat Anda untuk mengonfigurasi paket host perangkat virtual untuk 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 diimplementasikan 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"
  }
}

Bidang-bidang tersebut adalah:

  • shell_command : Perintah untuk dieksekusi di adb shell saat tombol ditekan
  • button : Objek tombol tunggal dengan subbidang berikut:

Server tindakan

Server tindakan memungkinkan lebih banyak kontrol atas perilaku tindakan Anda. Server tindakan adalah biner host yang mendengarkan peristiwa penekanan tombol dari WebRTC menggunakan pasangan soket. WebRTC meneruskan peristiwa ke server tindakan, dan kemudian server tindakan memutuskan bagaimana menerapkan tindakan.

Server tindakan memungkinkan kontrol yang lebih kuat, seperti mempertahankan status (seperti untuk acara yang dapat dialihkan) 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 diterapkan di dalam biner host.

Cuplikan JSON berikut mendefinisikan server tindakan yang mendengarkan peristiwa pada 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"
    }
  ]
}

Bidang-bidang tersebut adalah:

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

Setelah memperbarui konfigurasi JSON, tambahkan nama modul server tindakan ke variabel build Soong config cvd_custom_action_servers . Sebagai 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. Terima nomor deskriptor file soket sebagai argumen program pertama dan satu-satunya.

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

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

  3. Bertindak pada peristiwa yang masuk untuk mensimulasikan tindakan kustom.