Skema Fitur StatusLaporan Smart Home

action.devices.traits.StatusReport - Sifat ini melaporkan status perangkat tertentu atau grup perangkat yang terhubung saat ini.

Perangkat tertentu dapat melaporkan statusnya saat ini serta status perangkat terkait dalam grup. Misalnya, perangkat target dapat berupa sistem keamanan dengan perangkat terkait yang merepresentasikan sensor individual. StatusReport berfungsi sebagai agregasi untuk melaporkan status kolektif, tetapi tidak menggantikan pemberian alamat individual. Setiap perangkat yang dapat diakses oleh Asisten Google harus dilaporkan sebagai perangkat terpisah dalam respons SYNC.

ATRIBUT 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.

Negara bagian	Jenis	Deskripsi
currentStatusReport	Array	Wajib. Status error atau pengecualian perangkat saat ini dan ID perangkat terkait apa pun.
[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	Integer	Menentukan prioritas status ini. Semakin rendah nilainya, semakin tinggi prioritasnya, dengan prioritas tertinggi menjadi 0. Google melaporkan error atau status pengecualian dari prioritas tertinggi hingga terendah. Bergantung pada platform, 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 cukup 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"
    }
  ]
}

COMMAND Perangkat

Tidak ada.

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.