스마트 홈 OccupancySensing Trait 스키마

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

기기 속성

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

특성	유형	설명
occupancySensorConfiguration	배열	객체 목록으로, 각각 센서 유형과 관련 지연 및 이벤트 기준점을 포함합니다.
[item, ...]	객체	센서 유형 및 관련 지연 및 이벤트 기준점(해당하는 경우)
occupancySensorType	문자열	필수사항. 지원되는 값: 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	문자열	필수사항. 기기에서 사람 감지 여부를 나타냅니다. 지원되는 값: OCCUPIED 기기에서 사람이 감지되었습니다. UNOCCUPIED 기기에서 사람이 감지되지 않습니다. UNKNOWN_OCCUPANCY_STATE 기기에서 감지된 현재 점유율을 알 수 없습니다.

예

센서가 사무실의 인기척을 감지하나요?

{
  "occupancy": "OCCUPIED"
}

기기 명령어

없음

기기 오류

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