Schema des Smart-Home-Statusberichtsmerkmals
action.devices.traits.StatusReport
: Diese Trait gibt den aktuellen Status eines bestimmten Geräts oder einer verbundenen Gruppe von Geräten an.
Ein bestimmtes Gerät kann seinen aktuellen Status sowie den Status aller zugehörigen Geräte in einer Gruppe melden. Das Zielgerät könnte beispielsweise ein Sicherheitssystem sein, bei dem die zugehörigen Geräte einzelne Sensoren darstellen. StatusReport dient als Aggregation für die Berichterstellung zum gemeinsamen Status, ersetzt jedoch keine individuelle Adressierung.
Jedes Gerät, auf das Google Assistant zugreifen kann, sollte in der SYNC
-Antwort als separates Gerät gemeldet werden.
Geräte-ATTRIBUTE
Keine.
Gerät STATES
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentStatusReport |
Array |
Erforderlich. Aktueller Fehler- oder Ausnahmestatus des Geräts und alle zugehörigen Geräte-IDs. |
[item, ...] |
Objekt |
Aktueller Status. |
blocking |
Boolesch |
„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. Die höchste Priorität ist 0. 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. Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an. |
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" } ] }
BEFEHLUNGEN auf dem Gerät
Keine.