Compatibilidad con atributos de la API de Automation en Android

La API de Automation para Android admite la mayoría de las características, pero la compatibilidad con algunos atributos, eventos y comandos de una característica puede ser limitada.

En general, debes hacer lo siguiente:

  • Cualquier característica y tipo que pretendas usar en tu app con la API de Automation debe registrarse durante la inicialización. Consulta Crea una instancia de Home.
  • Cualquier atributo se puede usar en activadores o 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 de la detección.
  • Incluso si un dispositivo admite las características que se enumeran aquí, es posible que no se pueda usar 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 activadores.
    • 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.

  • Algunas características, como AssistantBroadcast y Notification, solo están disponibles para su uso en la API de Automation.

  • El okGoogle comando 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.

  • Algunas características tienen requisitos previos:

    • Para usar Time.ScheduledTimeEvent, la estructura en la que se ejecuta la automatización debe tener una dirección. La dirección se puede proporcionar durante la creación de la estructura o establecerse en la Google Home app (GHA). En Cambia la dirección de Google home se explica cómo un usuario puede ingresar o actualizar la dirección de la estructura en la GHA. Si no se configura la dirección, la automatización no se podrá crear y se mostrará un error con el mensaje "The ScheduledTimeEvent is not supported by the structure."
    • 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 las características AreaPresenceState o AreaAttendanceState, el usuario debe configurar la detección de presencia en el GHA.
    • Para usar la característica ObjectDetection, el usuario debe tener una suscripción activa Google Home Premium.

También hay versiones simplificadas de algunas características disponibles para su uso en automatizaciones. Para obtener más información, consulta Características simplificadas en Android.