# 音量

以下这些消息类型，以增加或减少的形式设置设备音量。

SetVolumeRequest
SetVolumeConfirmation
IncrementVolumeRequest
IncrementVolumeConfirmation
DecrementVolumeRequest
DecrementVolumeConfirmation
MuteRequest
MuteConfirmation
UnmuteRequest
UnmuteConfirmation

# SetVolumeRequest

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

Header

属性	值
name	SetVolumeRequest
namespace	SmartHome.Control

Payload

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

SetVolumeRequest*示例：

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

# SetVolumeConfirmation

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

Header

属性	值
name	SetVolumeConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了指定的音量后设备的状态。	是
status.volumeValue	当前设备的音量。	是
status.deviceMute	当前设备是否静音	是

SetVolumeConfirmation示例：

    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": "SetVolumeConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion":"2"
        },
        "payload": {
            "status": {
                "volumeValue": 50，
                "deviceMute":false
            }
        }
    }

# IncrementVolumeRequest

示例语句：
“小微，{设备名}音量调高点” “小微，{设备名}音量调高10”
目的：增加设备的音量。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	IncrementVolumeRequest
namespace	SmartHome.Control

Payload

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

IncrementVolumeRequest*示例：

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

# IncrementVolumeConfirmation

小微响应示例：“好的”
目的：表示成功增加了设备音量。这是对IncrementVolumeRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	IncrementVolumeConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了音量后设备的状态。	是
status.volumeValue	当前设备的音量。	是
status.deviceMute	当前设备是否静音	是

IncrementVolumeConfirmation*示例：

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

# DecrementVolumeRequest

示例语句：
“小微，{设备名}音量调低点” “小微，{设备名}音量调低10”
目的：降低设备的音量。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	DecrementVolumeRequest
namespace	SmartHome.Control

Payload

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

DecrementVolumeRequest示例：

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

# DecrementVolumeConfirmation

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

Header

属性	值
name	DecrementVolumeConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了音量后设备的状态。	是
status.volumeValue	当前设备的音量。	是
status.deviceMute	当前设备是否静音	是

DecrementVolumeConfirmation示例：

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

# MuteRequest

示例语句：
“小微，{设备名}静音”
目的：请求设备静音。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	MuteRequest
namespace	SmartHome.Control

Payload

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

MuteRequest示例：

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

# MuteConfirmation

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

Header

属性	值
name	MuteConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了音量后设备的状态。	是
status.volumeValue	当前设备的音量。	是
status.deviceMute	当前设备是否静音	是

MuteConfirmation示例：

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

# UnmuteRequest

示例语句：
“小微，{设备名}取消静音”
目的：请求设备取消静音。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	UnmutefRequest
namespace	SmartHome.Control

Payload

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

UnmuteRequest示例：

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

# UnmuteConfirmation

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

Header

属性	值
name	UnmuteConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status 对象	调整了音量后设备的状态。	是
status.volumeValue	当前设备的音量。	是
status.deviceMute	当前设备是否静音	是

UnmuteConfirmation示例：

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