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:

• Cualquier atributo y tipo que quieras usar en tu app con la API de Automation debe registrarse en la inicialización. Consulta Crea una instancia de Home.
• Se puede usar cualquier atributo en los activadores o las condiciones.
• Los dispositivos de 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 atributos 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% se bloquean para que no se usen como activadores.
  • Los dispositivos con una tasa de éxito de ejecución de comandos inferior al 95% se bloquean para que no se usen 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 atributos, 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 OkGoogle 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 establecerse en el Google Home app (GHA). En Cambia la dirección de casa de Google, se explica cómo un usuario puede ingresar o actualizar la dirección de la estructura en el GHA. Si no se configura la dirección, createAutomation() guarda y devuelve un Automation en el que isValid == false, con un problema de validación de UnsupportedEntityEvent que contiene MissingStructureAddressSetup.
  • Para que los miembros de la familia reciban notificaciones de Notification.sendNotifications, deben tener instalada la GHA con las notificaciones habilitadas. Las notificaciones se entregan a los miembros a través de la GHA y no se pueden enviar directamente a apps de terceros.
  • Para usar los atributos AreaPresenceState o AreaAttendanceState, el usuario debe configurar la detección de presencia en GHA.
  • Para usar el atributo ObjectDetection, el usuario debe tener una suscripción activa a Google Home Premium.

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