Las automatizaciones son una forma de automatizar tareas y la configuración de dispositivos en una casa. Las automatizaciones estuvieron disponibles en el ecosistema de Google Home como rutinas en Google Home app (GHA) y a través de automation script editor en Google Home for web.
Ahora, las automatizaciones en el ecosistema de Google Home están disponibles a través de las APIs de Home. Usan los mismos conceptos básicos que se usan en las rutinas de GHA y script editor, pero con funciones y capacidades mejoradas que solo son posibles a través de las APIs de Home, como las siguientes:
- Acceso a todas las características Matter y smart home estándar de un dispositivo, como se presenta en las APIs de Home
- Compatibilidad con flujos de ejecución secuenciales, paralelos y seleccionados.
Las automatizaciones se escriben con Automation DSL, un lenguaje específico de dominio diseñado para compilar automatizaciones en Kotlin.
Todos los atributos y tipos que quieras usar en tu app con las APIs de Device & Structure o Automation deben registrarse en la inicialización. Consulta Cómo inicializar la página principal.
Recorrido del desarrollador
La API de Automation es una parte de un recorrido de desarrollo más amplio. Se usa después de integrar las APIs de Structure y Device para garantizar que, cuando un usuario desee usar una automatización, pueda hacerlo.
- El desarrollador planifica su automatización y la define con la DSL de Automation.
- El desarrollador incorpora la definición de automatización en una app para Android de Kotlin.
- La app presenta automatizaciones a un usuario en función de la información sobre sus dispositivos, incluidos rasgos, atributos, comandos y eventos, recopilados con la API de Discovery o la API de Device.
- Con la API de Discovery, la app puede generar un borrador de automatización personalizado según los tipos de dispositivos y las características presentes en la estructura del usuario, con o sin su entrada.
- La API de Device puede proporcionar la mayor parte de la misma información que la API de Discovery, pero no está optimizada para casos de uso de automatización. Consulta Comparar la API de Device y la API de Discovery para obtener más información.
- La app crea la automatización real que está vinculada a la estructura seleccionada.
- La automatización ahora está disponible en la estructura del usuario y se puede ejecutar o borrar con los métodos de la API de Structure.
El usuario puede crear instancias nuevas de la automatización en cualquier momento, seleccionando una estructura diferente o, según la lógica de la app, quizás un conjunto diferente de dispositivos. Cada vez que lo hacen, la app genera una instancia nueva de la automatización.
En el caso más básico, puedes sugerirles a los usuarios una automatización predefinida que realice una tarea relativamente básica. Como alternativa, puedes presentar un esqueleto de una automatización que el usuario personalice para satisfacer sus necesidades. También puedes escribir un editor de automatización abierto que le permita al usuario crear automatizaciones complejas con todos los elementos básicos disponibles en la API de Automation.
Límites de recursos
Los siguientes límites se aplican a las automatizaciones en las APIs de Home:
| Métrica | Límite |
|---|---|
| Cantidad máxima de automatizaciones por estructura | 64 |
| Cantidad máxima de nodos por automatización | 128 |
| Cantidad máxima de nodos de expresión por automatización | 64 |
| Cantidad máxima de instancias de automatización por estructura | 1024 |
| Cantidad máxima de instancias de automatización por desarrollador por estructura | 64 |
| Cantidad máxima de ejecuciones por estructura por día | 1024 |
| Cantidad máxima de ejecuciones por desarrollador por estructura por día | 128 |