스마트 홈 팬 속도 특성 스키마

action.devices.traits.FanSpeed - 이 트레이트는 팬 속도 설정을 지원하는 기기에 적용됩니다.

팬 속도 (즉, 에어컨 또는 난방 장치의 일부이거나 자동차에 있는 기기에서 다양한 수준으로 공기를 내보내는 것)에는 낮음, 중간, 높음 또는 백분율과 같은 설정이 포함될 수 있습니다.

기기 속성

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

속성 유형 설명
reversible Boolean

(기본값: false)

true로 설정하면 이 기기는 양방향으로 팬을 불어넣는 것을 지원하며 팬 방향을 반대로 하는 명령어를 수락할 수 있습니다.
commandOnlyFanSpeed Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 지원하는지 나타냅니다. 기기가 이 특성에 대한 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다.
다음 항목 중 하나를 포함합니다.
0 객체

속도 설정 지원
availableFanSpeeds 객체

필수사항.

기기에서 지원하는 속도 설정입니다.
speeds 배열

필수사항.

속도 설정 목록입니다.
[item, ...] 객체

속도 설정입니다.
speed_name 문자열

필수사항.

속도 설정의 내부 이름입니다. 사용자 친화적이지 않을 수 있으며 모든 언어에서 공유됩니다.
speed_values 배열

필수사항.

지원되는 각 언어의 속도 설정 동의어입니다.
[item, ...] 객체

특정 언어의 속도 설정 동의어입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
speed_synonym 배열

필수사항.

속도 설정 동의어입니다. 해당하는 경우 단수형과 복수형을 모두 포함해야 합니다. 목록의 첫 번째 동의어가 속도 설정의 표준 이름으로 간주됩니다.
[item, ...] 문자열

동의어입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
lang 문자열

필수사항.

언어 코드 (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 문자열

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

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

값은 0에서 100 사이여야 합니다.

예

거실에 있는 팬의 속도는 얼마인가요?

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

기기 명령어

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

action.devices.commands.SetFanSpeed

속도를 설정합니다.

매개변수

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

설정으로 속도 설정

매개변수 유형 설명
fanSpeed 문자열

필수사항.

요청된 팬 속도 설정입니다.

백분율로 속도 설정

매개변수 유형 설명
fanSpeedPercent 숫자

필수사항.

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

값은 0에서 100 사이여야 합니다.

예

팬을 높음으로 설정해 줘.

{
  "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 정수

필수사항.

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

값은 -5에서 5 사이여야 합니다.

백분율로 상대 속도 설정

매개변수 유형 설명
fanSpeedRelativePercent 숫자

필수사항.

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

값은 -100에서 100 사이여야 합니다.

예

팬 속도를 조금 낮춰 줘.

{
  "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 på medel

기기 오류

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