Schema des Smart Home-Statusberichts
action.devices.traits.StatusReport
: Hiermit wird der aktuelle Status eines bestimmten Geräts oder einer verbundenen Gruppe von Geräten gemeldet.
Ein bestimmtes Gerät kann sowohl seinen aktuellen Status als auch den Status zugehöriger Geräte in einer Gruppe melden. Das Zielgerät könnte beispielsweise ein Sicherheitssystem sein, wobei die zugehörigen Geräte einzelne Sensoren darstellen. StatusReport dient als Zusammenfassung für den Berichtsstatus insgesamt, ersetzt jedoch nicht einzelne Adressierungen.
Jedes Gerät, auf das Google Assistant zugreifen kann, sollte in der SYNC
-Antwort als separates Gerät gemeldet werden.
Gerät ATTRIBUTE
Keine.
Gerät STATES
Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY
die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentStatusReport |
Array |
Erforderlich. Aktuelle Fehler- oder Ausnahmestatus des Geräts und alle zugehörigen Geräte-IDs. |
[item, ...] |
Objekt |
Aktueller Status. |
blocking |
Boolesch |
Dieser Wert ist „True“, wenn der Fehler oder der aktuelle Status weitere Befehlsausführungen blockiert. |
deviceTarget |
String |
Die ID des Zielgeräts. |
priority |
Ganzzahl |
Gibt die Priorität dieses Status an. Je niedriger der Wert, desto höher die Priorität, wobei die höchste Priorität 0 ist. Google meldet den Fehler- oder Ausnahmestatus von der höchsten zur niedrigsten Priorität. Je nach Oberfläche meldet Google möglicherweise nur Fehler oder Ausnahmen mit hoher Priorität. |
statusCode |
String |
Der aktuelle Status des Geräts. Vollständige Liste der Fehler und Ausnahmen |
Beispiele
Ist mein Sicherheitssystem in Ordnung?
{ "currentStatusReport": [ { "blocking": false, "deviceTarget": "alarm_1", "priority": 0, "statusCode": "lowBattery" }, { "blocking": false, "deviceTarget": "front_window_1", "priority": 1, "statusCode": "deviceOpen" }, { "blocking": false, "deviceTarget": "back_window_2", "priority": 1, "statusCode": "deviceOpen" }, { "blocking": true, "deviceTarget": "alarm_2", "priority": 0, "statusCode": "needsSoftwareUpdate" } ] }
Gerätebefehle
Keine.