스마트 홈 OccupancySensing Trait 스키마

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

기기 ATTRIBUTES

이 특성이 있는 기기는 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"
}

기기 명령어

없음.

기기 오류

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