UI Automator de Google Home

Matter

Google Home UI Automator peut vous aider à automatiser votre Google Home app (GHA) pour mettre en service ou hors service des appareils Matter, ou exécuter un test de régression sur votre mise en service.

Cette figure montre comment associer un appareil Matter à Google Home.

Conditions préalables

Pour utiliser Google Home UI Automator, préparez les éléments suivants :

Python 3

Nous vous recommandons d'utiliser un environnement Python 3 pour exécuter le script. Google Home UI Automator nécessite Python 3.11 ou une version ultérieure.

Téléphone Android

  1. Activez le mode Débogage utilisateur sur votre Android téléphone. Consultez Activer les options pour les développeurs pour activer le paramètre de débogage.
  2. Connectez votre téléphone Android à votre ordinateur.

Application Google Home

  1. Installez GHA sur votre téléphone Android. Assurez-vous que la GHA version est 3.1.1.14 et 3.32.126.2.
  2. Connectez-vous à votre compte Google dans GHA.

Installer Google Home UI Automator

Vous pouvez installer Google Home UI Automator de deux manières : à partir de PyPI ou du code source. Nous vous recommandons d'installer à partir de PyPI.

pip install google-home-ui-automator

Compiler à partir du code source

Pour compiler à partir d'un code source, procédez comme suit dans votre terminal :

  1. Clonez ce dépôt :

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator

  2. Accédez au dépôt cloné :

    cd ui-automator

  3. Exécutez la commande suivante :

    pip install .

Mettre en service un appareil Matter

Pour mettre en service un appareil Matter, saisissez la commande suivante :

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Valeur d'entrée Description Exemple
DEVICE_NAME Appareil Matter sélectionné. m5stack
PAIRING_CODE Code de couplage de votre Matter appareil. 34970112332
ROOM_NAME Pièce attribuée. Office
GOOGLE_ACCOUNT Compte à utiliser dans GHA. test@gmail.com

Cette figure montre comment associer un appareil Matter à Google Home.

Mettre hors service un appareil Matter

Pour mettre hors service un appareil Matter, saisissez la commande suivante :

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Valeur d'entrée Description Exemple
DEVICE_NAME Affiche le nom de l'appareil Matter mis en service dans GHA. m5stack
GOOGLE_ACCOUNT Compte à utiliser dans GHA. test@gmail.com
Cette figure montre les icônes permettant d'envoyer des commentaires et de signaler des problèmes dans Google Home Playground.

Exécuter un test de régression

Pour exécuter un test de régression, saisissez le code suivant. Vous devez inclure les indicateurs --regtest et --commission pour exécuter le test de régression.

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]
Valeur d'entrée Description Exemple
DEVICE_NAME Appareil Matter sélectionné. m5stack
PAIRING_CODE Code de couplage de votre Matter appareil. 34970112332
ROOM_NAME Pièce attribuée. Office
GOOGLE_ACCOUNT Compte à utiliser dans GHA. test@gmail.com

Le test de régression n'est compatible qu'avec le cycle de mise en service et de mise hors service. Par défaut, le test de régression s'exécute jusqu'à ce que les utilisateurs utilisent le clavier pour arrêter le processus.

Vous pouvez ajouter les éléments suivants pour obtenir des résultats de test plus détaillés :

Valeur Valeur d'entrée Description Exemple
--repeat REPEAT_TIMES Exécute le test de régression un nombre limité de fois. 5
--hub HUB_VERSION Version du hub pour contrôler les appareils dans l'AGH. 15.20221210.3.1
--dut Appareil soumis aux tests.
MODEL Modèle de l'appareil. X123123
TYPE Type d'appareil. LIGHT
PROTOCOL Protocole de l'appareil. MATTER
--fw DEVICE_FIRMWARE Micrologiciel de l'appareil. 2.2.0

Cette figure montre le récapitulatif du test de régression.

Commentaires

Pour nous faire part de vos commentaires ou suggestions sur la façon d'améliorer votre expérience avec le Google Home UI Automator, remplissez notre formulaire de commentaires.

Signaler des problèmes

Signalez les problèmes rencontrés à l'aide de l' outil de suivi des problèmes.