Suporte a traços da API Automation no Android

A API Automation para Android é compatível com a maioria dos atributos, mas o suporte a alguns atributos, eventos e comandos em um atributo pode ser limitado.

Em geral:

  • Todos os atributos e tipos que você pretende usar no app com a API Automation precisam ser registrados na inicialização. Consulte Criar uma instância do Home.
  • Qualquer atributo pode ser usado em ativações ou condições.
  • Os dispositivos Cloud-to-cloud que não informam o estado não podem ser usados como acionadores em automações, sejam elas criadas manualmente ou por descoberta.
  • Mesmo que um dispositivo seja compatível com os atributos listados aqui, ele pode ser bloqueado para uso como inicializador ou ação na API Automation devido aos limites de qualidade do estado do relatório:

    • Os dispositivos com uma taxa de sucesso do Report State inferior a 90% são bloqueados para uso como ativações.
    • Os dispositivos com uma taxa de sucesso de execução de comandos inferior a 95% são bloqueados para uso como ações.

    Consulte esta lista de modelos de dispositivos e as ativações e ações específicas que eles aceitam para a API Automations.

  • Os comandos só podem ser usados como ações.

  • Alguns atributos, como AssistantBroadcast e Notification, estão disponíveis apenas para uso na API Automation.

  • O comando okGoogle é de nível de estrutura e pode ser usado para automatizar qualquer dispositivo na estrutura. No entanto, um app de APIs Home pode não ter acesso a todos os dispositivos. Consulte Permissões do OkGoogle para ver como as permissões são aplicadas em vários casos.

  • Alguns atributos têm pré-requisitos:

    • Para usar ativações baseadas em horário, como Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent ou Time.RecurringSolarTimeScheduledEvent, a estrutura em que a automação é executada precisa ter um endereço para determinar o fuso horário local e os cálculos solares. O endereço pode ser fornecido durante a criação da estrutura ou definido no Google Home app (GHA). Mudar o endereço de casa do Google explica como um usuário pode inserir ou atualizar o endereço da estrutura no GHA. Se o endereço não estiver configurado, createAutomation() salva e retorna um Automation em que isValid == false, com um problema de validação UnsupportedEntityEvent contendo MissingStructureAddressSetup.
    • Para que os membros da família recebam notificações do Notification.sendNotifications, eles precisam ter o GHA instalado com as notificações ativadas. As notificações são entregues aos membros pelo GHA e não podem ser enviadas diretamente para apps de terceiros.
    • Para usar as características AreaPresenceState ou AreaAttendanceState, o usuário precisa configurar a detecção de presença no GHA.
    • Para usar o atributo ObjectDetection, o usuário precisa ter uma assinatura ativa do Google Home Premium.

Versões simplificadas de alguns atributos também estão disponíveis para uso em automações. Para mais informações, consulte Atributos simplificados no Android.