Skema Karakteristik Sensor Penghuni Smart Home

action.devices.traits.OccupancySensing - Sifat ini milik perangkat yang dapat mendeteksi kehadiran, baik melalui PIR, ultrasonik, atau deteksi kontak fisik.

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut Jenis Deskripsi
occupancySensorConfiguration Array

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

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

Wajib.

Nilai yang didukung:

PIR
Perangkat mendukung deteksi kehadiran melalui sensor inframerah pasif (PIR).
ULTRASONIC
Perangkat mendukung deteksi kehadiran melalui sensor 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

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

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

Contoh

Sensor kehadiran yang mendukung sensor PIR dan ultrasonik.

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

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

Perangkat COMMANDS

Tidak ada.

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.