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 beschreiben, was smart home Action to perform such as turn on a light or cast audio to a speaker.

Alle smart home-Intents sind im Namespace action.devices enthalten und Sie müssen die Auftragsausführung dafür bereitstellen. Immer Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.

Dies sind die unterstützten smart home-Intents:

SYNCHRONISIEREN

Mit dem Intent action.devices.SYNC wird eine 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) , 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. einrichtet

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

ABFRAGE

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 sollten Sie den Berichtstatus implementieren, um den aktuellen Status der Geräte eines Nutzers direkt an Google Home Graph . For example, this lets Assistant know if your user turned on a smart light with a physical light switch. zu melden.

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

EXECUTE

Der Intent action.devices.EXECUTE wird zur Bereitstellung von Befehlen für smart home-Geräte verwendet.

Wenn Nutzer Befehle an Geräte mit Assistant senden, erhält die Auftragsausführung einen action.devices.EXECUTE-Intent an die Auftragsausführung, der die Aktion und die Geräte beschreibt, auf die sie reagieren sollen. 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.