Schemat funkcji raportu o stanie inteligentnego domu
action.devices.traits.StatusReport – ta cecha zgłasza bieżący stan określonego urządzenia lub połączonej grupy urządzeń.
Określone urządzenie może przekazywać informacje o swoim bieżącym stanie oraz o stanie dowolnych powiązanych urządzeń w grupie. Urządzeniem docelowym może być na przykład system alarmowy, w którym powiązane urządzenia reprezentują poszczególne czujniki. Raport StatusReport służy do agregacji danych o zbiorczym raportowaniu informacji o stanie, ale nie zastępuje poszczególnych adresacji.
Każde urządzenie, do którego ma dostęp Asystent Google, należy zgłosić jako oddzielne urządzenie w odpowiedzi SYNC.
Urządzenie ATTRIBUTES
Brak.
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule o realizacji intencji.
| Stany | Typ | Opis |
|---|---|---|
currentStatusReport |
Tablica |
Wymagane. Aktualne błędy lub wyjątki dotyczące urządzenia i wszelkie powiązane identyfikatory urządzeń. |
[item, ...] |
Obiekt |
Obecny stan. |
blocking |
Wartość logiczna |
Prawda, jeśli błąd lub bieżący stan blokuje dalsze wykonywanie poleceń. |
deviceTarget |
String |
Identyfikator urządzenia docelowego. |
priority |
Liczba całkowita |
Określa priorytet tego stanu. Im niższa wartość, tym wyższy priorytet, a najwyższy priorytet równy 0. Google zgłasza stan błędu lub wyjątku od najwyższego do najniższego. W zależności od rodzaju interfejsu Google może zgłaszać tylko błędy lub wyjątki o wysokim priorytecie. |
statusCode |
String |
Bieżący stan urządzenia. Zobacz pełną listę błędów i wyjątków. |
Przykłady
Czy mój 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"
}
]
}
CommandS na urządzeniu
Brak.