스마트 홈 회전 특성 스키마
action.devices.traits.Rotation
- 이 특성은 회전을 지원하는 기기에 속합니다.
회전은 퍼센트 또는 각도로 지정할 수 있으며 기기가 도 단위로 회전을 지원하는 경우 기본 회전 방향은 시계 방향입니다.
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
supportsDegrees |
Boolean |
필수. 기기에서 도 단위로 회전을 허용하는 경우 true로 설정합니다. |
supportsPercent |
Boolean |
필수. 기기에서 회전을 허용하는 경우 true로 설정 |
rotationDegreesRange |
객체 |
기기가 회전할 수 있는 범위를 도 단위로 나타냅니다. |
rotationDegreesMin |
Number |
필수. 도 단위의 최소 회전입니다. |
rotationDegreesMax |
Number |
필수. 도 단위의 최대 회전입니다. |
supportsContinuousRotation |
Boolean |
(기본값: 기기가 연속 회전을 허용하는 경우 true로 설정합니다. 상대 쿼리가 지정되면 |
commandOnlyRotation |
Boolean |
(기본값: 기기가 단방향 (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 |
Number |
|
rotationPercent |
Number |
기기가 현재 회전된 비율을 나타내는 현재 수준입니다. 0.0은 닫혀 있는 상태이고 100.0은 열려 있는 값입니다. |
예
기기가 얼마나 회전되어 있나요? (도 및 도)
{ "rotationDegrees": 45, "rotationPercent": 25 }
기기가 얼마나 회전되어 있나요? (도전).
{ "rotationDegrees": 45 }
기기가 얼마나 회전되어 있나요? (연속)
{ "rotationDegrees": 270, "rotationPercent": 75 }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.RotateAbsolute
기기의 절대 회전을 설정합니다.
매개변수
페이로드에는 다음 중 하나가 포함됩니다.
절대 회전 각도를 설정합니다.
매개변수 | 유형 | 설명 |
---|---|---|
rotationDegrees |
Number |
필수. 기기의 최종 시계 방향 회전을 지정하는 절댓값입니다(도 단위). 값은 |
절대 회전 비율을 설정합니다.
매개변수 | 유형 | 설명 |
---|---|---|
rotationPercent |
Number |
필수. 기기의 최종 회전을 지정하는 절댓값(백분율)입니다. |
예
기기를 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