Le automazioni sono un modo per automatizzare le attività e le impostazioni dei dispositivi in una casa. Le automazioni sono disponibili nell'ecosistema Google Home come routine in Google Home app (GHA) e tramite automation script editor su Google Home for web.
Ora, le automazioni nell'ecosistema Google Home sono disponibili tramite le API Home per Android. Utilizzano gli stessi concetti di base delle routine GHA e dell'script editor, ma con funzionalità e capacità avanzate possibili solo tramite le API Home, tra cui:
- Accesso a tutti i tratti standard Matter e smart home per un dispositivo, come presentati nelle API Home.
- Supporto dei flussi di esecuzione sequenziali, paralleli e di selezione.
Le automazioni vengono scritte utilizzando Automation DSL, un linguaggio specifico del dominio progettato per creare automazioni in Kotlin.
Tutti i tratti e i tipi che intendi utilizzare nella tua app con le API Device & Structure o Automation devono essere registrati all'inizializzazione. Consulta la pagina Inizializzare la casa su Android.
Percorso dello sviluppatore
L'API Automation è una parte di un percorso di sviluppo più ampio. Viene eseguita dopo l'integrazione delle API Structure e Device per garantire che quando un utente vuole utilizzare un'automazione, possa farlo.
- Lo sviluppatore pianifica l'automazione e la definisce utilizzando il linguaggio specifico del dominio (DSL) di automazione.
- Lo sviluppatore incorpora la definizione di automazione in un'app Android Kotlin.
- L'app presenta le automazioni a un utente in base alle informazioni sui suoi
dispositivi, tra cui caratteristiche, attributi, comandi ed eventi, raccolte utilizzando
l'API Discovery o l'API Device.
- Con l'API Discovery, l'app può generare una bozza di automazione personalizzata in base ai tipi e alle caratteristiche dei dispositivi presenti nella struttura dell'utente, con o senza l'input dell'utente.
- L'API Device può fornire la maggior parte delle stesse informazioni dell'API Discovery, ma non è ottimizzata per i casi d'uso dell'automazione. Per maggiori dettagli, consulta Confrontare l'API Device e l'API Discovery.
- L'app crea l'automazione effettiva in base alla struttura selezionata.
- L'automazione è ora disponibile nella struttura dell'utente e può essere eseguita o eliminata utilizzando i metodi dell'API Structure.
L'utente può creare nuove istanze dell'automazione in qualsiasi momento, selezionando una struttura diversa o, a seconda della logica dell'app, magari un insieme diverso di dispositivi. Ogni volta che lo fa, l'app genera una nuova istanza dell'automazione.
Nello scenario più semplice, potresti suggerire ai tuoi utenti un'automazione predefinita che esegue un'attività relativamente semplice. In alternativa, puoi presentare una struttura di un'automazione che l'utente personalizza in base alle proprie esigenze. In alternativa, puoi scrivere un editor di automazione open-ended che consenta all'utente di creare automazioni complesse utilizzando tutti i blocchi predefiniti disponibili nell'API Automation.
Limiti di risorse
I seguenti limiti si applicano alle automazioni nelle API Home:
| Metrica | Limite |
|---|---|
| Numero massimo di automazioni per struttura | 64 |
| Numero massimo di nodi per automazione | 128 |
| Numero massimo di nodi di espressione per automazione | 64 |
| Numero massimo di istanze di automazione per struttura | 1024 |
| Numero massimo di istanze di automazione per sviluppatore per struttura | 64 |
| Numero massimo di esecuzioni per struttura al giorno | 1024 |
| Numero massimo di esecuzioni per sviluppatore per struttura al giorno | 128 |