Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Skema Atribut StatusReport 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 masing-masing sensor. 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.

STATE 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 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 status error atau 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 tertingginya adalah 0. Google melaporkan status error atau pengecualian dari prioritas tertinggi hingga terendah. Bergantung pada platform, Google hanya dapat melaporkan error atau pengecualian prioritas 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"
    }
  ]
}

PERMINTAAN Perangkat

Tidak ada.

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.