Skema Trait Laporan Status Smart Home

action.devices.traits.StatusReport - Fitur 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 mewakili sensor individu. StatusReport berfungsi sebagai penggabungan untuk melaporkan status kolektif, tetapi tidak menggantikan pengalamatan individual. Setiap perangkat yang dapat diakses oleh Asisten Google harus dilaporkan sebagai perangkat terpisah dalam respons SYNC.

ATTRIBUTES Perangkat

Tidak ada.

NEGARA Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan intent.

Negara bagian Jenis Deskripsi
currentStatusReport Array

Wajib.

Status error atau pengecualian saat ini pada perangkat 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 0. Google melaporkan status error atau pengecualian dari prioritas tertinggi hingga terendah. Bergantung pada platformnya, Google mungkin hanya melaporkan error atau pengecualian prioritas tinggi.

statusCode String

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

Contoh

Apakah sistem keamanan saya baik-baik saja?

{
  "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 COMMANDS

Tidak ada.

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.