Smart-Home-Intents sind einfache Nachrichtenobjekte, die welche smart home-Aktion durchgeführt werden soll, z. B. das Licht einschalten Audio auf einen Lautsprecher streamen.
Alle smart home-Intents sind im
action.devices
-Namespace und Sie müssen die Auftragsausführung dafür bereitstellen. Immer
Google Assistant sendet einen Intent zur Auftragsausführung,
Das OAuth 2-Zugriffstoken eines Drittanbieters wird 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, die der Nutzer verbunden hat und die
die Sie verwenden können.
Wenn ein Nutzer seine Geräte mit dem Google Home app (GHA) einrichtet, gilt Folgendes:
bei Ihrer Cloud-Infrastruktur authentifiziert werden. Gehen Sie dann so vor:
Assistant empfängt ein OAuth2-Token. An dieser Stelle
Assistant sendet einen action.devices.SYNC
-Intent an Ihr
Fulfillment, um die anfängliche Liste der Nutzergeräte und -funktionen aus
Ihrer Cloud-Infrastruktur.
Um das Aufheben der Verknüpfung und die Wiederherstellung eines Nutzerkontos zu vermeiden, können Sie eine Synchronisierungsanfrage senden
an Assistant. Dadurch wird der Intent action.devices.SYNC
gesendet
zu deiner Auftragsausführung, um die Liste der Geräte und Funktionen zu synchronisieren. Weitere Informationen finden Sie unter
Anfragesynchronisierung implementieren
Informationen.
Bei der Einrichtung der lokalen Auftragsausführung wird der Parameter
Die Local Home-Plattform prüft die SYNC
-Antwort von deinem
smart home Cloud Fulfillment von Action. Weitere Informationen dazu, wie
Informationen zum Ändern der SYNC
-Antwort für die lokale Auftragsausführung finden Sie unter
Aktualisieren Sie die SYNC-Antwort in der Cloud-Ausführung.
ABFRAGE
Mit dem Intent action.devices.QUERY
wird der aktuelle Status abgefragt
von smart home Geräten.
Wenn Nutzer den Gerätestatus abfragen, um eine Frage wie die folgende zu beantworten:
Hey Google, welche Lampen sind in der Küche an?,
Assistant sendet einen action.devices.QUERY
-Intent an Ihr
Auftragsausführung.
Für eine optimale Nutzererfahrung sollten Sie Status melden, um proaktiv zu melden den aktuellen Status der Geräte eines Nutzers zu sehen, Google Home Graph So können wir zum Beispiel Assistant wissen, ob der Nutzer eine intelligente Lampe mit einem physischen Lichtschalter.
<ph type="x-smartling-placeholder">EXECUTE
Der Intent action.devices.EXECUTE
wird zum Bereitstellen von Befehlen verwendet
zur Ausführung auf smart home-Geräten.
Wenn Nutzer mit Assistant Befehle an Geräte senden, werden Ihre
Der Auftragsausführung wird der Intent action.devices.EXECUTE
für die Auftragsausführung hinzugefügt, der
beschreibt die Aktion und die zu ergreifenden Geräte. Ein Nutzer kann eine Aktion ausführen.
auf einem Gerät mit einem Befehl wie Hey Google, schalte das Licht im Wohnzimmer ein.
VERBINDUNG TRENNEN
Der Intent action.devices.DISCONNECT
wird ausgelöst, um Sie zu informieren
Ein Nutzer hat die Verknüpfung des App-Kontos mit Assistant aufgehoben.
Nachdem Sie den Intent action.devices.DISCONNECT
erhalten haben, sollten Sie keine Berichte mehr erstellen
Status für die Geräte dieses Nutzers.