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.

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.