Pannello di controllo di Seppia

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

Il pannello di controllo è dotato di pulsanti predefiniti per simulare azioni comuni del dispositivo fisico, come il tasto di accensione o i pulsanti 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 opzione è utile per testare funzionalità uniche del dispositivo, ad esempio un pulsante hardware o un gesto speciale che attiva un'azione unica nel sistema operativo. Puoi anche utilizzare i pulsanti personalizzati per attivare il test di funzionalità più incentrate sul QA, come il comportamento del sistema operativo quando la batteria del dispositivo è in esaurimento.

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

  1. Crea un file JSON che definisce 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 file make 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
  • Server di azioni

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

Comando shell ADB

Puoi definire un singolo pulsante che viene implementato eseguendo un singolo comando adb shell. Ad esempio, lo snippet JSON seguente 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:
    • command: un nome univoco per questo pulsante
    • title: un titolo del testo alternativo per questo pulsante
    • icon_name: il nome di un'icona da https://material.io/resources/icons

Server di azioni

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

I server di azioni consentono un controllo più efficace, ad esempio il mantenimento dello stato (ad esempio 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 file binario dell'host.

Il seguente snippet JSON definisce un server di azioni 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 dell'host
  • buttons: un array di pulsanti con gli stessi campi secondari sopra indicati

Dopo aver aggiornato la configurazione JSON, aggiungi il nome del modulo del server di azioni alla variabile di compilazione della 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 file binario dell'host del server di azioni deve eseguire i seguenti passaggi:

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

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

  2. In un ciclo, prova a leggere 128 byte dalla presa. Questi byte contengono gli eventi di pressione dei pulsanti inviati dal client WebRTC nel formatocommand:state. command è il valore fornito nella configurazione JSON e state è lo stato di pressione del pulsante (down o up).

  3. Intervieni sugli eventi in arrivo per simulare l'azione personalizzata.