智能家居 FanSpeed 特征架构

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

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

设备属性

具有此特征的设备可能会报告以下 属性作为 SYNC 操作的一部分。如需详细了解如何处理 SYNC intent，请参阅 intent 执行。

属性 类型 说明
reversible 布尔值

（默认值：false）

如果设置为 true，则此设备支持双向吹风，并且可以接受反向吹风的命令。
commandOnlyFanSpeed 布尔值

（默认值：false）

指示设备是否支持使用单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设置为 true。
包含以下任一项：
0 对象

支持速度设置。
availableFanSpeeds 对象

必填。

设备支持的速度设置。
speeds 数组

必填。

速度设置列表。
[item, ...] 对象

速度设置。
speed_name String

必填。

速度设置的内部名称。此名称可能不便于用户理解，并且将在所有语言中共享。
speed_values 数组

必填。

每种受支持语言中速度设置的同义词。
[item, ...] 对象

给定语言中速度设置的同义词。为了提供语言回退，至少需要一个 lang 值为 en 的项。
speed_synonym 数组

必填。

速度设置的同义词，应包括单数和复数形式（如果适用）。列表中的第一个同义词将被视为速度设置的规范名称。
[item, ...] String

同义词。为了提供语言回退，至少需要一个 lang 值为 en 的项。
lang String

必填。

语言代码 (ISO 639-1)。请参阅受支持的语言。
ordered 布尔值

必填。

如果设置为 true，则会应用有关增加或减少逻辑的其他语法，顺序为速度数组的顺序（递增）。
1 对象

支持速度百分比。
supportsFanSpeedPercent 布尔值

必填。

（默认值：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，则为必填项

值必须介于 0 和 100 之间。

示例

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

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

设备命令

具有此特征的设备可能会响应以下 命令作为 EXECUTE 操作的一部分。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行。

action.devices.commands.SetFanSpeed

设置速度。

参数

有效负载包含以下其中一项：

按设置设置速度。

参数 类型 说明
fanSpeed String

必填。

风扇的请求速度设置。

按百分比设置速度。

参数 类型 说明
fanSpeedPercent 编号

必填。

请求的速度设置百分比。

值必须介于 0 和 100 之间。

示例

将风扇设置为高档。

{
  "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 整数

必填。

此值表示速度变化的相对量。绝对值表示缩放量，而数值符号表示变化的方向。

值必须介于 -5 和 5 之间。

按百分比设置相对速度。

参数 类型 说明
fanSpeedRelativePercent 编号

必填。

此值表示要更改的速度的百分比。

值必须介于 -100 和 100 之间。

示例

将风扇速度调低一点。

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