Skema Sifat Penghuni Fasilitas Smart Home

action.devices.traits.OccupancySensing - Sifat ini termasuk dalam 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 penanganan intent SYNC lebih lanjut, lihat fulfillment intent.

Atribut Type Deskripsi
occupancySensorConfiguration Array

Daftar objek, masing-masing berisi jenis sensor serta penundaan dan nilai minimum peristiwa yang terkait.

[item, ...] Objek

Jenis sensor serta penundaan dan nilai minimum peristiwanya yang terkait, jika berlaku.

occupancySensorType String

Wajib.

Nilai yang didukung:

PIR
Perangkat mendukung deteksi kehadiran melalui deteksi inframerah pasif (PIR).
ULTRASONIC
Perangkat mendukung deteksi kehadiran melalui sensor ultrasonik.
PHYSICAL_CONTACT
Perangkat mendukung kehadiran melalui deteksi kontak fisik.
occupiedToUnoccupiedDelaySec Integer

Menyatakan penundaan waktu, dalam detik, sebelum tingkat keterisian yang dilaporkan berubah menjadi tidak terisi setelah peristiwa terakhir terdeteksi.

unoccupiedToOccupiedDelaySec Integer

Menyatakan penundaan waktu, dalam detik, sebelum tingkat keterisian yang dilaporkan berubah menjadi status terisi setelah peristiwa terakhir terdeteksi. Wajib jika occupiedToUnoccupiedDelaySec ditetapkan.

unoccupiedToOccupiedEventThreshold Integer

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 PIR dan sensor ultrasonik.

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

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

PERMINTAAN Perangkat

Tidak ada.

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.