Pannello di controllo di Seppia

L'interfaccia browser WebRTC predefinita per Cuttlefish include un pannello di controllo che offre più modi per interagire con il dispositivo virtuale.

Il pannello di controllo include pulsanti predefiniti per simulare le azioni comuni dei dispositivi fisici, come il tasto di accensione o i tasti del volume, nonché la rotazione del dispositivo.

Azioni personalizzate

Puoi personalizzare il pannello di controllo per aggiungere altri pulsanti che consentano al tuo dispositivo virtuale di emulare più da vicino il tuo dispositivo fisico. Questa funzionalità è utile per testare funzionalità uniche del tuo dispositivo, come un pulsante hardware o un gesto speciale che attiva un'azione unica nel sistema operativo. Puoi anche utilizzare pulsanti personalizzati per attivare il test di funzionalità più incentrate sul controllo qualità, ad esempio il comportamento del sistema operativo quando il livello della batteria del dispositivo è basso.

Il pannello di controllo Cuttlefish predefinito include il supporto per "collegare" azioni personalizzate senza dover modificare il progetto AOSP Cuttlefish principale. Il tuo dispositivo virtuale deve includere solo un file di configurazione minimo per iniziare a utilizzare le azioni personalizzate. Consulta questo file di configurazione dell'azione personalizzata di esempio.

  1. Crea un file JSON che definisca le azioni personalizzate del dispositivo. Puoi inserire questo file in qualsiasi directory di tua proprietà. La struttura di questo file è descritta nelle sezioni ADB shell e Action server.

  2. Crea un modulo prebuilt_etc_host per la configurazione JSON. Assicurati che sub_dir sia uguale a 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. Imposta le variabili di compilazione della configurazione di Soong nel makefile del prodotto del dispositivo per configurare il pacchetto host del dispositivo virtuale in modo da includere il file di configurazione dell'azione personalizzata.

    # 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

Esistono due metodi supportati per implementare un'azione personalizzata:

  • Comando shell ADB
  • Action server

Il file di configurazione JSON può definire più istanze di ogni tipo di implementazione.

Comando shell ADB

Puoi definire un singolo pulsante implementato eseguendo un singolo comando adb shell. Ad esempio, il seguente snippet JSON definisce un singolo pulsante che avvia una pagina web:

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

I campi sono:

  • shell_command: il comando da eseguire in adb shell quando viene premuto il pulsante
  • button: Un singolo oggetto pulsante con i seguenti campi secondari:

Action server

I server di azioni consentono un maggiore controllo sul comportamento delle tue azioni. Un server di azioni è un binario host che ascolta gli eventi di pressione dei pulsanti da WebRTC utilizzando una coppia di socket. WebRTC inoltra gli eventi al server delle azioni, che decide come implementare l'azione.

I server di azioni consentono un controllo più potente, ad esempio il mantenimento dello stato (come per un evento attivabile/disattivabile) o persino l'esecuzione di "meta-azioni" come l'interruzione del dispositivo corrente, l'avvio di altri dispositivi o l'avvio di un'estensione del browser per la registrazione dello schermo. Le possibilità sono limitate solo da ciò che decidi di implementare all'interno del binario host.

Lo snippet JSON seguente definisce un action server che ascolta gli eventi su due pulsanti:

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

I campi sono:

  • server: Il nome del modulo binario host
  • buttons: un array di pulsanti, con gli stessi campi secondari di cui sopra

Dopo aver aggiornato la configurazione JSON, aggiungi il nome del modulo del server di azioni alla variabile di build di configurazione Soong cvd_custom_action_servers. Ad esempio:

# 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

Ogni binario host del server di azioni deve eseguire i seguenti passaggi:

  1. Accetta un numero di descrittore di file socket come primo e unico argomento del programma.

    Questo socket viene creato da launch_cvd utilizzando socketpair con il dominio AF_LOCAL, il tipo SOCK_STREAM e il protocollo 0.

  2. In un ciclo, tenta di leggere 128 byte dal socket. Questi byte contengono eventi di pressione dei pulsanti inviati dal client WebRTC nel formato command:state. command è come fornito nella configurazione JSON e state è lo stato di pressione del pulsante (down o up).

  3. Agisci sugli eventi in entrata per simulare l'azione personalizzata.