智能家居 FanSpeed 特征架构
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,系统会按照 speeds 数组的顺序(升序)应用增减逻辑的其他语法。 |
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 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
:设备已设置为最低速度。