UI-Automator für Google Home

Rechtsangelegenheit    Geräte-SDK

Google Home UI Automator kann Ihnen helfen, Ihr Google Home app (GHA)-Konto zu automatisieren um Matter in Betrieb zu nehmen, außer Betrieb zu nehmen oder eine Regression durchzuführen einen Test für Ihre Provision durchzuführen.

Diese Abbildung zeigt, wie ein Matter-Gerät mit Google Home gekoppelt wird

Voraussetzungen

Wenn Sie Google Home UI Automator verwenden möchten, benötigen Sie Folgendes:

Python 3

Es wird empfohlen, das Skript 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 den Modus Debugging von Nutzern. Smartphone. Entwickleroptionen aktivieren
  2. Verbinden Sie Ihr Android-Smartphone mit Ihrem Computer.

Google Home App

  1. Installiere GHA auf deinem Android-Smartphone. Achten Sie darauf, dass die GHA-Version 3.10.1.6 oder höher ist.
  2. Melden Sie sich in GHA in Ihrem Google-Konto an.

Google Home UI Automator installieren

Es gibt zwei Möglichkeiten, Google Home UI Automator, PyPI oder aus der Quelle zu installieren Code. Wir empfehlen die Installation mit PyPI.

pip install google-home-ui-automator

Aus Quellcode erstellen

Führen Sie in Ihrem Terminal die folgenden Schritte aus, um einen Build aus einem Quellcode zu erstellen:

  1. Dieses Repository klonen:

    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
Eingabewert Beschreibung Beispiel
DEVICE_NAME Ausgewähltes Matter-Gerät m5stack
PAIRING_CODE Kopplungscode deines Matter-Geräts. 34970112332
ROOM_NAME Zugewiesener Raum. Office

Diese Abbildung zeigt, wie Sie ein Matter-Gerät mit Google Home koppeln.

Matter-Gerät außer Betrieb nehmen

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

ui-automator --decommission DEVICE_NAME
Eingabewert Beschreibung Beispiel
DEVICE_NAME Zeigt den Namen des in Betrieb genommenen Matter-Geräts am GHA an. m5stack
Diese Abbildung zeigt die Symbole für Feedback und Berichte. Probleme in Google Home Playground.

Regressionstest ausführen

Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen das Flag angeben --regtest und --commission, 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]

Der Regressionstest unterstützt nur den Inbetriebnahme- und Außerbetriebszyklus. Standardmäßig wird der Regressionstest so lange 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 Führen Sie den Regressionstest in einer bestimmten Zeit und zu mehreren Wiederholungen aus. 5
--hub HUB_VERSION Hub-Version zum Steuern von Geräten in der GHA. 15.20221210.3.1
--dut Testgerä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

Senden Sie uns Ihre Meinung oder Ihr Feedback zur Verbesserung des Google Home UI Automator, schließen Sie unser Feedbackformular.

Probleme melden

Melden Sie Probleme mithilfe des Problemverfolgung