스마트 홈 회전 특성 스키마

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

회전은 퍼센트 또는 도 단위로 지정될 수 있으며 기기가 도 단위로 회전을 지원하는 경우 기본 회전 방향은 시계 방향입니다.

기기 속성

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

속성 유형 설명
supportsDegrees Boolean

필수.

기기에서 도 단위로 회전을 허용하는 경우 true로 설정합니다.
supportsPercent Boolean

필수.

기기에서 회전을 퍼센트로 허용하는 경우 true로 설정합니다.
rotationDegreesRange 객체

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

필수.

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

필수.

도 단위의 최대 회전입니다.
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
}

기기 상태: STATES

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

상태 유형 설명
rotationDegrees Number

rotationDegreesRange 내 현재 수준은 기기가 회전하는 각도를 나타냅니다. 이 값은 항상 시계 방향으로 회전해야 합니다.
rotationPercent Number

현재 수준은 기기가 현재 회전하는 비율을 나타냅니다. 0.0은 닫힌 상태이고 100.0은 열린 상태입니다.

예시

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

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

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

{
  "rotationDegrees": 45
}

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

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

기기 COMMANDS

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.RotateAbsolute

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

매개변수

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

절대 회전 각도를 설정합니다.

매개변수 유형 설명
rotationDegrees Number

필수.

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

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

매개변수 유형 설명
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

기기 ERRORS

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