Intents

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.

<ph type="x-smartling-placeholder">
</ph> Diese Abbildung zeigt die Interaktion zwischen der Google-Infrastruktur
    und die Infrastruktur des Partners. Von der Google-Infrastruktur aus gibt es
    Liste von Partnern, die für die Assistant-Client-App verfügbar sind,
    zur Partnerinfrastruktur, um die OAuth-Authentifizierung abzuschließen. Das OAuth
    die Authentifizierung auf Partnerseite ist die
WebView für die Partnereinrichtung, OAuth WebView,
    optionale Einstellungen und Nutzungsbedingungen sowie Cloud-Dienste von Partnern. Die Infrastruktur des Partners,
    und gibt die OAuth-Anmeldedaten an die Assistant-Client-App zurück. Der Partner
    Cloud-Dienste verfügbare Geräte und Funktionen an Assistant-Dienste,
    das die Informationen im Home Graph speichert.
Abbildung 1: Interaktion zwischen Google und dem Partner 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.

<ph type="x-smartling-placeholder">
</ph> Flussdiagramm eines SYNC-Intents
Abbildung 2: SYNC-Intent

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.

<ph type="x-smartling-placeholder">
</ph> Flussdiagramm eines QUERY-Intents
Abbildung 3: QUERY-Intent

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">
</ph> Gerätestatus mithilfe von „Berichtsstatus“ melden
Abbildung 4: Gerätestatus melden

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.

<ph type="x-smartling-placeholder">
</ph> Flussdiagramm eines EXECUTE-Intents
Abbildung 5: Intent AUSFÜHREN

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.