# 开关

此消息类型用于打开或关闭目标设备。这些消息通常由几种不同类型的设备使用。

TurnOnRequest
TurnOnConfirmation
TurnOffRequest
TurnOffConfirmation

# TurnOnRequest

示例语句：
“小微，打开空调”
目的：请求打开指定的设备。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	TurnOnRequest
namespace	SmartHome.Control

Payload

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

TurnOnRequest示例：

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

# TurnOnConfirmation

小微响应示例：“好的”
目的：表示设备已成功打开。对于成功的TurnOnRequest，技能适配器对Smart Home Skill API的预期响应。

Header

属性	值
name	TurnOnConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status.dev_att_switch	指进行操作后，设备的开关状态：flase:关闭，true:打开。	是

TurnOnConfirmation示例：

    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "TurnOnConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion": "2"
        },
        "payload": {
            "status":{
                "deviceSwitch": true
             }
        }
    }

# TurnOffRequest

示例语句：
“小微，关闭空调”
目的：请求关闭指定的设备。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	TurnOffRequest
namespace	SmartHome.Control

Payload

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

TurnOffRequest示例：

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

# TurnOffConfirmation

小微响应示例：“好的”
目的：表示设备已成功打开。对于成功的TurnOffRequest，技能适配器对Smart Home Skill API的预期响应。

Header

属性	值
name	TurnOffConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status.dev_att_switch	指进行操作后，设备的开关状态：flase:关闭，true:打开。	是

TurnOffConfirmation示例：

    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "TurnOffConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion": "2"
        },
        "payload": {
            "status":{
                "deviceSwitch": false
             }
        }
    }