Automatyzator interfejsu Google Home

Sprawa

Google Home UI Automator może pomóc Ci zautomatyzować proces Google Home app (GHA) uruchamiania, wyłączania Matter lub przeprowadzania testu regresji w przypadku prowizji.

Ilustracja pokazująca, jak sparować urządzenie Matter z Google Home

Wymagania wstępne

Aby korzystać z Google Home UI Automator, przygotuj:

Python 3

Do uruchomienia skryptu zalecamy użycie środowiska Python 3. Google Home UI Automator wymaga Pythona w wersji 3.11 lub nowszej.

Telefon z Androidem

  1. Włącz tryb Debugowanie użytkownika na Androidtelefonie. Aby włączyć ustawienie debugowania, zapoznaj się z artykułem Włączanie opcji programisty.
  2. Podłącz telefon Android do komputera.

Aplikacja Google Home

  1. Zainstaluj aplikację GHA na Android telefonie. Sprawdź, czy wersja GHA to 3.1.1.14 i 3.32.126.2.
  2. Zaloguj się na konto Google w GHA.

Instalowanie narzędzia Google Home UI Automator

Google Home UI Automator można zainstalować na 2 sposoby: za pomocą PyPI lub z kodu źródłowego. Zalecamy instalację za pomocą PyPI.

pip install google-home-ui-automator

Tworzenie na podstawie kodu źródłowego

Aby skompilować kod źródłowy, wykonaj w terminalu te czynności:

  1. Sklonuj to repozytorium:

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

  2. Przejdź do sklonowanego repozytorium:

    cd ui-automator

  3. Uruchom to polecenie:

    pip install .

Konfigurowanie urządzenia Matter

Aby uruchomić urządzenie Matter, wpisz to polecenie:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Wartość wejściowa Opis Przykład
DEVICE_NAME Wybrano Matter urządzenie. m5stack
PAIRING_CODE Kod parowania urządzenia Matter. 34970112332
ROOM_NAME Przypisane pomieszczenie. Office
GOOGLE_ACCOUNT Konto do użycia w usłudze GHA. test@gmail.com

Ilustracja pokazująca, jak sparować urządzenie Matter z Google Home

Wycofywanie urządzenia Matter

Aby wycofać urządzenie Matter, wpisz to polecenie:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Wartość wejściowa Opis Przykład
DEVICE_NAME Wyświetla nazwę włączonego urządzenia Matter na urządzeniu GHA. m5stack
GOOGLE_ACCOUNT Konto do użycia w usłudze GHA. test@gmail.com
Ilustracja przedstawiająca ikony przesyłania opinii i zgłaszania problemów w Google Home Playground.

Przeprowadź test regresji

Aby uruchomić test regresji, wpisz ten kod. Aby uruchomić test regresji, musisz uwzględnić flagi --regtest i --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]
Wartość wejściowa Opis Przykład
DEVICE_NAME Wybrano Matter urządzenie. m5stack
PAIRING_CODE Kod parowania urządzenia Matter. 34970112332
ROOM_NAME Przypisane pomieszczenie. Office
GOOGLE_ACCOUNT Konto do użycia w usłudze GHA. test@gmail.com

Test regresji obsługuje tylko cykl uruchamiania i wyłączania. Domyślnie test regresji będzie działać, dopóki użytkownicy nie użyją klawiatury, aby zatrzymać proces.

Aby uzyskać bardziej szczegółowe wyniki testu, możesz dodać te elementy:

Wartość Wartość wejściowa Opis Przykład
--repeat REPEAT_TIMES Przeprowadzaj test regresji w ograniczonym czasie i wielokrotnie. 5
--hub HUB_VERSION Wersja centrali do sterowania urządzeniami w GHA. 15.20221210.3.1
--dut Urządzenie testowe.
MODEL Model urządzenia. X123123
TYPE Typ urządzenia. LIGHT
PROTOCOL Protokół urządzenia. MATTER
--fw DEVICE_FIRMWARE Oprogramowanie układowe urządzenia. 2.2.0

Ilustracja przedstawiająca podsumowanie testu regresji

Prześlij opinię

Aby przesłać swoje przemyślenia lub opinię na temat tego, jak ulepszyć korzystanie z Google Home UI Automator, wypełnij nasz formularz opinii.

Zgłaszanie problemów

Zgłaszaj napotkane problemy za pomocą narzędzia do śledzenia problemów.