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

스마트 홈 FanSpeed 속성 스키마

action.devices.traits.FanSpeed - 이 특성은 팬 속도를 설정할 수 있는 기기에 속합니다.

팬 속도 (에어컨 또는 난방 장치의 일부 또는 자동차에 있을 수 있는 다양한 수준의 송풍기)로는 낮음, 보통, 높음 또는 백분율 등의 설정이 포함될 수 있습니다.

기기 속성

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

속성 유형 설명
reversible Boolean

(기본값: false)

true로 설정하면 기기에서 양 방향의 송풍을 지원합니다. 팬이 방향을 향하는 명령을 사용할 수 있습니다.

commandOnlyFanSpeed Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요.

다음 항목 포함:
0 객체

속도 설정을 지원합니다.

availableFanSpeeds 객체

필수.

기기에서 지원하는 속도 설정

speeds 배열

필수.

속도 설정 목록입니다.

[item, ...] 객체

속도 설정

speed_name String

필수.

속도 설정의 내부 이름입니다. 이 버전은 사용자 친화적이지 않을 수 있으며 모든 언어로 공유됩니다.

speed_values 배열

필수.

지원되는 각 언어별 속도 설정의 동의어입니다.

[item, ...] 객체

특정 언어 속도 설정의 동의어입니다.

speed_synonym 배열

필수.

속도 설정의 동의어에는 해당하는 경우 단수형과 복수형이 모두 포함되어야 합니다. 목록의 첫 번째 동의어는 속도 설정의 표준 이름으로 간주됩니다.

[item, ...] String

동의어.

lang String

필수.

언어 코드 (ISO 639-1). 지원되는 언어를 참고하세요.

ordered Boolean

필수.

true로 설정하면 속도 배열의 증가 또는 감소 로직에 대한 추가 문법이 순서대로 증가합니다.

1 객체

속도 비율을 지원합니다.

supportsFanSpeedPercent Boolean

필수.

(기본값: false)

true로 설정하면 0.0~100.0의 백분율을 사용하여 속도를 조정하는 명령을 기기에서 허용합니다.

역방향 설정 및 비율 조정을 지원하는 두 가지 속도 설정 기기

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

기기 상태

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

상태 유형 설명
currentFanSpeedSetting String

availableFanSpeeds 속성에 있는 현재 속도 설정의 내부 이름을 나타냅니다.

currentFanSpeedPercent Number

현재 팬 속도를 백분율로 나타냅니다. supportsFanSpeedPercent 속성이 true로 설정된 경우 필수사항

거실에 팬이 얼마나 빠르나요?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

기기 명령어

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

action.devices.commands.SetFanSpeed

속도를 설정합니다.

매개변수

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

설정으로 속도를 설정합니다.

매개변수 유형 설명
fanSpeed String

필수.

팬이 요청한 속도 설정입니다.

속도를 백분율로 설정합니다.

매개변수 유형 설명
fanSpeedPercent Number

필수.

요청된 속도 설정 비율입니다.

냉각팬을 높게 설정합니다.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

냉각팬을 50%로 설정합니다.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

상대 속도를 설정하세요.

이 명령어에는
{
  "commandOnlyFanSpeed": true
}
속성이 필요합니다.

매개변수

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

가중치별로 상대 속도를 설정하세요.

매개변수 유형 설명
fanSpeedRelativeWeight 정수

필수.

이 값은 속도 변경의 상대적인 양을 나타냅니다. 절댓값은 조정된 값을 나타내고 숫자 기호는 변경 방향을 나타냅니다.

상대적인 속도를 비율로 설정합니다.

매개변수 유형 설명
fanSpeedRelativePercent Number

필수.

이 값은 변경 속도의 비율을 나타냅니다.

팬 속도를 약간 낮춥니다.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

팬 속도를 10% 높입니다.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

팬 방향을 반대로 합니다.

이 명령어에는
{
  "reversible": true
}
속성이 필요합니다.

매개변수

매개변수 유형 설명

속성이 없습니다.

팬의 방향을 반대로 바꿉니다.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

샘플 발화

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten medel

기기 오류

오류 및 예외의 전체 목록을 참조하세요.
  • maxSpeedReached: 기기가 이미 최대 속도로 설정되어 있습니다.
  • minSpeedReached: 기기가 이미 최저 속도로 설정되어 있습니다.