Automatyzator interfejsu Google Home

Matter    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ć test regresji w przypadku zleceń.

Ilustracja pokazująca, jak sparować urządzenie obsługujące standard Matter z Google Home

Wymagania wstępne

Aby korzystać z Google Home UI Automator, musisz mieć:

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 na telefonie Android tryb debugowania przez użytkownika. Aby włączyć ustawienie debugowania, przeczytaj artykuł 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.25.1.4.
  2. Zaloguj się na konto Google w GHA.

Instalowanie automatyzacji interfejsu Google Home

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

pip install google-home-ui-automator

Kompilowanie na podstawie kodu źródłowego

Aby skompilować z 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 Przypisany pokój. Office

Ilustracja pokazująca, jak sparować urządzenie obsługujące standard Matter z Google Home

Wyłączanie urządzenia Matter

Aby wycofać urządzenie Matter z użycia, wpisz to polecenie:

ui-automator --decommission DEVICE_NAME
Wartość wejściowa Opis Przykład
DEVICE_NAME Wyświetla nazwę urządzenia Matter w trybie 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 uruchomić test regresji, wpisz ten kod. Aby przeprowadzić 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]

Test regresji obsługuje tylko cykl uruchamiania i wyłączania. Domyślnie test regresji będzie się wykonywać, dopóki użytkownicy nie przerwą go za pomocą klawiatury.

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

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 układowe 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

Zgłaszaj problemy za pomocą śledzika problemów.