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.

Intents

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

Tous les intents smart home sont contenus dans le action.devices, et vous devez leur fournir un fulfillment. À tout moment Google Assistant envoie un intent au traitement, l'objet le jeton d'accès OAuth 2 tiers est transmis dans l'en-tête Authorization.

Voici les intents smart home compatibles:

SYNC
QUERY
EXÉCUTER
DÉCONNECTER

SYNCHRONISER

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

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

Cette figure illustre l'interaction entre l'infrastructure Google
et l'infrastructure du partenaire. À partir de l'infrastructure Google,
de partenaires disponibles pour l'application cliente de l'Assistant,
vers l'infrastructure du partenaire
pour effectuer l'authentification OAuth. Le protocole OAuth
l'authentification côté partenaire est la WebView
de configuration du partenaire, OAuth,
des paramètres et conditions facultatifs, ainsi que des services cloud partenaires. L'infrastructure du partenaire,
puis renvoie les identifiants OAuth à l'application cliente de l'Assistant. Le partenaire
les services cloud envoient les appareils et les fonctionnalités disponibles aux services de l'Assistant,
qui stocke ensuite les informations
dans le Home Graph. — Figure 1: Interaction entre Google et le partenaire de l'infrastructure

Pour éviter de dissocier et d'associer de nouveau le compte d'un utilisateur, vous pouvez envoyer une demande de synchronisation à Assistant. L'intent action.devices.SYNC est alors envoyé à votre traitement pour synchroniser la liste des appareils et des fonctionnalités. Voir Implémentez Request Sync pour en savoir plus. des informations.

Schéma du flux d'un intent SYNC — Figure 2: Intent SYNC

Lors de la configuration du traitement en local, le La plate-forme Local Home vérifie la réponse SYNC de votre Traitement cloud de l'action smart home. Pour savoir comment pour modifier votre réponse SYNC afin de permettre le traitement en local, consultez Mettre à jour la réponse SYNC dans Cloud fulfillment

QUERY

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

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

Schéma du flux d'un intent QUERY — Figure 3: Intent QUERY

Pour une expérience utilisateur optimale, vous devez implémenter Report State (État du rapport) pour générer des rapports proactifs l'état actuel des appareils d'un utilisateur directement Google Home Graph Par exemple, cela permet Assistant savoir si l'utilisateur a allumé une ampoule connectée avec une un interrupteur physique.

Signaler l'état de l'appareil via "Signaler l'état" — Figure 4: Signaler l'état des appareils

EXECUTE

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

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

Schéma du flux d'un intent EXECUTE — Figure 5: Intent EXECUTE

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 pour les appareils de cet utilisateur.

Types et caractéristiques d'appareils

Fulfillment