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 nas APIs do Home. Eles usam os mesmos conceitos básicos usados nas Rotinas GHA e no script editor, mas com recursos e capacidades aprimorados que só são possíveis com as APIs Home, incluindo:
- Acesso a todos os padrões Matter e traços smart home de um dispositivo, conforme apresentado nas APIs Home.
- Suporte a fluxos de execução sequenciais, paralelos e selecionados.
As automações são gravadas usando a DSL de automação, uma linguagem específica de 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.
Jornada do desenvolvedor
A API Automation é uma parte de uma jornada de desenvolvimento maior. Ele é executado após a integração das APIs Structure e Device para garantir que, quando um usuário quiser usar uma automação, ele possa fazer isso.
- 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, incluindo características, atributos, comandos e eventos, coletados usando
a API Discovery ou a API Device.
- Com a API Discovery, o app pode gerar uma automação de rascunho personalizada para os tipos e os atributos de dispositivo 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 que a 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. A cada vez que isso acontece, o app gera uma nova instância da automatização.
No cenário mais básico, você pode sugerir aos usuários uma automação predefinida que realize uma tarefa relativamente básica. Como alternativa, você pode apresentar um esqueleto de uma automação que o usuário personaliza para atender às necessidades dele. Ou você pode criar 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 limites a seguir 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 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 |