스마트 홈 인원 감지 센서 특성 스키마

action.devices.traits.OccupancySensing: 이 특성은 PIR, 초음파 또는 신체 접촉 감지를 통해 사람이 있는지 감지할 수 있는 기기에 속합니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성	유형	설명
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 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태	유형	설명
occupancy	String	필수. 기기가 사람 감지 여부를 감지하는지 나타냅니다. 지원되는 값: OCCUPIED 기기에서 사람이 있는지 감지합니다. UNOCCUPIED 기기에서 사람이 감지되지 않습니다. UNKNOWN_OCCUPANCY_STATE 기기에서 감지된 현재 점유율 상태를 알 수 없습니다.

예시

센서가 사무실에서 사람을 감지하나요?

{
  "occupancy": "OCCUPIED"
}

기기 COMMANDS

없음

기기 ERRORS

오류 및 예외의 전체 목록을 참조하세요.