Skema Karakteristik StatusReport Smart Home

action.devices.traits.StatusReport - Ciri 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 merepresentasikan sensor individual. StatusReport berfungsi sebagai agregasi untuk melaporkan status kolektif, tetapi tidak menggantikan pengalamatan individual. Perangkat apa pun yang dapat diakses oleh Asisten Google harus dilaporkan sebagai perangkat terpisah dalam respons SYNC.

ATRIBUT Perangkat

Tidak ada.

STATUS Perangkat

Entitas dengan sifat ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Negara bagian Jenis Deskripsi
currentStatusReport Array

Wajib.

Status error atau pengecualian saat ini dari perangkat dan ID perangkat terkait.

[item, ...] Objek

Status saat ini.

blocking Boolean

Benar jika error atau status saat ini memblokir eksekusi perintah lebih lanjut.

deviceTarget String

ID perangkat target.

priority Bilangan Bulat

Menentukan prioritas status ini. Makin rendah nilainya, makin tinggi prioritasnya, dengan prioritas tertinggi adalah 0. Google melaporkan status error atau pengecualian dari prioritas tertinggi hingga terendah. Bergantung pada platform, Google mungkin hanya melaporkan error atau pengecualian prioritas tinggi.

Nilai minimum: 0.

statusCode String

Status perangkat saat ini. Lihat daftar lengkap error dan pengecualian.

Contoh

Apakah sistem keamanan saya berfungsi?

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

PERINTAH perangkat

Tidak ada.

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.