สคีมา Smart Home OccupancySensing

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

อุปกรณ์ STATES

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

รัฐ	ประเภท	คำอธิบาย
occupancy	String	ต้องระบุ ระบุว่าอุปกรณ์รับรู้การมีคนอยู่หรือไม่ ค่าที่รองรับ OCCUPIED อุปกรณ์ตรวจพบการมีคนอยู่ UNOCCUPIED ไม่พบการตรวจหาบุคคลในบ้าน UNKNOWN_OCCUPANCY_STATE ไม่ทราบสถานะการเข้าใช้ปัจจุบันที่อุปกรณ์ตรวจพบ

ตัวอย่าง

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

{
  "occupancy": "OCCUPIED"
}

อุปกรณ์ COMMANDS

ไม่ต้องแจ้งเตือนเลย

อุปกรณ์ ERRORS

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