Schema für Smart-Home-Statusberichtsmerkmale

action.devices.traits.StatusReport: Dieser Messwert 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, wobei die zugehörigen Geräte einzelne Sensoren darstellen. StatusReport dient als Aggregation für den Bericht zum Gruppenstatus, 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ät: STATES

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausfü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

„Wahr“, wenn der Fehler oder der aktuelle Status die Ausführung weiterer Befehle 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 hat der Wert 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. Vollständige Liste der Fehler und Ausnahmen

Beispiele

Funktioniert mein Sicherheitssystem?

{
  "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"
    }
  ]
}

BEFEHLE für Geräte

Keine.

GERÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen