스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 회전 특성 스키마

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
}

기기 상태

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

상태 유형 설명
rotationDegrees Number

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

rotationPercent Number

기기가 현재 회전된 비율을 나타내는 현재 수준입니다. 0.0은 닫혀 있는 상태이고 100.0은 열려 있는 값입니다.

기기가 얼마나 회전되어 있나요? (도 및 도)

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

기기가 얼마나 회전되어 있나요? (도전).

{
  "rotationDegrees": 45
}

기기가 얼마나 회전되어 있나요? (연속)

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

기기 명령어

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

기기 오류

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