Smart Home StatusReport-Trait-Schema

action.devices.traits.StatusReport: Mit diesem Attribut wird der aktuelle Status eines bestimmten Geräts oder einer Gruppe verbundener Geräte gemeldet.

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, wobei die zugehörigen Geräte einzelne Sensoren darstellen. StatusReport dient als Aggregation für die Meldung des kollektiven Status, ersetzt aber 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äteattribute

Keine.

Gerätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

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	„True“, wenn der Fehler oder der aktuelle Status die Ausführung weiterer Befehle verhindert.
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. Mindestwert: 0.
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.

GERÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen