Automatyzator interfejsu Google Home

Sprawa    Pakiet SDK urządzenia

Funkcja Google Home UI Automator może pomóc Ci zautomatyzować proces Google Home app (GHA) dotyczący prowizji lub wyłączenia Matter albo przeprowadzić test regresji na potrzeby prowizji.

Ten rysunek pokazuje, jak sparować urządzenie Matter z Google Home

Wymagania wstępne

Aby korzystać z usługi Google Home UI Automator, przygotuj te elementy:

Python 3

Do uruchomienia skryptu zalecamy użycie środowiska Pythona 3. Google Home UI Automator wymaga Pythona 3.11 lub nowszego.

telefon z Androidem

  1. Na telefonie Android włącz tryb Debugowanie użytkownika. Informacje o włączaniu ustawienia debugowania znajdziesz w artykule Włączanie opcji programisty.
  2. Podłącz telefon Android do komputera.

Aplikacja Google Home

  1. Zainstaluj aplikację GHA na telefonie Android. Sprawdź, czy GHA ma wersję 3.10.1.6 lub nowszą.
  2. Zaloguj się na swoje konto Google w aplikacji GHA.

Zainstaluj automatyzator interfejsu Google Home

Są 2 sposoby instalacji Google Home UI Automator, PyPI lub z kodu źródłowego. Zalecamy instalację za pomocą PyPI.

pip install google-home-ui-automator

Kompiluj z kodu źródłowego

Aby skompilować plik na podstawie kodu źródłowego, 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 .

Przekaż urządzenie ze standardem Matter

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

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Wartość wejściowa Opis Przykład
DEVICE_NAME Wybrano Matter urządzenie. m5stack
PAIRING_CODE Kod parowania urządzenia Matter. 34970112332
ROOM_NAME Przypisana sala. Office

Ten rysunek pokazuje, jak sparować urządzenie Matter z Google Home

Wycofywanie urządzenia ze standardem Matter

Aby wyłączyć urządzenie ze standardem Matter, wpisz to polecenie:

ui-automator --decommission DEVICE_NAME
Wartość wejściowa Opis Przykład
DEVICE_NAME Wyświetla nazwę zamówionego urządzenia Matter w systemie GHA. m5stack
Ilustracja przedstawia ikony umożliwiające przesyłanie opinii i zgłaszanie problemów w Google Home Playground.

Przeprowadź test regresji

Aby przeprowadzić test regresji, wpisz ten kod. Aby uruchomić test regresji, musisz dodać 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]

Test regresji obsługuje tylko cykl uruchomienia i wycofania. Domyślnie test regresji będzie uruchamiany, dopóki użytkownik nie zatrzyma procesu za pomocą klawiatury.

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

Wartość Wartość wejściowa Opis Przykład
--repeat REPEAT_TIMES Przeprowadź 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 w trakcie testowania.
MODEL Model urządzenia. X123123
TYPE Typ urządzenia. LIGHT
PROTOCOL Protokół urządzenia. MATTER
--fw DEVICE_FIRMWARE Oprogramowanie urządzenia. 2.2.0

Ten rysunek przedstawia podsumowanie testu regresji

Prześlij opinię

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

Zgłaszanie problemów

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