智能家居风扇速度 trait 架构

action.devices.traits.FanSpeed - 此 trait 属于支持设置风扇转速的设备。

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

设备属性

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

属性 类型 说明
reversible 布尔值

（默认值：false）

如果设为 true，则此设备支持风扇向两个方向吹风，并且可以接受用于反转风扇方向的命令。
commandOnlyFanSpeed 布尔值

（默认值：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 布尔值

必填。

如果设置为 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
}

设备状态

具有此 trait 的实体可能会在 QUERY 操作期间报告以下状态。如需详细了解如何处理 QUERY intent，请参阅intent 执行方式。

州 类型 说明
currentFanSpeedSetting String

这表示 availableFanSpeeds 属性中当前速度设置的内部名称。
currentFanSpeedPercent 编号

以百分比表示当前风扇速度。如果 supportsFanSpeedPercent 属性设置为 true，则此字段为必填字段

示例

客厅的风扇风速是多少？

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

设备命令

具有此 trait 的设备可能会在 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：设备已设为最低速度。