Schemat cechy Smart Home StatusReport

action.devices.traits.StatusReport – ten atrybut podaje bieżący stan konkretnego urządzenia lub połączonej grupy urządzeń.

Konkretne urządzenie może zgłaszać swój bieżący stan, a także stan wszystkich powiązanych urządzeń w grupie. Urządzeniem docelowym może być np. system zabezpieczeń, a powiązane urządzenia to poszczególne czujniki. StatusReport służy do agregowania informacji o zbiorczym stanie, ale nie zastępuje indywidualnego adresowania. Każde urządzenie, do którego ma dostęp Asystent Google, powinno być zgłaszane jako osobne urządzenie w odpowiedzi SYNC.

ATRYBUTY urządzenia

Brak.

Stany urządzenia

Podmioty z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany	Typ	Opis
currentStatusReport	Tablica	Wymagane. Aktualne stany błędów lub wyjątków urządzenia i wszystkie powiązane identyfikatory urządzeń.
[item, ...]	Obiekt	Bieżący stan.
blocking	Wartość logiczna	Wartość „true”, jeśli błąd lub bieżący stan blokuje wykonywanie dalszych poleceń.
deviceTarget	String	Identyfikator urządzenia docelowego.
priority	Liczba całkowita	Określa priorytet tego stanu. Im niższa wartość, tym wyższy priorytet. Najwyższy priorytet to 0. Google zgłasza stan błędu lub wyjątku od najwyższego do najniższego priorytetu. W zależności od usługi Google może zgłaszać tylko błędy lub wyjątki o wysokim priorytecie. Wartość minimalna: 0.
statusCode	String	Bieżący stan urządzenia. Zobacz pełną listę błędów i wyjątków.

Przykłady

Czy system alarmowy działa?

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

Polecenia dotyczące urządzenia

Brak.

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.