智能家居 FanSpeed 特征架构

action.devices.traits.FanSpeed - 此特征属于支持设置风扇速度的设备。

风扇转速（即不同级别的设备吹风，这可能是空调或供暖装置的一部分，也可能是汽车内）的风速可能包括低、中、高或百分比等设置。

设备属性

具有此特征的设备可能会在 SYNC 操作过程中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
reversible	Boolean	（默认值：false） 如果此政策设为 true，此设备支持双向吹风，并且能接受反转风扇方向的命令。
commandOnlyFanSpeed	Boolean	（默认值：false） 指明设备是否支持使用单向 (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	必填。 （默认值：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 intent，请参阅 intent 执行方式。

州	类型	说明
currentFanSpeedSetting	String	这表示 availableFanSpeeds 属性中当前速度设置的内部名称。
currentFanSpeedPercent	编号	以百分比表示当前风扇速度。如果 supportsFanSpeedPercent 属性设置为 true，则必须提供此值

示例

客厅中的风扇速度是多少？

{
  "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：设备已设置为最低速度。