Skema Trait StatusReport Smart Home
action.devices.traits.StatusReport
- Trait ini melaporkan status saat ini dari perangkat tertentu atau grup perangkat yang terhubung.
Perangkat tertentu dapat melaporkan statusnya saat ini serta status perangkat terkait
dalam grup. Misalnya, perangkat target dapat berupa sistem keamanan dengan perangkat terkait
yang mewakili masing-masing sensor. StatusReport berfungsi sebagai kumpulan untuk
melaporkan status kolektif, tetapi tidak menggantikan pemberian alamat individual.
Perangkat apa pun yang dapat diakses oleh Asisten Google harus dilaporkan sebagai perangkat terpisah
dalam respons SYNC
.
ATTRIBUTE Perangkat
Tidak ada.
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Status | Type | Deskripsi |
---|---|---|
currentStatusReport |
Array |
Wajib. Status error atau pengecualian perangkat saat ini dan ID perangkat terkait. |
[item, ...] |
Objek |
Status saat ini. |
blocking |
Boolean |
True jika error atau status saat ini memblokir eksekusi perintah lebih lanjut. |
deviceTarget |
String |
ID perangkat target. |
priority |
Bilangan Bulat |
Menentukan prioritas status ini. Semakin rendah nilainya, semakin tinggi prioritasnya, dengan prioritas tertinggi adalah 0. Google melaporkan status error atau pengecualian dari prioritas tertinggi hingga terendah. Bergantung pada platformnya, Google hanya dapat melaporkan error atau pengecualian berprioritas tinggi. |
statusCode |
String |
Status perangkat saat ini. Lihat daftar lengkap error dan pengecualian. |
Contoh
Apakah sistem keamanan saya berfungsi dengan baik?
{ "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" } ] }
Perangkat COMMAND
Tidak ada.