UI Automator de Google Home

Matter

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

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

Requisitos previos

Para usar Google Home UI Automator, tenga listo lo siguiente:

Python 3

Se recomienda utilizar el entorno Python 3 para ejecutar el script. Google Home UI Automator requiere Python 3.11 o una versión posterior.

Teléfono Android

  1. Activa el modo User Debugging en tu teléfono Android. Consulte Habilitar opciones de desarrollador para activar la configuración de depuración.
  2. Conecta tu teléfono Android a tu ordenador.

App de Google Home

  1. Instala GHA en tu teléfono Android. Asegúrate de que la versión de GHA sea 3.1.1.14 y 3.32.126.2.
  2. Inicia sesión en tu cuenta de Google en GHA.

Instala Google Home UI Automator

Existen dos formas de instalar Google Home UI Automator: desde PyPI o desde el código fuente. Te recomendamos que realices la instalación con PyPI.

pip install google-home-ui-automator

Compilar desde el código fuente

Para compilar a partir de un código fuente, siga estos pasos en su 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 poner en funcionamiento un dispositivo Matter

Para poner en servicio un dispositivo Matter, ingresa el siguiente comando:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
Valor de entrada Descripción Ejemplo
DEVICE_NAME Se seleccionó el dispositivo Matter. m5stack
PAIRING_CODE Es el código de vinculación de tu dispositivo Matter. 34970112332
ROOM_NAME Habitación asignada. Office
GOOGLE_ACCOUNT Cuenta que se usará en GHA. test@gmail.com

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

Retira un dispositivo Matter

Para desactivar un dispositivo Matter, introduzca el siguiente comando:

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
Valor de entrada Descripción Ejemplo
DEVICE_NAME Muestra el nombre del dispositivo Matter puesto en marcha en GHA. m5stack
GOOGLE_ACCOUNT Cuenta que se usará en GHA. test@gmail.com
En esta figura, se muestran los íconos para proporcionar comentarios y denunciar 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 las marcas --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] [--google_account GOOGLE_ACCOUNT]
Valor de entrada Descripción Ejemplo
DEVICE_NAME Se seleccionó el dispositivo Matter. m5stack
PAIRING_CODE Es el código de vinculación de tu dispositivo Matter. 34970112332
ROOM_NAME Habitación asignada. Office
GOOGLE_ACCOUNT Cuenta a usar en GHA. test@gmail.com

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

Puedes agregar lo siguiente para obtener resultados de pruebas más detallados:

Valor Valor de entrada Descripción Ejemplo
--repeat REPEAT_TIMES Ejecuta la prueba de regresión en horarios limitados y repetidos. 5
--hub HUB_VERSION Es la versión de la unidad central para controlar dispositivos en GHA. 15.20221210.3.1
--dut Dispositivo bajo prueba.
MODEL Modelo del dispositivo X123123
TYPE Tipo de dispositivo LIGHT
PROTOCOL Es el protocolo del dispositivo. MATTER
--fw DEVICE_FIRMWARE Firmware del dispositivo 2.2.0
Si interrumpes el proceso de automatización, la prueba fallará.

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

Comentarios

Para enviar tus opiniones o comentarios sobre cómo mejorar tu experiencia con Google Home UI Automator, completa nuestro formulario de comentarios.

Cómo informar problemas

Informa los problemas que encuentres con la herramienta de seguimiento de errores.