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 nell'Google Home app (GHA) e tramite il automation script editor su Google Home for web.
Ora le automazioni nell'ecosistema Google Home sono disponibili tramite le API Home. Utilizzano gli stessi concetti di base delle routine GHA e del script editor, ma con funzionalità e capacità avanzate possibili solo tramite le API Home, tra cui:
- Accesso a tutti gli attributi Matter standard e smart home per un dispositivo, come descritto nelle API Home.
- Supporto per flussi di esecuzione sequenziali, paralleli e selezionati.
Le automazioni vengono scritte utilizzando Automation DSL, un linguaggio specifico per il 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. Vedi Inizializzare la casa.
Percorso dello sviluppatore
L'API Automation è una parte di un percorso di sviluppo più ampio. Viene fornito dopo l'integrazione delle API Structure e Device per garantire che un utente possa utilizzare un'automazione.
- Lo sviluppatore pianifica l'automazione e la definisce utilizzando il 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, inclusi tratti, attributi, comandi ed eventi, raccolti 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 di dispositivi e alle caratteristiche presenti nella struttura dell'utente, con o senza il suo intervento.
- L'API Device può fornire la maggior parte delle informazioni dell'API Discovery, ma non è ottimizzata per i casi d'uso di automazione. Per ulteriori dettagli, consulta Confrontare l'API Device e l'API Discovery.
- L'app crea l'automazione effettiva associata 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, forse 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 di base. In alternativa, puoi presentare lo scheletro di un'automazione che l'utente personalizza in base alle sue esigenze. In alternativa, puoi scrivere un editor di automazione aperto che consenta all'utente di creare automazioni complesse utilizzando tutti i componenti 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 |