Bienvenue dans le centre Google Home pour les développeurs, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque:Vous continuerez de créer des actions dans la console Actions.

Cette page a été traduite par l'API Cloud Translation.

Switch to English

Activités

Les intents de la maison connectée sont de simples objets de messagerie qui décrivent l'action smart home à effectuer, par exemple allumer une lumière ou caster un contenu audio sur une enceinte.

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

Voici les intents smart home compatibles:

SYNCHRONISATION
QUERY
EXERCICE
SE DÉCONNECTER

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 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 traitement 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 partenaire. À partir de l'infrastructure Google, une liste des partenaires est disponible pour l'application cliente de l'Assistant, qui est ensuite transmise à l'infrastructure partenaire pour effectuer l'authentification OAuth. L'authentification OAuth côté partenaire est la configuration WebView de partenaire, la WebView OAuth, les paramètres et conditions facultatifs et les services cloud partenaires. L'infrastructure du partenaire renvoie ensuite les identifiants OAuth à l'application cliente de l'Assistant. Les services cloud partenaires envoient les appareils et fonctionnalités disponibles aux services de l'Assistant, qui stockent ensuite les informations dans le Home Graph. — Figure 1: Interaction entre l'infrastructure Google et celle du partenaire

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

Diagramme d'un intent SYNC — Figure 2: intent SYNC

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

REQUÊTE

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

Lorsque les utilisateurs interrogent l'état de l'appareil, pour répondre à une question du type Hey Google, quelles sont les lumières allumées dans la cuisine ?, Assistant envoie un intent action.devices.QUERY à votre traitement.

Diagramme d'un intent QUERY — Figure 3: Intention de QUERY

Pour une expérience utilisateur optimale, vous devez implémenter l'état du rapport 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 d'un appareil avec Report State — Figure 4: Indiquer l'état d'un appareil

EXECUTE

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

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

Organigramme illustrant un intent EXECUTE — Figure 5: EXECUTE intent

DÉCONNECTER

L'intent action.devices.DISCONNECT est déclenché pour vous informer lorsqu'un utilisateur a dissocié le compte d'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.

Types et caractéristiques d'appareils

Traitement