Sistema di automatizzazione dell'interfaccia utente di Google Home

Matter    SDK dispositivo

Google Home UI Automator può aiutarti ad automatizzare la tua Google Home app (GHA) per eseguire le commissioni, il ritiro di 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 quanto segue:

Python 3

È consigliabile utilizzare l'ambiente Python 3 per eseguire lo script. Google Home UI Automator richiede Python 3.11 o una versione successiva.

Smartphone Android

  1. Attiva la modalità debug utente sul tuo smartphone Android. Per attivare l'impostazione di debug, consulta Attivazione delle Opzioni sviluppatore.
  2. Collega il telefono Android al computer.

App Google Home

  1. Installa GHA sul tuo telefono Android. Assicurati che la versione di GHA sia 3.10.1.6 o successiva.
  2. Accedi al tuo Account Google in GHA.

Installa il programma di automatizzazione dell'interfaccia utente di Google Home

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

pip install google-home-ui-automator

Crea da codice sorgente

Per creare da un codice sorgente, segui questi passaggi nel tuo terminale:

  1. Clona questo repository:

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

  2. Passa al repository clonato:

    cd ui-automator

  3. Esegui questo comando:

    pip install .

Messa in servizio di un dispositivo Matter

Per la messa in servizio di un dispositivo Matter, inserisci il seguente comando:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Valore di input Descrizione Esempio
DEVICE_NAME Dispositivo Matter selezionato. m5stack
PAIRING_CODE Codice di accoppiamento del tuo dispositivo Matter. 34970112332
ROOM_NAME Stanza assegnata. Office

Questa figura mostra come accoppiare un dispositivo Matter a Google Home

Ritirare un dispositivo Matter

Per ritirare un dispositivo Matter, inserisci il seguente comando:

ui-automator --decommission DEVICE_NAME
Valore di input Descrizione Esempio
DEVICE_NAME Mostra il nome del dispositivo Matter commissionato il giorno GHA. m5stack
Questa figura mostra le icone per fornire feedback e segnalare problemi in Google Home Playground.

Esegui un test di regressione

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

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

Il test di regressione supporta solo il ciclo di messa in servizio e disattivazione. Per impostazione predefinita, il test di regressione verrà eseguito finché gli utenti non utilizzeranno la tastiera per interrompere il processo.

Puoi aggiungere quanto segue per ottenere risultati del test più approfonditi:

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

Questa figura mostra il riepilogo del test di regressione

Feedback

Per inviare le tue opinioni o feedback su come migliorare la tua esperienza con Google Home UI Automator, compila il nostro modulo di feedback.

Segnalare i problemi

Segnala eventuali problemi utilizzando l'Issue Tracker.