Smart Home StatusReport Trait Schema

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. Alle Geräte, auf die Google Assistant zugreifen kann, müssen in der SYNC-Antwort als separates Gerät gemeldet werden.

Geräteattribute

Keine.

GERÄTESTATUS

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 in absteigender 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. Eine vollständige Liste der Fehler und Ausnahmen finden Sie hier.

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

Gerätebefehle

Keine.

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen