Cómo diseñar una automatización en Android

Antes de comenzar a usar la API de Automation, debes diseñar tus automatizaciones.

Determina los siguientes parámetros para cada automatización:

• Las circunstancias en las que se debe sugerir la automatización al usuario. Por ejemplo, si el usuario acaba de agregar tres luces nuevas a su casa, es posible que le interese una automatización en particular diseñada para controlar las luces.
• Qué tipos de dispositivos se requieren para la automatización. Por ejemplo, si el usuario acaba de agregar tres luces nuevas a su casa, es posible que le interese una automatización en particular diseñada para controlar las luces. Entre los tipos de dispositivos de luz de ejemplo, se incluyen OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice o ExtendedColorLightDevice.
• Qué atributos y comandos de trait se requieren para la automatización, y si la API de Automation los admite en Android.
• Los traits que deberían activar la automatización como activadores. Los activadores se analizan en Componentes de automatización en Android.
• Condiciones adicionales que determinan si la automatización debe ejecutarse y qué acciones se deben realizar.
• El flujo de ejecución de la automatización. ¿Debe ejecutarse de forma secuencial o en paralelo? ¿Necesitas varias rutas lógicas?

Durante el diseño, puede ser útil diagramar el flujo de la automatización, nodo por nodo, con la lógica requerida en cada paso.

Una vez que hayas diseñado una automatización, usa la DSL de Automation para compilarla. La automatización que compilas es básicamente una "plantilla". Todas las estructuras y los dispositivos que contiene son marcadores de posición y se completan con la estructura y los dispositivos específicos de cada usuario cuando "adoptan" la automatización para su propio uso.

A continuación, se muestran diferentes tipos de automatizaciones que una app podría crear con las APIs de Home. Consulta la página Compila una automatización para ver fragmentos de código relacionados con estos ejemplos.

Automatización simple

Supongamos que necesitas escribir una app que cree una automatización que suba las persianas a las 8:00 a.m. Para lograrlo, la app necesita una lista de las persianas (dispositivos con el tipo de dispositivo WindowCoveringDevice) presentes en la estructura que admiten automatizaciones, que puede proporcionar la API de Discovery.

Para las automatizaciones que deben ejecutarse a una hora determinada, también debes asegurarte de que el usuario haya asignado una dirección para la estructura elegida en la Google Home app (GHA). De lo contrario, la automatización no sabrá la zona horaria en la que se ejecutará. La API de Discovery puede ayudarte a determinar si se asignó una dirección a la estructura.

Por lo tanto, el flujo de ejecución se vería de la siguiente manera:

1. Con la API de Discovery, recopila la lista de dispositivos WindowCoveringDevice.
2. Si la dirección no está completada, notifica al usuario que debe proporcionar una dirección y detén la ejecución.
3. De lo contrario, define la automatización:
   1. Inicia la automatización a las 8:00 a.m.
   2. Para cada una de las persianas, llama al comando upOrOpen del trait WindowCovering.

Automatización compleja

Imagina una app que compila una automatización que activa luces parpadeantes cuando se detecta movimiento.

Una de las primeras tareas para implementar esta app es averiguar qué luces están disponibles en la casa del usuario con la API de Discovery. Con esta información, tu app ahora puede mostrar las luces disponibles y, quizás, permitir que el usuario seleccione qué luces desea que parpadeen.

El flujo de ejecución es el siguiente:

1. Con la API de Discovery, recopila la lista de dispositivos de luz presentes en la estructura, que serían todos los dispositivos con un tipo de dispositivo OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice o ExtendedColorLightDevice.
2. Proporciona una forma de seleccionar las luces que parpadean, quizás a través de un panel de configuración personalizado.
3. Define la automatización:
   1. Inicia la automatización cada vez que alguien salga o llegue a las instalaciones, supervisando AreaPresenceState.
   2. Si presenceState indica que la estructura está ocupada, haz parpadear las luces elegidas.

Automatización genérica

Para ver un ejemplo de una automatización más sofisticada, considera una que guíe al usuario para crear una automatización abierta, basada en cualquiera o todos los dispositivos que tenga en su casa.

Primero, la automatización podría solicitar al usuario que seleccione una estructura.

Luego, la automatización podría mostrar todas las habitaciones de la estructura en una vista de esquema expandible, en la que la expansión de una habitación muestra los dispositivos que contiene. Si expandes aún más un dispositivo, se muestran los activadores y los comandos que admite ese dispositivo.

El usuario puede elegir los dispositivos, los activadores y los comandos que desea usar, y la automatización lo guiará para ensamblar una automatización.

Cuando todas las opciones y decisiones del usuario sean definitivas, la automatización generará la automatización y la guardará en la estructura elegida.

En un nivel superior, esa automatización debería recopilar varios conjuntos de datos sobre la casa del usuario con la API de Structure para Android, la API de Device para Android, y la API de Discovery.

Tabla 1: APIs de Home y la información que pueden proporcionar

API	Información
API de Structure	Qué estructuras están disponibles Qué habitaciones hay en la estructura
API de Device	Qué dispositivos hay en la estructura elegida Dónde se encuentran esos dispositivos (en qué habitación)
API de Discovery	Qué traits admiten los dispositivos Qué activadores y comandos están disponibles en esos traits Qué restricciones existen en los parámetros de estos comandos