Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.

Intents

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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.

Diese Abbildung zeigt die Interaktion zwischen der Google-Infrastruktur und der Partnerinfrastruktur. In der Google-Infrastruktur finden Sie eine Liste von Partnern, die für die Assistant-Client-App zur Verfügung stehen und dann zur Partnerinfrastruktur fließen, um die OAuth-Authentifizierung abzuschließen. Die OAuth-Authentifizierung auf Partnerseite ist die WebView für die Partnereinrichtung, die OAuth-Webansicht, die optionalen Einstellungen und Nutzungsbedingungen sowie die Clouddienste von Partnern. Die Partnerinfrastruktur gibt dann die OAuth-Anmeldedaten an die Assistant-Clientanwendung zurück. Die Clouddienste des Partners senden die verfügbaren Geräte und Funktionen an die Assistant-Dienste, die dann die Informationen in Home Graph speichern.
Abbildung 1: Interaktion zwischen der Google- und der Partnerinfrastruktur

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.

Flussdiagramm eines SYNC-Intents
Abbildung 2: SYNC-Intent

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.

Flussdiagramm eines QUERY-Intents
Abbildung 3: QUERY-Intent

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.

Gerätestatus mithilfe des Berichtsstatus melden
Abbildung 4: Gerätestatus melden

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.

Flussdiagramm eines EXECUTE-Intents
Abbildung 5: EXECUTE-Intent

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.