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.

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.

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.
REQUÊTE
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.

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..

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.

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.