# 模式控制

这些消息类型用于控制温度控制器模式。

SetModeRequest
SetModeConfirmation

# SetModeRequest

示例例句: "小微，把{设备名}调到{模式名}模式"
目的: 请求把指定设备调整到指定模式。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	SetModeRequest
namespace	SmartHome.Control

Payload

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

SetModeRequest示例：

  {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": " SetModeRequest",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "accessToken": "[OAuth token here]",
            "appliance": {
                "additionalApplianceDetails": {},
                "applianceId": "[Device ID]"
            },
            "modeId": {
                value: "模式id"
            }
        }
    }

# SetModeConfirmation

目的：表示把指定设备调整到指定模式。这是对SetModeRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	SetModeConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了模式后设备的状态。	是
status.mode	当前设备的模式。格式为[{"modeId":"模式id","modeName":"模式名"}]	是

SetModeRequest示例：ß

    {
        "header": {
            "messageId": "4vhb2f28-6cbk-yb9k-6vg0-lj9qs051e8b7",
            "name": "SetModeConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "status": [{"modeId":"模式id","modeName":"模式名"}]
        }
    }