Intents

Les intents de maison connectée sont des objets de messagerie simples qui décrivent l'intégration Cloud-to-cloud à effectuer, par exemple allumer une lumière ou caster du contenu audio sur une enceinte.

Tous les intents smart home sont contenus dans l'espace de noms action.devices, et vous devez fournir un fulfillment pour chacun d'eux. Chaque fois que Google Assistant envoie un intent au fulfillment, un jeton d'accès OAuth 2 tiers de l'utilisateur est transmis dans l'en-tête Authorization.

Voici les intents smart home acceptés :

SYNCHRONISER

L'intent action.devices.SYNC permet de demander la liste des appareils smart home que l'utilisateur a connectés et qui sont disponibles.

Lorsqu'un utilisateur configure ses appareils avec le Google Home app (GHA), il est également authentifié auprès de votre infrastructure cloud. Ensuite, Assistant reçoit un jeton OAuth2. À ce stade, Assistant envoie un intent action.devices.SYNC à votre fulfillment pour récupérer la liste initiale des appareils et des fonctionnalités de l'utilisateur à partir de votre infrastructure cloud.

Cette figure montre l'interaction entre l'infrastructure Google et l'infrastructure du partenaire. Depuis l'infrastructure Google, une liste de partenaires est disponible pour l'application cliente Assistant, qui transmet ensuite les informations à l'infrastructure du partenaire pour effectuer l'authentification OAuth. L'authentification OAuth côté partenaire correspond à la WebView de configuration du partenaire, à la WebView OAuth, aux paramètres et conditions facultatifs, et aux services cloud du partenaire. L'infrastructure du partenaire renvoie ensuite les identifiants OAuth à l'application cliente de l'Assistant. Les services cloud du partenaire envoient les appareils et les fonctionnalités disponibles aux services de l'Assistant, qui stockent ensuite les informations dans Home Graph.
Figure 1 : Interaction entre l'infrastructure de Google et celle du partenaire

Pour éviter de dissocier et de réassocier le compte d'un utilisateur, vous pouvez envoyer une demande de synchronisation à Assistant. L'intent action.devices.SYNC est alors envoyé à votre fulfillment pour synchroniser la liste des appareils et des fonctionnalités. Pour en savoir plus, consultez Implémenter la synchronisation des requêtes.

Schéma de flux d'une intention SYNC
Figure 2 : Intention SYNC

Lors de la configuration du traitement en local, la plate-forme Local Home vérifie la réponse SYNC du traitement cloud de votre action smart home. Pour savoir comment modifier votre réponse SYNC afin de prendre en charge le traitement local, consultez Mettre à jour la réponse SYNC dans le traitement cloud.

QUERY

L'intent action.devices.QUERY permet d'interroger l'état actuel des appareils smart home.

Lorsque les utilisateurs demandent l'état d'un appareil, par exemple Hey Google, quelles lumières sont allumées dans la cuisine ?, Assistant envoie un intent action.devices.QUERY à votre fulfillment.

Schéma de flux d'un intent QUERY
Figure 3 : Intention QUERY

Pour une expérience utilisateur optimale, vous devez implémenter Report State afin de signaler de manière proactive l'état actuel des appareils d'un utilisateur directement à Google Home Graph. Par exemple, cela permet à Assistant de savoir si l'utilisateur a allumé une ampoule connectée avec un interrupteur physique.

Signaler l'état de l'appareil à l'aide de Report State
Figure 4 : Signaler l'état de l'appareil

EXECUTE

L'intent action.devices.EXECUTE permet de fournir des commandes à exécuter sur les appareils smart home.

Lorsque les utilisateurs envoient des commandes à des appareils avec Assistant, votre fulfillment reçoit un intent action.devices.EXECUTE qui décrit l'action et les appareils sur lesquels agir. Un utilisateur peut exécuter une action sur un appareil à l'aide d'une commande telle que Hey Google, allume les lumières du salon.

Schéma illustrant le flux d'une intention EXECUTE
Figure 5 : Intention EXECUTE

DÉCONNECTER

L'intent action.devices.DISCONNECT est déclenché pour vous informer qu'un utilisateur a dissocié le compte de l'application de Assistant. Après avoir reçu un intent action.devices.DISCONNECT, vous ne devez pas signaler l'état des appareils de cet utilisateur.

Précédent
Types et caractéristiques d'appareils
Suivant
Fulfillment