스마트 홈 FanSpeed 속성 스키마
action.devices.traits.FanSpeed
- 이 특성은 팬 속도를 설정할 수 있는 기기에 속합니다.
기기 속성
이 특성이 있는 기기는 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 aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomáximo
sv-SE
-
Ställ in
fläkten påmedel
기기 오류
오류 및 예외의 전체 목록을 참조하세요.maxSpeedReached
: 기기가 이미 최대 속도로 설정되어 있습니다.minSpeedReached
: 기기가 이미 최저 속도로 설정되어 있습니다.