Automatyzator interfejsu Google Home

Sprawa    Pakiet SDK urządzenia

Google Home UI Automator może pomóc Ci zautomatyzować Google Home app (GHA), aby zlecać i odwoływać Matter lub przeprowadzać regresję Google Home UI Automator.

Ilustracja pokazująca, jak sparować urządzenie obsługujące standard 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 Python 3. Google Home UI Automator wymaga Pythona 3.11 lub nowszego.

Telefon z Androidem

  1. Włącz tryb Debugowanie użytkownika na urządzeniu Android telefonu. 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 GHA na telefonie Android. Upewnij się, że wersja GHA to 3.1.1.14 i 3.24.1.4.
  2. Zaloguj się na swoje konto Google w aplikacji GHA.

Instalowanie automatyzacji interfejsu Google Home

Istnieją 2 sposoby instalacji: Google Home UI Automator, PyPI lub ze źródła w kodzie. Zalecamy instalację za pomocą PyPI.

pip install google-home-ui-automator

Kompilowanie na podstawie 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 .

Konfigurowanie urządzenia obsługującego standard 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 Wybrane urządzenie Matter. 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

Wyłączanie urządzenia 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 przedstawiająca ikony służące do przesyłania opinii i zgłaszania problemów w Google Home Playground.

Przeprowadzanie testu regresji

Aby przeprowadzić test regresji, wpisz ten kod. Musisz dodać flagę --regtest i --commission, aby uruchomić test regresji.

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 uruchamiania i wyłączania. Domyślnie test regresji będzie uruchamiany, dopóki użytkownik nie zatrzymasz go przy użyciu klawiatury cały proces.

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

Wartość Wartość wejściowa Opis Przykład
--repeat REPEAT_TIMES Uruchom test regresji ograniczoną liczbę razy i powtórnie. 5
--hub HUB_VERSION Wersja huba 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 urządzenia. 2.2.0

Rysunek przedstawiający podsumowanie testu regresji

Prześlij opinię

Aby przesłać opinię o tym, jak poprawić działanie Google Home UI Automator, wypełnij formularz opinii.

Zgłaszanie problemów

W raporcie wystąpiły problemy z użyciem parametru narzędzia do śledzenia problemów.