스마트 홈 순환 특성 스키마

action.devices.traits.Rotation - 이 트레잇은 회전을 지원하는 기기에 속합니다.

회전은 백분율 또는 각도로 지정할 수 있으며 기기가 회전을 지원하는 경우 도 단위로, 기본 회전 방향은 시계 방향입니다.

기기 속성

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

속성 유형 설명
supportsDegrees Boolean

필수사항.

기기가 각도별 회전을 허용하는 경우 true로 설정합니다.
supportsPercent Boolean

필수사항.

기기에서 비율로 회전하도록 허용하는 경우 true로 설정합니다.
rotationDegreesRange 객체

기기가 회전할 수 있는 도 단위로 범위를 나타냅니다.
rotationDegreesMin 숫자

필수사항.

도 단위의 최소 회전입니다.
rotationDegreesMax 숫자

필수사항.

도 단위의 최대 회전입니다.
supportsContinuousRotation Boolean

(기본값: false)

기기에서 연속 회전을 허용하는 경우 true로 설정합니다. 상대 쿼리가 지정되면 RotateAbsolute 명령어는 지원되는 회전 범위를 래핑합니다.
commandOnlyRotation Boolean

(기본값: false)

기기가 단방향 (true) 통신 사용을 지원하는지 또는 양방향 (false) 통신 사용을 지원하는지 여부를 나타냅니다. 기기가 이 트레잇에 관한 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다.

예

백분율 및 각도로 회전을 모두 지원하는 기기입니다.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

회전 각도만 지원하는 기기

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

연속 회전 명령어만 지원하는 기기

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

기기 상태

이 특성을 가진 항목은 다음을 보고할 수 있습니다. QUERY 작업의 일부로 제공됩니다. 배우기 위해 QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

주 유형 설명
rotationDegrees 숫자

기기가 회전한 각도를 나타내는 rotationDegreesRange 내의 현재 수준입니다. 이 값은 항상 시계 방향 회전을 기준으로 합니다.
rotationPercent 숫자

기기가 현재 회전된 비율을 나타내는 현재 수준입니다. 0.0은 닫힘에 해당하고 100.0은 열림에 해당합니다.
targetRotationPercent 숫자

지속적인 회전 변경의 결과로 기기가 이동하게 되거나 이동할 회전 비율을 나타내는 레벨입니다.

예

기기가 얼마나 회전되나요? (백분율 및 도).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

기기가 얼마나 회전되나요? (도만)

{
  "rotationDegrees": 45
}

기기가 얼마나 회전되나요? (계속)

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

현재 새 위치로 회전 중인 기기의 비율(%)

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

기기 명령어

이 특성을 가진 기기는 다음에 응답할 수 있습니다. EXECUTE 작업의 일부로 사용할 수 있습니다. 배우기 위해 EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

action.devices.commands.RotateAbsolute

기기의 절대 회전을 설정합니다.

매개변수

페이로드에는 다음 중 하나가 포함됩니다.

절대 회전을 도 단위로 설정합니다.

매개변수 유형 설명
rotationDegrees 숫자

필수사항.

기기의 최종 시계 방향 회전을 지정하는 절댓값(도)입니다. 값은 rotationDegreesRange 속성 내에 속해야 합니다.

절대 회전을 백분율로 설정합니다.

매개변수 유형 설명
rotationPercent 숫자

필수사항.

기기의 최종 회전을 지정하는 절댓값(백분율)입니다.

예

기기를 50%까지 기울입니다.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

기기를 시계 반대 방향으로 15도 회전 (rotationDegrees: 45)합니다.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

기기를 시계 방향으로 100도 회전합니다 (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

기기 회전을 설정하는 중에 오류가 발생했습니다.

지원되는 값:

deviceJammingDetected

기기 ERRORS

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