# 风速

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

  • 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
            }
        }
    }

#