Intent

Gli intent per la smart home sono semplici oggetti di messaggistica che descrivono quale azione smart home eseguire, ad esempio accendere una luce o trasmettere contenuti audio a uno speaker.

Tutti gli intent smart home sono contenuti nell'elemento action.devices e devi fornire il relativo completamento. Sempre Google Assistant invia un intent al completamento, il token di accesso OAuth 2 di terze parti viene passato nell'intestazione Autorizzazione.

Questi sono gli intent smart home supportati:

SINCRONIZZA

L'intent action.devices.SYNC viene utilizzato per richiedere l'elenco di smart home dispositivi che l'utente ha connesso e che disponibili per l'uso.

Quando un utente configura i propri dispositivi con Google Home app (GHA), anche autenticati nella tua infrastruttura cloud. Poi, Assistant riceve un token OAuth2. A questo punto, Assistant invia un intent action.devices.SYNC al tuo per recuperare l'elenco iniziale dei dispositivi e delle funzionalità degli utenti della tua infrastruttura cloud.

Questa figura mostra l'interazione tra l'infrastruttura di Google e l'infrastruttura partner. Dall'infrastruttura di Google è presente di partner disponibili per l'app client dell'assistente, che poi passa all'infrastruttura partner per completare l'autenticazione OAuth. Il protocollo OAuth l'autenticazione lato partner è la configurazione partner WebView, OAuth WebView, impostazioni e termini facoltativi e servizi cloud dei partner. L'infrastruttura del partner, e restituisce le credenziali OAuth all'app client dell'assistente. Il partner servizi cloud inviano i dispositivi e le funzionalità disponibili ai servizi dell'assistente, che poi memorizzerà le informazioni nell'Home Graph.
Figura 1: interazione tra Google e il partner infrastruttura

Per evitare di scollegare e ricollegare l'account di un utente, puoi inviare una richiesta di sincronizzazione a Assistant. Viene inviato l'intent action.devices.SYNC al tuo fulfillment per sincronizzare l'elenco di dispositivi e funzionalità. Consulta Per ulteriori informazioni, implementa la sincronizzazione delle richieste. informazioni.

Diagramma di flusso di un intent SYNC
Figura 2: intent SYNC

Durante la configurazione del fulfillment locale, La piattaforma Home locale controlla la risposta SYNC del tuo Fulfillment cloud dell'azione smart home. Per saperne di più su come per modificare la tua risposta SYNC per supportare l'evasione degli ordini locale, consulta Aggiorna la risposta SYNC in fulfillment cloud.

QUERY

L'intent action.devices.QUERY viene utilizzato per eseguire query sullo stato attuale di smart home dispositivi.

Quando gli utenti eseguono query sullo stato del dispositivo, per rispondere a domande come Hey Google, quali luci ci sono in cucina?, Assistant invia un intent action.devices.QUERY al tuo fulfillment.

Diagramma di flusso di un intent QUERY
Figura 3: intent di QUERY

Per una migliore esperienza utente, devi implementare Stato dei report per generare report proattivi lo stato attuale dei dispositivi di un utente Google Home Graph. Ad esempio, questo consente Assistant può sapere se l'utente ha acceso una luce smart con una interruttore fisico.

Segnalazione dello stato del dispositivo tramite Stato del report
Figura 4: segnalazione dello stato del dispositivo

ESEGUI

L'intent action.devices.EXECUTE viene utilizzato per fornire comandi per l'esecuzione su smart home dispositivi.

Quando gli utenti inviano comandi ai dispositivi con Assistant, i tuoi L'evasione ordini riceve un intent action.devices.EXECUTE che descrive l'azione e i dispositivi su cui agire. Un utente può eseguire un'azione su un dispositivo con un comando come Hey Google, accendi le luci del salotto.

Diagramma di flusso di un intent EXECUTE
Figura 5: intent di esecuzione

DISCONNETTI

L'intent action.devices.DISCONNECT viene attivato per informarti Quando un utente ha scollegato l'account dell'app da Assistant. Dopo aver ricevuto un intent action.devices.DISCONNECT, non devi segnalare per i dispositivi di questo utente.

Indietro
Tipi di dispositivi e caratteristiche
Avanti
Fulfillment