Usa la app de ejemplo para Android

La app de ejemplo para Android muestra las funciones básicas de acceso y control de dispositivos con las APIs de Home para los tipos de dispositivos que admite.

Una vez que se completa la autorización de la cuenta y se selecciona una estructura, la app de ejemplo carga todos los dispositivos locales que se encuentran en esa estructura.

Si un dispositivo está en una habitación, aparecerá debajo de ella. La app de ejemplo admite los siguientes tipos de dispositivos:

  • Luz con temperatura de color (encendido y apagado, brillo)
  • Sensor de contacto (estado booleano)
  • Luz regulable (encendido y apagado, brillo)
  • Cerradura
  • Luz de color extendida (encendido y apagado, brillo)
  • Generic Switch
  • Router de borde de Google
  • Cámara de Google
  • Google Doorbell
  • Sensor de ocupación (detección de ocupación)
  • Luz de encendido/apagado (encendido y apagado, brillo)
  • Interruptor de luz de encendido/apagado
  • Unidad de enchufe de encendido/apagado (encendido y apagado)
  • Sensor de encendido/apagado

Acciones en dispositivos y automatizaciones existentes

La app de ejemplo consta de dos pestañas: Dispositivos y Automatizaciones. Cada pestaña proporciona información sobre la estructura y te permite realizar tareas.

Pestaña "Dispositivos"

La pestaña Devices (figura 1) muestra las habitaciones de la estructura (Backyard, Attic, Travel) y los dispositivos de cada habitación, junto con el estado de cada dispositivo. Para ver o editar los atributos de un dispositivo, presiona su nombre. Esta acción te llevará a la pantalla de control de ese dispositivo (figura 2).

Para agregar un dispositivo a la estructura, presiona Agregar dispositivo en la pestaña Dispositivos (figura 1) y, luego, sigue las instrucciones para agregar un dispositivo con o sin un código QR.

Pestaña Devices de la app de ejemplo de las APIs de Home.
Figura 1: Pantalla de la app de ejemplo: vista de la pestaña Dispositivos
Controles de dispositivos de la app de ejemplo de las APIs de Home.
Figura 2: Controles de dispositivos de la app de ejemplo

Pestaña Automatizaciones

En la pestaña Automatizaciones (figura 3), se muestra una lista de todas las automatizaciones de la estructura. Cada automatización muestra sus activadores y acciones. Se admiten varios activadores y acciones.

Presiona una automatización para ver sus detalles, como se muestra en el ejemplo de la Figura 4. En esta vista detallada, puedes borrar la automatización o ejecutarla de forma manual sin necesidad de un activador, siempre que el botón Ejecutar manualmente sea compatible con esta automatización.

También en la vista detallada de una automatización (figura 4), puedes activar o desactivar isActive para activar o desactivar la automatización. El SDK establece el campo isValid y es false si hay un problema con la compatibilidad del dispositivo o de la característica, o algún otro problema.

Pestaña Automatizaciones de la app de ejemplo de las APIs de Home.
Figura 3: Vista de la pestaña Automatizaciones
Vista detallada de una automatización seleccionada.
Figura 4: Vista detallada de una automatización

Crea una automatización

Para crear una automatización nueva, presiona el botón Crear en la vista de lista de automatizaciones (figura 3). Aparecerá la pantalla Nueva automatización (figura 5).

Usa los botones + Agregar activador y + Agregar acción (figura 5) para agregar uno o más activadores y acciones a tu automatización. En las Figuras 6 y 7, se muestran ejemplos de cómo seleccionar un activador y una acción, respectivamente. Después de realizar tus selecciones y guardar el activador o la acción, se te presentarán los botones Actualizar activador y Quitar activador para el activador (y Actualizar acción y Quitar acción para la acción). Esto te da la oportunidad de editar el activador o la acción, o quitarlos, antes de guardar la automatización.

Cuando termines de agregar activadores y acciones, puedes volver a la pantalla Nueva automatización y presionar Crear automatización (figura 8).

Pantalla de la app de ejemplo para iniciar una automatización nueva.
Figura 5: Comienza a crear una automatización nueva
Pantalla de la app de ejemplo para agregar un activador para una automatización.
Figura 6: Agrega un activador a una automatización
Pantalla de la app de ejemplo para agregar una acción a una automatización.
Figura 7: Agrega una acción a una automatización
Pantalla de la app de ejemplo para crear una automatización.
Figura 8: Crea la automatización

Solución de problemas

La app muestra mensajes de diálogo para algunos eventos comunes que pueden ocurrir. Consulta los registros de adb para obtener información sobre cómo resolver estos eventos.

Si tienes problemas para usar la app de ejemplo, consulta Solución de problemas para Android.