스마트 홈 OccupancySensing Trait Schema

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

기기 상태

이 트레잇이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

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

예

센서가 사무실에 사람이 있는지 감지하나요?

{
  "occupancy": "OCCUPIED"
}

기기 명령어

없음

기기 오류

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