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:

• Son 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 específica 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 específica para controlar las luces. Entre los ejemplos de tipos de dispositivos de iluminación, se incluyen OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice o ExtendedColorLightDevice.
• Qué atributos y comandos de rasgos se requieren para la automatización y si la API de Automation en Android los admite.
• Los rasgos que deberían activar la automatización como activadores. Los activadores se analizan en Componentes de automatización en Android.
• Son condiciones adicionales que determinan si la automatización debe ejecutarse y qué acciones se deben realizar.
• Es el flujo de ejecución de la automatización. ¿Debería ejecutarse de forma secuencial o en paralelo? ¿Necesitas varias rutas lógicas?

Cuando diseñes, 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 el DSL de automatización para compilarla. La automatización que creas es, en esencia, una "plantilla": 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 indican los diferentes tipos de automatizaciones que una app podría crear con las APIs de Home. Consulta la página Cómo compilar una automatización para ver extractos 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.

En el caso de las automatizaciones que deben ejecutarse en un momento determinado, también debes asegurarte de que el usuario haya asignado una dirección para la estructura elegida (ya sea durante la creación de la estructura o en la Google Home app (GHA)). De lo contrario, la automatización no conocerá la zona horaria en la que se ejecutará. La API de Discovery puede ayudarte a determinar si se asignó o no una dirección a la estructura.

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

1. Usa la API de Discovery para recopilar la lista de dispositivos WindowCoveringDevice.
2. Si no se completa la dirección, notifica al usuario que debe proporcionar una dirección (por ejemplo, en GHA) 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 atributo WindowCovering.

Automatización compleja

Imagina una app que crea 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, tal vez, permitir que el usuario seleccione cuáles quiere que parpadeen.

El flujo de ejecución:

1. Con la API de Discovery, recopila la lista de dispositivos de iluminación 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, tal vez 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 de la propiedad o llegue a ella, supervisando AreaPresenceState.
   2. Si el 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 de los dispositivos que tenga en su casa o en todos ellos.

Es posible que la automatización primero le solicite 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, al expandir una habitación, se muestran los dispositivos que contiene. Si expandes aún más un dispositivo, se mostrarán los activadores y los comandos que admite.

El usuario podría elegir los dispositivos, los activadores y los comandos que quiere usar, y la automatización lo guiaría para crear una automatización.

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

En un nivel alto, una automatización de este tipo necesitarí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 se encuentran en la estructura elegida Dónde se encuentran esos dispositivos (en qué habitación)
API de Discovery	Qué rasgos admiten los dispositivos Qué activadores y comandos están disponibles en esos rasgos Qué restricciones existen en los parámetros de estos comandos