Compatibilidad con atributos de la API de Automation en Android

La API de Automation para Android admite la mayoría de los atributos, pero la compatibilidad con algunos atributos, eventos y comandos de un atributo puede ser limitada.

En general, debes hacer lo siguiente:

• Todos los rasgos y tipos que pretendas usar en tu app con la API de Automation deben registrarse durante la inicialización. Consulta Cómo crear una instancia de Home.
• Se puede usar cualquier atributo en los iniciadores o las condiciones.
• Los dispositivos Cloud-to-cloud que no informan su estado no se pueden usar como activadores en automatizaciones, ya sea que se creen de forma manual o a través del descubrimiento.

• Incluso si un dispositivo admite los rasgos que se indican aquí, es posible que se bloquee su uso como activador o acción en la API de Automation debido a los umbrales de calidad de Report State:

  • Los dispositivos con una tasa de éxito de Report State inferior al 90% no se pueden usar como dispositivos de inicio.
  • Los dispositivos con una tasa de éxito de ejecución de comandos inferior al 95% no se pueden usar como acciones.

  Consulta esta lista de modelos de dispositivos y los activadores y las acciones específicos que admiten para la API de Automations.

• Los comandos solo se pueden usar como acciones.

• Algunos rasgos, como AssistantBroadcast y Notification, solo están disponibles para su uso en la API de Automation.

• El comando okGoogle es un comando a nivel de la estructura y se puede usar para automatizar cualquier dispositivo de la estructura. Sin embargo, es posible que una app de las APIs de Home no tenga acceso a todos los dispositivos. Consulta Permisos de Ok Google para ver cómo se aplican los permisos en varios casos.

• Algunos rasgos tienen requisitos previos:

  • Para usar activadores basados en el tiempo, como Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent o Time.RecurringSolarTimeScheduledEvent, la estructura en la que se ejecuta la automatización debe tener una dirección para determinar la zona horaria local y los cálculos solares. La dirección se puede proporcionar durante la creación de la estructura o establecer en Google Home app (GHA). Cómo cambiar la dirección de Google Home explica cómo un usuario puede ingresar o actualizar la dirección de la estructura en GHA. Si la dirección no está configurada, createAutomation() guarda y devuelve un Automation donde isValid == false, con un problema de validación UnsupportedEntityEvent que contiene MissingStructureAddressSetup.
  • Para que los miembros de la familia reciban notificaciones de Notification.sendNotifications, deben tener GHA instalado con las notificaciones habilitadas. Las notificaciones se entregan a los miembros a través de GHA y no se pueden enviar directamente a apps de terceros.
  • Para usar los rasgos AreaPresenceState o AreaAttendanceState, el usuario debe configurar la detección de presencia en GHA.
  • Para usar el rasgo ObjectDetection, el usuario debe tener una suscripción activa a Google Home Premium.

También hay versiones simplificadas de algunos atributos disponibles para usarse en automatizaciones. Para obtener más información, consulta Rasgos simplificados en Android.