智能家居 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, ...] 对象

与给定语言中的速度设置的含义相同。
speed_synonym 数组

必填。

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

同义词。
lang String

必填。

语言代码 (ISO 639-1)。查看支持的语言。
ordered 布尔值

必填。

如果设为 true，系统会按照 speeds 数组的顺序（递增）应用用于增加或减少逻辑的其他语法。
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，则必须提供此值

示例

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

{
  "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": {}
}

示例话语

<ph type="x-smartling-placeholder">

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