Suporte a traços da API Automation no Android

A API Automation para Android oferece suporte à maioria das características, mas o suporte a alguns atributos, eventos e comandos em uma característica pode ser limitado.

Em geral:

• Todas as características 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 ativadores ou condições.
• Os dispositivos Cloud-to-cloud que não informam o estado não podem ser usados como acionadores em automações criadas manualmente ou por descoberta.

• Mesmo que um dispositivo seja compatível com os recursos listados aqui, ele poderá ser bloqueado para uso como uma ativação ou ação na API Automation devido a limiares de qualidade do Report State:

  • Dispositivos com uma taxa de sucesso de Report State inferior a 90% são bloqueados para uso como iniciadores.
  • 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 os acionadores e ações específicos compatíveis com a API Automations.

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

• Algumas características, como AssistantBroadcast e Notification, estão disponíveis apenas para uso na API Automation.

• O comando okGoogle é usado no nível da 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 Ok Google para saber como elas são aplicadas em vários casos.

• Algumas características têm pré-requisitos:

  • Para usar acionadores baseados em tempo, 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 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() vai salvar e retornar um Automation em que isValid == false, com um problema de validação UnsupportedEntityEvent que contém MissingStructureAddressSetup.
  • Para que os membros da casa 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 os traços 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 algumas características também estão disponíveis para uso em automações. Para mais informações, consulte Traços simplificados no Android.