스마트 홈 OccupancySensing Trait 스키마

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

기기 명령어

없음

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.