Usa la app de ejemplo para Android

La app de ejemplo para Android muestra las capacidades 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 el dispositivo está en una habitación, aparecerá en la lista de esa habitación. La app de ejemplo admite los siguientes tipos de dispositivos:

  • Luz de temperatura de color (encendido y apagado, brillo)
  • Sensor de contacto (estado booleano)
  • Luz regulable (encendido y apagado, brillo)
  • Luz de color extendida (encendida y apagada, brillo)
  • Cambio genérico
  • 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 conexión activada/desactivada (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"

En la pestaña Dispositivos (figura 1), se muestran las habitaciones de la estructura (Patio trasero, Ático, Viaje) y los dispositivos de cada habitación, junto con el estado de cada dispositivo. Para ver o editar los rasgos 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: Vista de la pestaña Dispositivos de la app de ejemplo
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 se admita el botón Ejecutar manualmente para esta automatización.

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

Pestaña Automations 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 New Automation (Figura 5).

Usa los botones +Add Starter y +Add Action (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, verás los botones Actualizar activador y Quitar activador para el activador (y Actualizar acción y Quitar acción para la acción). Esto te permite 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 ejemplo de la app para iniciar una nueva automatización.
Figura 5: Cómo comenzar a crear una nueva automatización
Pantalla de ejemplo de la app para agregar un activador para una automatización.
Figura 6: Cómo agregar un activador a una automatización
Pantalla de ejemplo de la app para agregar una acción a una automatización.
Figura 7: Cómo agregar una acción a una automatización
Pantalla de la app de ejemplo para crear una automatización.
Figura 8: Cómo crear 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.