UI Automator de Google Home

Matter    SDK de dispositivos

Google Home UI Automator puede ayudarte a automatizar tu Google Home app (GHA) para asignar, retirar Matter o ejecutar una regresión prueba sobre tu comisión.

En esta figura, se muestra cómo vincular un dispositivo Matter a Google Home

Requisitos

Para usar Google Home UI Automator, tienes a mano lo siguiente:

Python 3

Se recomienda usar el entorno de Python 3 para ejecutar la secuencia de comandos. Google Home UI Automator requiere Python 3.11 o versiones posteriores.

Teléfono Android

  1. Activa el modo de depuración de usuarios en tu teléfono Android. Consulta Habilita las Opciones para desarrolladores para activar la configuración de depuración.
  2. Conecta el teléfono Android a la computadora.

App de Google Home

  1. Instala GHA en tu teléfono Android. Asegúrate de que la versión de GHA sea 3.10.1.6 o posterior.
  2. Accede a tu Cuenta de Google en GHA.

Cómo instalar UI Automator de Google Home

Hay dos maneras de instalar Google Home UI Automator, PyPI o desde la fuente código. Recomendamos realizar la instalación con PyPI.

pip install google-home-ui-automator

Compila a partir del código fuente

Para compilar a partir de un código fuente, sigue estos pasos en la terminal:

  1. Clona este repositorio:

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

  2. Navega al repositorio clonado:

    cd ui-automator

  3. Ejecuta el siguiente comando:

    pip install .

Cómo solicitar un dispositivo Matter

Para encargar un dispositivo Matter, ingresa el siguiente comando:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Valor de entrada Descripción Ejemplo
DEVICE_NAME Se seleccionó Matter dispositivo. m5stack
PAIRING_CODE Código de vinculación de tu dispositivo Matter 34970112332
ROOM_NAME Sala asignada. Office

En esta figura, se muestra cómo vincular un dispositivo Matter a Google Home

Cómo retirar un dispositivo Matter

Para dar de baja un dispositivo Matter, ingresa el siguiente comando:

ui-automator --decommission DEVICE_NAME
Valor de entrada Descripción Ejemplo
DEVICE_NAME Muestra el nombre del dispositivo Matter encargado en GHA. m5stack
En esta imagen, se muestran los íconos para enviar comentarios y avisar sobre problemas en Google Home Playground.

Ejecuta una prueba de regresión

Para ejecutar una prueba de regresión, ingresa el siguiente código. Debes incluir la marca --regtest y --commission para ejecutar la prueba de regresión.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

La prueba de regresión solo admite el ciclo de puesta en servicio y retiro de servicio. De forma predeterminada, la prueba de regresión se ejecutará hasta que los usuarios usen el teclado para detenerse el proceso.

Puedes agregar los siguientes datos para obtener resultados de prueba más detallados:

Valor Valor de entrada Descripción Ejemplo
--repeat REPEAT_TIMES Ejecuta la prueba de regresión en tiempos limitados y repetidos. 5
--hub HUB_VERSION Versión Hub para controlar dispositivos en GHA. 15.20221210.3.1
--dut Dispositivo a prueba.
MODEL Modelo del dispositivo. X123123
TYPE Tipo de dispositivo LIGHT
PROTOCOL Protocolo del dispositivo. MATTER
--fw DEVICE_FIRMWARE Firmware del dispositivo. 2.2.0

En esta figura, se muestra el resumen de la prueba de regresión

Comentarios

Para enviar sus opiniones o comentarios sobre cómo mejorar su experiencia con el Google Home UI Automator, completa nuestra Formulario de comentarios.

Cómo informar problemas

Informar los problemas encontrados con el Herramienta de seguimiento de errores.