สคีมาลักษณะของ Smart Home OccupancySensing Trait

action.devices.traits.OccupancySensing - ลักษณะนี้เป็นของอุปกรณ์ที่สามารถตรวจจับการมีคนอยู่ได้ ไม่ว่าจะผ่าน PIR, การตรวจจับด้วยอัลตราโซนิก หรือการตรวจจับการสัมผัสทางร่างกาย

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

Attributes ประเภท คำอธิบาย
occupancySensorConfiguration อาร์เรย์

รายการวัตถุ โดยแต่ละประเภทจะมีประเภทเซ็นเซอร์ รวมถึงความล่าช้าและเกณฑ์เหตุการณ์ที่เกี่ยวข้อง

[item, ...] ออบเจ็กต์

ประเภทเซ็นเซอร์และความล่าช้าและเกณฑ์เหตุการณ์ที่เกี่ยวข้อง (หากมี)

occupancySensorType String

ต้องระบุ

ค่าที่รองรับ

PIR
อุปกรณ์รองรับการตรวจจับการมีคนอยู่ผ่านการตรวจจับพาสซีฟอินฟราเรด (PIR)
ULTRASONIC
อุปกรณ์รองรับการตรวจจับการมีคนอยู่ผ่านการตรวจจับด้วยอัลตราโซนิก
PHYSICAL_CONTACT
อุปกรณ์รองรับการมีคนอยู่ผ่านการตรวจหาบุคคลในบ้าน
occupiedToUnoccupiedDelaySec จำนวนเต็ม

แสดงการหน่วงเวลาในหน่วยวินาทีก่อนที่อัตราการเข้าพักที่รายงานจะเปลี่ยนเป็นสถานะไม่มีคนอยู่หลังจากเหตุการณ์ที่ตรวจพบล่าสุด

unoccupiedToOccupiedDelaySec จำนวนเต็ม

แสดงการหน่วงเวลาในหน่วยวินาทีก่อนที่อัตราการเข้าพักที่รายงานจะเปลี่ยนเป็นสถานะการมีคนอยู่หลังจากเหตุการณ์ที่ตรวจพบล่าสุด ต้องระบุหากตั้งค่า occupiedToUnoccupiedDelaySec ไว้

unoccupiedToOccupiedEventThreshold จำนวนเต็ม

ระบุจำนวนเหตุการณ์การตรวจจับที่ต้องเกิดขึ้นในช่วง unoccupiedToOccupiedDelaySec ก่อนที่อัตราการเข้าพักที่รายงานจะเปลี่ยนเป็นสถานะมีคนอยู่ ต้องระบุหากตั้งค่า unoccupiedToOccupiedDelaySec ไว้

ตัวอย่าง

เซ็นเซอร์ตรวจจับการมีคนอยู่ซึ่งรองรับ PIR และการตรวจจับด้วยอัลตราโซนิก

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

สถานะอุปกรณ์

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่การดำเนินการตาม Intent

รัฐ ประเภท คำอธิบาย
occupancy String

ต้องระบุ

ระบุว่าอุปกรณ์ตรวจจับการเข้าใช้หรือไม่

ค่าที่รองรับ

OCCUPIED
อุปกรณ์ตรวจพบการมีคนอยู่
UNOCCUPIED
อุปกรณ์ไม่พบการมีคนอยู่
UNKNOWN_OCCUPANCY_STATE
ไม่ทราบสถานะการมีคนอยู่ปัจจุบันที่อุปกรณ์ตรวจพบ

ตัวอย่าง

เซ็นเซอร์ตรวจพบการมีคนอยู่ในสำนักงานไหม

{
  "occupancy": "OCCUPIED"
}

COMMANDS ของอุปกรณ์

ไม่มี

ข้อผิดพลาดเกี่ยวกับอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด