此页面由 Cloud Translation API 翻译。

智能家居 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，则会按照速度数组的顺序（增加）应用额外的增减逻辑语法。
`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
}

注意：如果设备还通过 StartStop 特征报告 isRunning 状态，Google 会使用此状态来确定设备在响应 FanSpeed 查询时是否未运行。

设备命令

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

`action.devices.commands.SetFanSpeed`

设置速度。

参数

载荷包含下列各项之一：

根据设置设定速度。

参数类型说明

参数	类型	说明
`fanSpeed`	String	必填。风扇的请求速度设置。

fanSpeed

String

必填。

风扇的请求速度设置。

按百分比设置速度。

参数类型说明

参数	类型	说明
`fanSpeedPercent`	编号	必填。所请求的速度设置百分比。

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`	整数	必填。此值表示速度变化的相对幅度。绝对值表示按比例调整的金额，而数字符号表示变化方向。

fanSpeedRelativeWeight

整数

必填。

此值表示速度变化的相对幅度。绝对值表示按比例调整的金额，而数字符号表示变化方向。

按百分比设置相对速度。

参数类型说明

参数	类型	说明
`fanSpeedRelativePercent`	编号	必填。此值代表要更改的速度的百分比。

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