Schema des Smart-Home-Statusberichts
action.devices.traits.StatusReport
: Mit dieser Eigenschaft wird der aktuelle Status eines bestimmten Geräts oder einer verbundenen Gruppe von Geräten gemeldet.
Ein bestimmtes Gerät kann sowohl den aktuellen Status als auch alle damit verbundenen Geräte in einer Gruppe melden. Das Zielgerät kann beispielsweise ein Sicherheitssystem sein, bei dem die zugehörigen Geräte einzelne Sensoren repräsentieren. Der StatusReport dient als Zusammenfassung des Gesamtstatus des Berichts, ersetzt jedoch nicht die 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ätestatus
Entitäten mit diesem Merkmal können im Rahmen des QUERY
-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentStatusReport |
Array |
Erforderlich. Aktueller Fehler- oder Ausnahmestatus des Geräts und zugehörige 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, mit der höchsten Priorität 0. Google meldet den Fehler- oder Ausnahmestatus von der höchsten zur niedrigsten Priorität. Je nach Oberfläche werden von Google möglicherweise nur Fehler oder Ausnahmen mit hoher Priorität gemeldet. |
statusCode |
String |
Der aktuelle Status des Geräts. Hier finden Sie eine 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" } ] }
BEISPIELE für Geräte
Keine.