스마트 홈 FanSpeed 특성 스키마
action.devices.traits.FanSpeed
: 이 특성은 팬 속도 설정을 지원하는 기기에 속합니다.
기기 ATTRIBUTES
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
reversible |
Boolean |
(기본값: true로 설정하면 기기에서 양방향으로 선풍기 바람을 불어넣을 수 있으며, 팬 방향을 반대로 하는 명령을 수락할 수 있습니다. |
commandOnlyFanSpeed |
Boolean |
(기본값: 기기가 단방향 (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 |
필수. (기본값: 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 |
|
currentFanSpeedPercent |
Number |
현재 팬 속도를 백분율로 나타냅니다. |
예시
거실 선풍기 속도는 어떻게 되나요?
{ "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 på medel
기기 오류
오류 및 예외의 전체 목록을 참조하세요.maxSpeedReached
: 기기가 이미 최대 속도로 설정되어 있습니다.minSpeedReached
: 기기가 이미 최저 속도로 설정되어 있습니다.