Smart-Home-Intents sind einfache Messaging-Objekte, die die Aktion von smart home beschreiben, z. B. das Einschalten eines Lichts oder das Streamen von Ton an einen Lautsprecher.
Alle smart home-Intents sind im Namespace action.devices
enthalten und müssen für diese Intents bereitgestellt werden. Wenn Google Assistant einen Intent an die Auftragsausführung sendet, wird das OAuth 2-Zugriffstoken eines Nutzers im Autorisierungsheader übergeben.
Dies sind die unterstützten smart home-Intents:
SYNCHRONISIEREN
Mit dem Intent action.devices.SYNC
wird die Liste der smart home-Geräte angefordert, die der Nutzer verbunden hat und verwendet werden kann.
Wenn ein Nutzer seine Geräte mit Google Home app (GHA) einrichtet, wird er auch bei Ihrer Cloud-Infrastruktur authentifiziert. Dann erhält Assistant ein OAuth2-Token. An dieser Stelle sendet Assistant einen action.devices.SYNC
-Intent an die Auftragsausführung, um die anfängliche Liste der Nutzergeräte und Funktionen aus Ihrer Cloud-Infrastruktur abzurufen.

Sie können eine Anfragesynchronisierung an Assistant senden, um zu vermeiden, dass die Verknüpfung eines Nutzerkontos aufgehoben oder eine erneute Verknüpfung hergestellt wird. Dadurch wird der Intent action.devices.SYNC
an die Auftragsausführung gesendet, um die Liste der Geräte und Funktionen zu synchronisieren. Weitere Informationen finden Sie unter Anfragesynchronisierung implementieren.

Beim Einrichten der lokalen Auftragsausführung prüft die lokale Startseite die Antwort SYNC
der Cloud-Auftragsausführung der Aktion smart home. Weitere Informationen zum Ändern der SYNC
-Antwort zur Unterstützung der lokalen Auftragsausführung finden Sie unter SYNC-Antwort in der Cloud-Auftragsausführung aktualisieren.
QUERY
Der Intent action.devices.QUERY
wird zum Abfragen des aktuellen Status von smart home-Geräten verwendet.
Wenn Nutzer den Gerätestatus abfragen, um eine Frage zu beantworten, z. B. Hey Google, welche Leuchten leuchten in der Küche auf?
Assistant sendet einen action.devices.QUERY
-Intent an Ihre Auftragsausführung.

Für eine optimale Nutzerfreundlichkeit solltest du Berichtsstatus implementieren, damit der aktuelle Status der Geräte eines Nutzers direkt an Google Home Graph gemeldet wird. Dadurch weiß Assistant beispielsweise, ob der Nutzer eine intelligente Lampe mit einem physischen Lichtschalter eingeschaltet hat.

EXECUTE
Der Intent action.devices.EXECUTE
wird verwendet, um Befehle zur Ausführung auf smart home-Geräten bereitzustellen.
Wenn Nutzer Befehle mit Assistant an Geräte senden, erhält die Auftragsausführung den Intent action.devices.EXECUTE
, der die Aktion und die Geräte beschreibt, auf die reagiert werden soll. Ein Nutzer kann eine Aktion auf einem Gerät mit einem Befehl wie Hey Google, schalte das Wohnzimmerlicht aus ausführen.

VERBINDUNG TRENNEN
Der Intent action.devices.DISCONNECT
wird ausgelöst, um Sie zu informieren, wenn ein Nutzer die Verknüpfung des App-Kontos mit Assistant aufgehoben hat.
Nach dem Empfang eines action.devices.DISCONNECT
-Intents sollten Sie den Status für die Geräte dieses Nutzers nicht mehr melden.