Skema Sifat Penginderaan Kehadiran Rumah Pintar

action.devices.traits.OccupancySensing - Sifat ini milik perangkat yang dapat mendeteksi kehadiran, baik melalui PIR, ultrasonik, atau deteksi 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 Jenis Deskripsi
occupancySensorConfiguration Array

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

Jenis sensor dan penundaan serta ambang batas peristiwa 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 deteksi ultrasonik.
PHYSICAL_CONTACT
Perangkat mendukung kehadiran melalui deteksi kontak fisik.
occupiedToUnoccupiedDelaySec Bilangan Bulat

Menyatakan penundaan waktu, dalam detik, sebelum jumlah tamu yang dilaporkan berubah menjadi tidak ada orang setelah peristiwa terakhir yang terdeteksi.
unoccupiedToOccupiedDelaySec Bilangan Bulat

Menyatakan penundaan waktu, dalam detik, sebelum jumlah tamu yang dilaporkan berubah ke status terisi 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 ke 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
    }
  ]
}

Perangkat STATES

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

Status 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 terdeteksi oleh perangkat tidak diketahui.

Contoh

Apakah sensor mendeteksi kehadiran di kantor?

{
  "occupancy": "OCCUPIED"
}

PERINTAH Perangkat

Tidak ada.

KESALAHAN Perangkat

Lihat daftar lengkap error dan pengecualian.