Skema Smart Home OccupancySensing Trait

action.devices.traits.OccupancySensing - Sifat ini dimiliki oleh perangkat yang dapat mendeteksi kehadiran, baik melalui PIR, ultrasonik, maupun sensor kontak fisik.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
occupancySensorConfiguration Array

Daftar objek, yang masing-masing berisi jenis sensor serta ambang peristiwa dan penundaan terkait.
[item, ...] Objek

Jenis sensor serta ambang peristiwa dan penundaan terkait, jika ada.
occupancySensorType String

Wajib.

Nilai yang didukung:

PIR
Perangkat mendukung deteksi tingkat keterisian melalui deteksi inframerah pasif (PIR).
ULTRASONIC
Perangkat mendukung deteksi tingkat keterisian melalui deteksi ultrasonik.
PHYSICAL_CONTACT
Perangkat mendukung tingkat keterisian melalui deteksi kontak fisik.
occupiedToUnoccupiedDelaySec Bilangan Bulat

Merepresentasikan penundaan waktu, dalam detik, sebelum jumlah tamu yang dilaporkan berubah menjadi status kosong setelah peristiwa terakhir terdeteksi.
unoccupiedToOccupiedDelaySec Bilangan Bulat

Merepresentasikan penundaan waktu, dalam detik, sebelum jumlah orang yang dilaporkan berubah menjadi status ada orang setelah peristiwa terakhir yang terdeteksi. Wajib jika occupiedToUnoccupiedDelaySec ditetapkan.
unoccupiedToOccupiedEventThreshold Bilangan Bulat

Menentukan jumlah peristiwa deteksi yang harus terjadi dalam periode unoccupiedToOccupiedDelaySec sebelum jumlah tamu yang dilaporkan berubah menjadi status terisi. Wajib jika unoccupiedToOccupiedDelaySec ditetapkan.

Contoh

Sensor kehadiran yang mendukung deteksi PIR dan ultrasonik.

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

Status PERANGKAT

Entitas dengan karakteristik 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
occupancy String

Wajib.

Menunjukkan apakah perangkat mendeteksi kehadiran.

Nilai yang didukung:

OCCUPIED
Perangkat mendeteksi kehadiran.
UNOCCUPIED
Perangkat tidak mendeteksi kehadiran.
UNKNOWN_OCCUPANCY_STATE
Status kehadiran saat ini yang dideteksi oleh perangkat tidak diketahui.

Contoh

Apakah sensor mendeteksi kehadiran di kantor?

{
  "occupancy": "OCCUPIED"
}

Perintah Perangkat

Tidak ada.

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.