스마트 홈 FanSpeed 특성 스키마

action.devices.traits.FanSpeed: 이 특성은 팬 속도 설정을 지원하는 기기에 속합니다.

팬 속도 (에어컨, 난방 장치의 일부 또는 자동차 내부일 수 있는 다양한 수준의 기기에서 바람을 불어넣는 속도)에는 낮음, 중간, 높음 또는 백분율과 같은 설정이 포함될 수 있습니다.

기기 ATTRIBUTES

이 특성이 있는 기기는 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: 기기가 이미 최저 속도로 설정되어 있습니다.