UI-Automator für Google Home

Matter

Google Home UI Automator kann Ihnen helfen, Ihre Google Home app (GHA) zu automatisieren, um Matter in Betrieb zu nehmen oder außer Betrieb zu setzen oder einen Regressionstest für Ihre Inbetriebnahme durchzuführen.

Auf diesem Bild wird gezeigt, wie ein Matter-Gerät mit Google Home gekoppelt wird.

Voraussetzungen

Für die Verwendung von Google Home UI Automator benötigen Sie Folgendes:

Python 3

Wir empfehlen, die Skripts in einer Python 3-Umgebung auszuführen. Google Home UI Automator erfordert Python 3.11 oder höher.

Android-Smartphone

  1. Aktivieren Sie auf Ihrem Android Smartphone den Modus Nutzer-Debugging. Informationen zum Aktivieren der Debugging-Einstellung finden Sie unter Entwickleroptionen aktivieren.
  2. Verbinden Sie Ihr Android Smartphone mit Ihrem Computer.

Google Home App

  1. Installieren Sie GHA auf Ihrem Android-Smartphone. Die Version von GHA' muss 3.1.1.14 und 3.32.126.2 sein.
  2. Melden Sie sich in GHA in Ihrem Google-Konto an.

Google Home UI Automator installieren

Sie haben zwei Möglichkeiten, Google Home UI Automator zu installieren: über PyPI oder über den Quell code. Wir empfehlen die Installation über PyPI.

pip install google-home-ui-automator

Aus Quellcode erstellen

So erstellen Sie ein Build aus einem Quellcode: Führen Sie die folgenden Schritte im Terminal aus:

  1. Klonen Sie dieses Repository:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
    
  2. Wechseln Sie zum geklonten Repository:

    cd ui-automator
    
  3. Führen Sie dazu diesen Befehl aus:

    pip install .
    

Matter-Gerät in Betrieb nehmen

Geben Sie den folgenden Befehl ein, um ein Matter Gerät in Betrieb zu nehmen:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Eingabewert Beschreibung Beispiel
DEVICE_NAME Ausgewähltes Matter Gerät. m5stack
PAIRING_CODE Kopplungscode Ihres Matter Geräts. 34970112332
ROOM_NAME Zugewiesener Raum. Office
GOOGLE_ACCOUNT Konto, das in GHA verwendet werden soll. test@gmail.com

Auf diesem Bild wird gezeigt, wie ein Matter-Gerät mit Google Home gekoppelt wird.

Matter-Gerät außer Betrieb setzen

Geben Sie den folgenden Befehl ein, um ein Matter-Gerät außer Betrieb zu setzen:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Eingabewert Beschreibung Beispiel
DEVICE_NAME Zeigt den Namen des in Betrieb genommenen Matter Geräts in der GHA an. m5stack
GOOGLE_ACCOUNT Konto, das in GHA verwendet werden soll. test@gmail.com
Auf diesem Bild sind die Symbole zum Geben von Feedback und Melden von Problemen in Google Home Playground zu sehen.

Regressionstest ausführen

Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen die Flags --regtest und --commission einfügen, um den Regressionstest auszuführen.

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]
Eingabewert Beschreibung Beispiel
DEVICE_NAME Ausgewähltes Matter Gerät. m5stack
PAIRING_CODE Kopplungscode Ihres Matter Geräts. 34970112332
ROOM_NAME Zugewiesener Raum. Office
GOOGLE_ACCOUNT Konto, das in GHA verwendet werden soll. test@gmail.com

Der Regressionstest unterstützt nur den Zyklus der Inbetriebnahme und Außerbetriebnahme. Standardmäßig wird der Regressionstest ausgeführt, bis Nutzer den Vorgang über die Tastatur beenden.

Sie können Folgendes hinzufügen, um detailliertere Testergebnisse zu erhalten:

Wert Eingabewert Beschreibung Beispiel
--repeat REPEAT_TIMES Regressionstest in begrenzter Anzahl und wiederholter Anzahl ausführen. 5
--hub HUB_VERSION Hub-Version zum Steuern von Geräten in der GHA. 15.20221210.3.1
--dut Zu testendes Gerät.
MODEL Gerätemodell. X123123
TYPE Gerätetyp. LIGHT
PROTOCOL Geräteprotokoll. MATTER
--fw DEVICE_FIRMWARE Gerätefirmware. 2.2.0

Diese Abbildung zeigt die Zusammenfassung des Regressionstests.

Feedback

Wenn Sie uns Ihre Meinung oder Feedback zur Verbesserung von Google Home UI Automator mitteilen möchten, füllen Sie unser Feedbackformular aus.

Probleme melden

Melden Sie aufgetretene Probleme über die Problemverfolgung.