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

Activités

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les intents de maison connectée sont des objets de messagerie simples qui décrivent smart home Action to perform such as turn on a light or cast audio to a speaker.

Tous les intents smart home sont contenus dans l'espace de noms action.devices, et vous devez fournir leur fulfillment. Chaque fois Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.

Voici les intents smart home compatibles:

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) , they also get authenticated to your cloud infrastructure. Then, Assistant receives an OAuth2 token. At this point, Assistant sends a action.devices.SYNC intent to your fulfillment to retrieve the initial list of user devices and capabilities from your cloud infrastructure.

Cette figure illustre l'interaction entre l'infrastructure Google et l'infrastructure partenaire. Depuis l'infrastructure Google, une liste de 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 du partenaire, l'affichage Web OAuth, les paramètres et conditions facultatifs de configuration 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 Google et l'infrastructure partenaire

Pour éviter de dissocier et de réassocier le compte d'un utilisateur, vous pouvez envoyer une requête 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 la page Mettre en œuvre la synchronisation des requêtes.

Schéma d'un intent SYNC
Figure 2: Intention de synchronisation

Lors de la configuration du fulfillment local, la plate-forme Local Home vérifie la réponse SYNC à partir du traitement cloud de votre action smart home. Pour savoir comment modifier votre réponse SYNC afin qu'elle accepte le fulfillment local, consultez la section Mettre à jour la réponse SYNC dans le fulfillment cloud.

QUERY

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

Pour répondre à une question telle que Hey Google, quels sont les voyants allumés dans la cuisine ?, Assistant envoie un intent action.devices.QUERY à votre traitement.

Schéma 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 . For example, this lets Assistant know if your user turned on a smart light with a physical light switch..

Signaler l'état de l'appareil à l'aide de l'état du rapport
Figure 4: Rapport sur l'état des appareils

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 traitement reçoit un intent action.devices.EXECUTE correspondant à votre action et décrivant les appareils concernés. Un utilisateur peut exécuter une action sur un appareil avec une commande telle que Hey Google, allume les lumières de mon salon.

Schéma d'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.