智能家居风速特征架构
action.devices.traits.FanSpeed
- 此特征属于支持设置风扇转速的设备。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
reversible |
Boolean |
(默认值: 如果设置为 true,则此设备支持向两个方向吹风,并且可接受将风扇反转的命令。 |
commandOnlyFanSpeed |
Boolean |
(默认值: 指明设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
包含以下任意内容: | ||
0
|
对象 |
支持速度设置。 |
availableFanSpeeds |
对象 |
必填。 设备支持的速度设置。 |
speeds |
数组 |
必填。 速度设置列表。 |
[item, ...] |
对象 |
速度设置。 |
speed_name |
String |
必填。 速度设置的内部名称。这种做法可能不太方便用户使用,将在所有语言之间共享。 |
speed_values |
数组 |
必填。 每种受支持语言的速度设置的同义词。 |
[item, ...] |
对象 |
给定语言的速度设置的同义词。 |
speed_synonym |
数组 |
必填。 速度设置的同义词,应包括单复数形式(如果适用)。系统会将列表中的第一个同义词视为速度设置的规范名称。 |
[item, ...] |
String |
同义词。 |
lang |
String |
必填。 语言代码 (ISO 639-1)。请参阅支持的语言。 |
ordered |
Boolean |
必填。 如果设置为 true,则系统会按照 speed 数组的顺序(递增)应用其他增减逻辑语法。 |
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
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
currentFanSpeedSetting |
String |
这表示 |
currentFanSpeedPercent |
编号 |
以百分比表示当前风扇转速。如果 |
示例
客厅的风扇风速是多少?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.SetFanSpeed
设定速度。
参数
载荷包含以下其中一项:
根据设置设定速度。
参数 | 类型 | 说明 |
---|---|---|
fanSpeed |
String |
必填。 风扇的请求速度设置。 |
按百分比设置速度。
参数 | 类型 | 说明 |
---|---|---|
fanSpeedPercent |
编号 |
必填。 请求的速度设置百分比。 |
示例
将风扇设为高音。
{ "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 |
编号 |
必填。 此值表示变化的速度百分比。 |
示例
调低风扇转速,
{ "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
:设备已设为最低速度。