Sistema di automatizzazione dell'interfaccia utente di Google Home

Oggetto

Google Home UI Automator può aiutarti ad automatizzare la tua Google Home app (GHA) per commissionare, ritirare Matter o eseguire un test di regressione sulla tua commissione.

Questa figura mostra come accoppiare un dispositivo Matter a Google Home

Prerequisiti

Per utilizzare Google Home UI Automator, tieni a portata di mano:

Python 3

Per eseguire lo script, ti consigliamo di utilizzare l'ambiente Python 3. Google Home UI Automator richiede Python 3.11 o versioni successive.

Smartphone Android

  1. Attiva la modalità Debug utente sullo smartphone Android. Consulta Attivare le opzioni sviluppatore per attivare l'impostazione di debug.
  2. Collega lo smartphone Android al computer.

App Google Home

  1. Installa GHA sul tuo smartphone Android. Assicurati che la versione di GHA sia 3.1.1.14 e 3.32.126.2.
  2. Accedi al tuo Account Google in GHA.

Installare Google Home UI Automator

Esistono due modi per installare Google Home UI Automator: tramite PyPI o dal codice sorgente. Ti consigliamo di eseguire l'installazione con PyPI.

pip install google-home-ui-automator

Creare dal codice sorgente

Per eseguire la compilazione da un codice sorgente, segui questi passaggi nel terminale:

  1. Clona questo repository:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator

  2. Vai al repository clonato:

    cd ui-automator

  3. Esegui questo comando:

    pip install .

Configurare un dispositivo Matter

Per eseguire il provisioning di un dispositivo Matter, inserisci il seguente comando:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Valore di input Descrizione Esempio
DEVICE_NAME Dispositivo Matter selezionato. m5stack
PAIRING_CODE Il codice di accoppiamento del tuo dispositivo Matter. 34970112332
ROOM_NAME Stanza assegnata. Office
GOOGLE_ACCOUNT Account da utilizzare in GHA. test@gmail.com

Questa figura mostra come accoppiare un dispositivo Matter a Google Home

Ritirare un dispositivo Matter

Per disattivare un dispositivo Matter, immettere il seguente comando:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Valore di input Descrizione Esempio
DEVICE_NAME Mostra il nome del dispositivo Matter commissionato su GHA. m5stack
GOOGLE_ACCOUNT Account da utilizzare in GHA. test@gmail.com
Questa figura mostra le icone per fornire feedback e segnalare problemi in Google Home Playground.

Eseguire un test di regressione

Per eseguire un test di regressione, inserisci il seguente codice. Per eseguire il test di regressione, devi includere i flag --regtest e --commission.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE] [--google_account GOOGLE_ACCOUNT]
Valore di input Descrizione Esempio
DEVICE_NAME Dispositivo Matter selezionato. m5stack
PAIRING_CODE Il codice di accoppiamento del tuo dispositivo Matter. 34970112332
ROOM_NAME Stanza assegnata. Office
GOOGLE_ACCOUNT Account da utilizzare in GHA. test@gmail.com

Il test di regressione supporta solo il ciclo di attivazione e disattivazione. Per impostazione predefinita, il test di regressione viene eseguito finché gli utenti non utilizzano la tastiera per interrompere il processo.

Per risultati del test più approfonditi, puoi aggiungere:

Valore Valore di input Descrizione Esempio
--repeat REPEAT_TIMES Esegui il test di regressione in un numero limitato di volte e ripetutamente. 5
--hub HUB_VERSION Versione hub per il controllo dei dispositivi su GHA. 15.20221210.3.1
--dut Dispositivo in fase di test.
MODEL Modello del dispositivo. X123123
TYPE Tipo di dispositivo. LIGHT
PROTOCOL Protocollo del dispositivo. MATTER
--fw DEVICE_FIRMWARE Firmware del dispositivo. 2.2.0

Questa figura mostra il riepilogo del test di regressione

Feedback

Per inviare i tuoi pensieri o feedback su come migliorare la tua esperienza con Google Home UI Automator, compila il nostro modulo di feedback.

Problemi con i rapporti

Segnala i problemi riscontrati utilizzando lo strumento di monitoraggio dei problemi.