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.

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
- Aktivieren Sie auf Ihrem Android Smartphone den Modus Nutzer-Debugging. Informationen zum Aktivieren der Debugging-Einstellung finden Sie unter Entwickleroptionen aktivieren.
- Verbinden Sie Ihr Android Smartphone mit Ihrem Computer.
Google Home App
- Installieren Sie GHA auf Ihrem Android-Smartphone.
Die Version von GHA' muss
3.1.1.14und3.32.126.2sein. - 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.
PyPI (empfohlen)
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:
Klonen Sie dieses Repository:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automatorWechseln Sie zum geklonten Repository:
cd ui-automatorFü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 |


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 |
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 |

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.