As automações são uma forma de automatizar tarefas e configurações de dispositivos em uma casa. As automações estão disponíveis no ecossistema do Google Home como Rotinas no Google Home app (GHA) e pelo automation script editor no Google Home for web.
Agora, as automações no ecossistema do Google Home estão disponíveis pelas APIs Home para Android. Elas usam os mesmos conceitos básicos das Rotinas do GHA e do script editor, mas com recursos e funcionalidades aprimorados que só são possíveis com as APIs Home, incluindo:
- Acesso a todos os padrões Matter e características smart home de um dispositivo, conforme apresentado nas APIs Home.
- Suporte para fluxos de execução sequenciais, paralelos e selecionados.
As automações são escritas usando a DSL de automação, uma linguagem específica do domínio projetada para criar automações em Kotlin.
Todas as características e tipos que você pretende usar no app com as APIs Device & Structure ou Automation precisam ser registrados na inicialização. Consulte Inicializar a casa no Android.
Jornada do desenvolvedor
A API Automation é uma parte de uma jornada de desenvolvimento maior. Ele vem depois da integração das APIs Structure e Device para garantir que um usuário possa usar uma automação quando quiser.
- O desenvolvedor planeja e define a automação usando a DSL de automação.
- O desenvolvedor incorpora a definição de automação em um app Android Kotlin.
- O app apresenta automações a um usuário com base em informações sobre os
dispositivos dele, incluindo características, atributos, comandos e eventos, coletados usando
a API Discovery ou Device.
- Com a API Discovery, o app pode gerar um rascunho de automação personalizado para os tipos e características de dispositivos presentes na estrutura do usuário, com ou sem a entrada do usuário.
- A API Device pode fornecer a maioria das mesmas informações da API Discovery, mas não é otimizada para casos de uso de automação. Consulte Comparar a API Device e a API Discovery para mais detalhes.
- O app cria a automação real, que é vinculada à estrutura selecionada.
- A automação agora está disponível na estrutura do usuário e pode ser executada ou excluída usando métodos da API Structure.
O usuário pode criar novas instâncias da automação a qualquer momento, selecionando uma estrutura diferente ou, dependendo da lógica do app, talvez um conjunto diferente de dispositivos. Cada vez que isso acontece, o app gera uma nova instância da automação.
No cenário mais básico, você pode sugerir aos usuários uma automação predefinida que executa uma tarefa relativamente simples. Outra opção é apresentar um esqueleto de automação que o usuário personaliza para atender às necessidades dele. Ou você pode escrever um editor de automação aberto que permita ao usuário criar automações complexas usando todos os blocos de construção disponíveis na API Automation.
Limites de recursos
Os seguintes limites se aplicam às automações nas APIs Home:
| Métrica | Limite |
|---|---|
| Número máximo de automações por estrutura | 64 |
| Número máximo de nós por automação | 128 |
| Número máximo de nós de expressão por automação | 64 |
| Número máximo de instâncias de automação por estrutura | 1024 |
| Número máximo de instâncias de automação por desenvolvedor e por estrutura | 64 |
| Número máximo de execuções por estrutura por dia | 1024 |
| Número máximo de execuções por desenvolvedor por estrutura por dia | 128 |