# 风速

以下这些消息类型，以增加或减少的形式设置风扇转速。

- SetFanSpeedRequest
- SetFanSpeedConfirmation
- IncrementFanSpeedRequest
- IncrementFanSpeedConfirmation
- DecrementFanSpeedRequest
- DecrementFanSpeedConfirmation



## SetFanSpeedRequest

**示例语句**：   
“小微，设置{设备名}风速调到5”
“小微，设置{设备名}风速调到最高”   
**目的**：请求以指定的值（最小值-最大值）调整指定设备的风速。 从Smart Home Skill API发送到技能适配器。

**Header**

| 属性      | 值                 |
| --------- | ------------------ |
| name      | SetFanSpeedRequest |
| namespace | SmartHome.Control  |

**Payload**

| 属性                                 | 描述                                                         | 是否必需             |
| ------------------------------------ | ------------------------------------------------------------ | -------------------- |
| accessToken                          | 与客户的设备云账户相关的访问令牌。                           | 是                   |
| appliance object                     | 执行操作的设备。                                             | 是                   |
| appliance.applianceID                | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外，标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是                   |
| appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且，Smart Home Skill API即不理解也不使用这些数据。 | 是，但列表可以为空。 |
| fanSpeed                             | 风扇转速，范围如下（来源于发现设备时）（dev_att_wind_speed_min,dev_att_wind_speed_max）。 | 否                   |

- SetFanSpeedRequest*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "SetFanSpeedRequest",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "accessToken": "[OAuth token here]",
            "appliance": {
                "additionalApplianceDetails": {},
                "applianceId": "[Device ID]"
            },
            "fanSpeed": {
                "value": 5
            }
        }
    }
```



## SetFanSpeedConfirmation

***小微响应示例*：“好的”   
**目的**：表示设备已成功调整了风扇的风速。 这是对* SetFanSpeedRequest*的预期响应，并从技能适配器发送到Smart Home Skill API。

**Header**

| 属性      | 值                      |
| --------- | ----------------------- |
| name      | SetFanSpeedConfirmation |
| namespace | SmartHome.Control       |

**Payload**

| 属性                 | 描述                           | 是否必需 |
| -------------------- | ------------------------------ | -------- |
| status 对象          | 调整了指定的风速后设备的状态。 | 是       |
| status.fanSpeedValue | 当前设备的风速。               | 是       |

*SetFanSpeedConfirmation*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "SetFanSpeedConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "status": {
                "fanSpeedValue": 5，
                   "minFanSpeedValue": 5，
                "maxFanSpeedValue": 5
            }
        }
    }
```



## IncrementFanSpeedRequest

**示例语句**：   
“小微，{设备名}增加风速” 
“小微，{设备名}风速增加{FanSpeed}档”     
**目的**：增加风扇的转速。 从Smart Home Skill API发送到技能适配器。

**Header**

| 属性      | 值                       |
| --------- | ------------------------ |
| name      | IncrementFanSpeedRequest |
| namespace | SmartHome.Control        |

**Payload**

| 属性                                 | 描述                                                         | 是否必需             |
| ------------------------------------ | ------------------------------------------------------------ | -------------------- |
| accessToken                          | 与客户的设备云账户相关的访问令牌。                           | 是                   |
| appliance object                     | 执行操作的设备。                                             | 是                   |
| appliance.applianceID                | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外，标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是                   |
| appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且，Smart Home Skill API即不理解也不使用这些数据。 | 是，但列表可以为空。 |
| fanSpeed                             | 增加的档位数。                                               | 否                   |

*IncrementFanSpeedRequest*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "IncrementFanSpeedRequest",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "accessToken": "[OAuth token here]",
            "appliance": {
                "additionalApplianceDetails": {},
                "applianceId": "[Device ID]"
            },
            "fanSpeed": {
                "value": 1
            }
        }
    }
```



## IncrementFanSpeedConfirmation

***小微响应示例*：“好的”   
**目的**：表示成功增加了风扇的转速。 这是对*IncrementFanSpeedRequest*的预期响应，并从技能适配器发送到Smart Home Skill API。

**Header**

| 属性      | 值                            |
| --------- | ----------------------------- |
| name      | IncrementFanSpeedConfirmation |
| namespace | SmartHome.Control             |

**Payload**

| 属性                 | 描述                           | 是否必需 |
| -------------------- | ------------------------------ | -------- |
| status 对象          | 调整了指定的风速后设备的状态。 | 是       |
| status.fanSpeedValue | 当前设备的风速。               | 是       |

*IncrementFanSpeedConfirmation*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "IncrementFanSpeedConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "status": {
                "fanSpeedValue": 5
            }
        }
    }
```



## DecrementFanSpeedRequest

**示例语句**：   
“小微，{设备名}降低风速” 
“小微，{设备名}风速降低{FanSpeed}档”   
**目的**：降低风扇的转速。 从Smart Home Skill API发送到技能适配器。

**Header**

| 属性      | 值                       |
| --------- | ------------------------ |
| name      | DecrementFanSpeedRequest |
| namespace | SmartHome.Control        |

**Payload**

| 属性                                 | 描述                                                         | 是否必需             |
| ------------------------------------ | ------------------------------------------------------------ | -------------------- |
| accessToken                          | 与客户的设备云账户相关的访问令牌。                           | 是                   |
| appliance object                     | 执行操作的设备。                                             | 是                   |
| appliance.applianceID                | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外，标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是                   |
| appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且，Smart Home Skill API即不理解也不使用这些数据。 | 是，但列表可以为空。 |
| fanSpeed                             | 降低的档位数。                                               | 否                   |

*DecrementFanSpeedRequest*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "DecrementFanSpeedRequest",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "accessToken": "[OAuth token here]",
            "appliance": {
                "additionalApplianceDetails": {},
                "applianceId": "[Device ID]"
            },
            "fanSpeed": {
                "value": 1
            }
        }
    }
```



## DecrementFanSpeedConfirmation

***小微响应示例*：“好的”   
**目的**：表示设备成功降低了风扇转速。 这是对*DecrementFanSpeedRequest*的预期响应，并从技能适配器发送到Smart Home Skill API。

**Header**

| 属性      | 值                            |
| --------- | ----------------------------- |
| name      | DecrementFanSpeedConfirmation |
| namespace | SmartHome.Control             |

**Payload**

| 属性                 | 描述                           | 是否必需 |
| -------------------- | ------------------------------ | -------- |
| status 对象          | 调整了指定的风速后设备的状态。 | 是       |
| status.fanSpeedValue | 当前设备的风速。               | 是       |

*DecrementFanSpeedConfirmation*示例：

```
    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "DecrementFanSpeedConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "status": {
                "fanSpeedValue": 5
            }
        }
    }
```

###