bowen liu / Mbed OS mbed-os-example-blinky

ex

Fork of mbed-os-example-mbed5-blinky by mbed-os-examples

dumi_doc-master/doc/smart_home_skill_api_reference.md@44:c1d8923072ba, 2017-07-18 (annotated)

Committer:
TMBOY
Date:
Tue Jul 18 16:27:22 2017 +0800
Revision:
44:c1d8923072ba
?

Who changed what in which revision?

UserRevisionLine numberNew contents of line
TMBOY 44:c1d8923072ba 1 # Smart Home Skill API Reference
TMBOY 44:c1d8923072ba 2
TMBOY 44:c1d8923072ba 3 <!-- MarkdownTOC -->
TMBOY 44:c1d8923072ba 4
TMBOY 44:c1d8923072ba 5 - [简介](#%E7%AE%80%E4%BB%8B)
TMBOY 44:c1d8923072ba 6 - [认证](#%E8%AE%A4%E8%AF%81)
TMBOY 44:c1d8923072ba 7 - [Skill指令](#skill%E6%8C%87%E4%BB%A4)
TMBOY 44:c1d8923072ba 8 - [Header](#header)
TMBOY 44:c1d8923072ba 9 - [Payload](#payload)
TMBOY 44:c1d8923072ba 10 - [发现设备\(Discovery Message\)](#%E5%8F%91%E7%8E%B0%E8%AE%BE%E5%A4%87discovery-message)
TMBOY 44:c1d8923072ba 11 - [DiscoverAppliancesRequest](#discoverappliancesrequest)
TMBOY 44:c1d8923072ba 12 - [DiscoverAppliancesResponse](#discoverappliancesresponse)
TMBOY 44:c1d8923072ba 13 - [控制设备\(Control Message\)](#%E6%8E%A7%E5%88%B6%E8%AE%BE%E5%A4%87control-message)
TMBOY 44:c1d8923072ba 14 - [打开关闭设备\(On/Off Messages\)](#%E6%89%93%E5%BC%80%E5%85%B3%E9%97%AD%E8%AE%BE%E5%A4%87onoff-messages)
TMBOY 44:c1d8923072ba 15 - [可控灯光设备\(Tunable Lighting Control Messages\)](#%E5%8F%AF%E6%8E%A7%E7%81%AF%E5%85%89%E8%AE%BE%E5%A4%87tunable-lighting-control-messages)
TMBOY 44:c1d8923072ba 16 - [可控温度设备\(Temperature Control Messages\)](#%E5%8F%AF%E6%8E%A7%E6%B8%A9%E5%BA%A6%E8%AE%BE%E5%A4%87temperature-control-messages)
TMBOY 44:c1d8923072ba 17 - [可控风速设备\(Fan Speed Control Messages\)](#%E5%8F%AF%E6%8E%A7%E9%A3%8E%E9%80%9F%E8%AE%BE%E5%A4%87fan-speed-control-messages)
TMBOY 44:c1d8923072ba 18 - [查询状态\(Query Message\)](#%E6%9F%A5%E8%AF%A2%E7%8A%B6%E6%80%81query-message)
TMBOY 44:c1d8923072ba 19 - [查询空气质量](#%E6%9F%A5%E8%AF%A2%E7%A9%BA%E6%B0%94%E8%B4%A8%E9%87%8F)
TMBOY 44:c1d8923072ba 20 - [错误消息\(Error Message\)](#%E9%94%99%E8%AF%AF%E6%B6%88%E6%81%AFerror-message)
TMBOY 44:c1d8923072ba 21 - [用户故障\(User Faults\)](#%E7%94%A8%E6%88%B7%E6%95%85%E9%9A%9Cuser-faults)
TMBOY 44:c1d8923072ba 22 - [Bot故障\(Bot Faults\)](#bot%E6%95%85%E9%9A%9Cbot-faults)
TMBOY 44:c1d8923072ba 23 - [其他错误\(Other Faults\)](#%E5%85%B6%E4%BB%96%E9%94%99%E8%AF%AFother-faults)
TMBOY 44:c1d8923072ba 24
TMBOY 44:c1d8923072ba 25 <!-- /MarkdownTOC -->
TMBOY 44:c1d8923072ba 26
TMBOY 44:c1d8923072ba 27 ## 简介
TMBOY 44:c1d8923072ba 28
TMBOY 44:c1d8923072ba 29 该协议实现度秘终端互联互通的目的，达到通过使用支持DuerOS能力的设备，控制灯泡等被控设备的效果。
TMBOY 44:c1d8923072ba 30
TMBOY 44:c1d8923072ba 31 ## 认证
TMBOY 44:c1d8923072ba 32
TMBOY 44:c1d8923072ba 33 Smart Home Skill API 遵循 OAuth2.0 规范。
TMBOY 44:c1d8923072ba 34 从 DuerOS 发送到 厂商Bot 的每个请求都包含 OAuth 的 access token。
TMBOY 44:c1d8923072ba 35
TMBOY 44:c1d8923072ba 36 ## Skill指令
TMBOY 44:c1d8923072ba 37
TMBOY 44:c1d8923072ba 38 所有的指令(Directives)，不论是DuerOS发送给Bot还是Bot返回给DuerOS，都是同一个结构，包含以下两个顶层字段：
TMBOY 44:c1d8923072ba 39 * Header
TMBOY 44:c1d8923072ba 40 * Payload
TMBOY 44:c1d8923072ba 41
TMBOY 44:c1d8923072ba 42 ### Header
TMBOY 44:c1d8923072ba 43
TMBOY 44:c1d8923072ba 44 Header包含 命名空间、指令名称、目标版本和唯一消息标识符。以下是典型的消息Header的JSON示例：
TMBOY 44:c1d8923072ba 45 ```
TMBOY 44:c1d8923072ba 46 {
TMBOY 44:c1d8923072ba 47 "header": {
TMBOY 44:c1d8923072ba 48 "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
TMBOY 44:c1d8923072ba 49 "name": "DiscoverAppliancesRequest",
TMBOY 44:c1d8923072ba 50 "namespace": "DuerOS.ConnectedHome.Discovery",
TMBOY 44:c1d8923072ba 51 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 52 }
TMBOY 44:c1d8923072ba 53 }
TMBOY 44:c1d8923072ba 54 ```
TMBOY 44:c1d8923072ba 55
TMBOY 44:c1d8923072ba 56 Header必须包含以下属性：
TMBOY 44:c1d8923072ba 57
TMBOY 44:c1d8923072ba 58 |Property | Description |
TMBOY 44:c1d8923072ba 59 |---|---|
TMBOY 44:c1d8923072ba 60 |messageId | 单个请求或响应的唯一标识符。 这用于跟踪目的，Bot应该记录此信息，尽管它不应用于支持业务逻辑。 来自Bot的每条消息都必须填充此字段。 任何字符串数字字符和短于128个字符的字符串都是有效的，但是推荐使用随机数生成的UUID版本4 UUID。 |
TMBOY 44:c1d8923072ba 61 |name | 指令的名称，如 DiscoverAppliancesRequest 和 DiscoverAppliancesResponse |
TMBOY 44:c1d8923072ba 62 |namespace | 指定消息payload的类别。 目前的类别有： DuerOS.ConnectedHome.Discovery、DuerOS.ConnectedHome.Control、DuerOS.ConnectedHome.Query |
TMBOY 44:c1d8923072ba 63 |payloadVersion | 标识payload的版本号 |
TMBOY 44:c1d8923072ba 64
TMBOY 44:c1d8923072ba 65 ### Payload
TMBOY 44:c1d8923072ba 66
TMBOY 44:c1d8923072ba 67 Payload的内容取决于在Header中的name值。
TMBOY 44:c1d8923072ba 68 以下部分描述不同类型的指令，及其预期的payload描述和示例。
TMBOY 44:c1d8923072ba 69
TMBOY 44:c1d8923072ba 70 |Task | Namespace | Message Names |
TMBOY 44:c1d8923072ba 71 |---|---|---|
TMBOY 44:c1d8923072ba 72 |Discover connected devices | DuerOS.ConnectedHome.Discovery | DiscoverAppliancesRequest、DiscoverAppliancesResponse|
TMBOY 44:c1d8923072ba 73 |Control connected devices; turn things off and on and change settings | DuerOS.ConnectedHome.Control |TurnOnRequest、TimingTurnOnRequest、TurnOffRequest、IncrementBrightnessRequest、DecrementBrightnessRequest、IncrementTemperatureRequest、DecrementTemperatureRequest、SetTemperatureRequest、IncrementFanSpeedRequest、DecrementFanSpeedRequest、SetModeRequest、TimingSetModeRequest |
TMBOY 44:c1d8923072ba 74 |Query connected devices for their current state | DuerOS.ConnectedHome.Query | GetAirPM25Request |
TMBOY 44:c1d8923072ba 75
TMBOY 44:c1d8923072ba 76 ### 发现设备(Discovery Message)
TMBOY 44:c1d8923072ba 77
TMBOY 44:c1d8923072ba 78 该消息类型用于发现可用的设备，确定其使用场景和功能。
TMBOY 44:c1d8923072ba 79
TMBOY 44:c1d8923072ba 80 #### DiscoverAppliancesRequest
TMBOY 44:c1d8923072ba 81
TMBOY 44:c1d8923072ba 82 **例子：**
TMBOY 44:c1d8923072ba 83
TMBOY 44:c1d8923072ba 84 “小度小度，查找我的设备”
TMBOY 44:c1d8923072ba 85
TMBOY 44:c1d8923072ba 86 **目的：**
TMBOY 44:c1d8923072ba 87
TMBOY 44:c1d8923072ba 88 发现与最终用户的设备云帐户相关的设备和场景。DiscoverAppliancesRequest 从 DuerOS 发送到 Bot。如果没有设备可以发现，或者您的设备云是否遇到错误，则 Bot 应返回一个空的 DiscoverAppliancesResponse，而不是错误消息。
TMBOY 44:c1d8923072ba 89
TMBOY 44:c1d8923072ba 90 ##### Header
TMBOY 44:c1d8923072ba 91
TMBOY 44:c1d8923072ba 92 |Property | Value |
TMBOY 44:c1d8923072ba 93 |---|---|
TMBOY 44:c1d8923072ba 94 |name | DiscoverAppliancesRequest |
TMBOY 44:c1d8923072ba 95 |namespace | DuerOS.ConnectedHome.Discovery |
TMBOY 44:c1d8923072ba 96
TMBOY 44:c1d8923072ba 97 ##### Payload
TMBOY 44:c1d8923072ba 98
TMBOY 44:c1d8923072ba 99 |Property | Description | Required |
TMBOY 44:c1d8923072ba 100 |---|---|---|
TMBOY 44:c1d8923072ba 101 |accessToken | 与用户设备云帐号相关的access token | Yes |
TMBOY 44:c1d8923072ba 102
TMBOY 44:c1d8923072ba 103 DiscoverAppliancesRequest例子：
TMBOY 44:c1d8923072ba 104 ```
TMBOY 44:c1d8923072ba 105 {
TMBOY 44:c1d8923072ba 106 "header": {
TMBOY 44:c1d8923072ba 107 "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
TMBOY 44:c1d8923072ba 108 "name": "DiscoverAppliancesRequest",
TMBOY 44:c1d8923072ba 109 "namespace": "DuerOS.ConnectedHome.Discovery",
TMBOY 44:c1d8923072ba 110 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 111 },
TMBOY 44:c1d8923072ba 112 "payload": {
TMBOY 44:c1d8923072ba 113 "accessToken": "*OAuth Token here*"
TMBOY 44:c1d8923072ba 114 }
TMBOY 44:c1d8923072ba 115 }
TMBOY 44:c1d8923072ba 116 ```
TMBOY 44:c1d8923072ba 117
TMBOY 44:c1d8923072ba 118 #### DiscoverAppliancesResponse
TMBOY 44:c1d8923072ba 119
TMBOY 44:c1d8923072ba 120 **目的：**
TMBOY 44:c1d8923072ba 121
TMBOY 44:c1d8923072ba 122 返回与最终用户的设备云帐户相关的所有设备的能力。是Bot对 DiscoverAppliancesRequest 的预期响应。如果没有发现设备或者您的设备云遇到错误，请返回一个空的 discoveryAppliances 数组。 DiscoverAppliancesResponse 指令包含与您的能力和数据相关联的设备列表，如：
TMBOY 44:c1d8923072ba 123 * 用户标识的名称和描述
TMBOY 44:c1d8923072ba 124 * 设备类型，如light 和 scene
TMBOY 44:c1d8923072ba 125 * 每个设备或场景支持的操作
TMBOY 44:c1d8923072ba 126
TMBOY 44:c1d8923072ba 127 ##### Header
TMBOY 44:c1d8923072ba 128
TMBOY 44:c1d8923072ba 129 |Property | Value |
TMBOY 44:c1d8923072ba 130 |---|---|
TMBOY 44:c1d8923072ba 131 |name | DiscoverAppliancesResponse |
TMBOY 44:c1d8923072ba 132 |namespace | DuerOS.ConnectedHome.Discovery |
TMBOY 44:c1d8923072ba 133
TMBOY 44:c1d8923072ba 134 ##### Payload
TMBOY 44:c1d8923072ba 135
TMBOY 44:c1d8923072ba 136 |Property | Description | Required |
TMBOY 44:c1d8923072ba 137 |---|---|---|
TMBOY 44:c1d8923072ba 138 |discoveredAppliances | discoveredAppliance 对象的数组，该对象包含可发现设备或场景，与用户设备帐户相关联的。 如果没有与用户帐户关联的设备或场景，此属性应包含一个空数组。 如果发生错误，该属性可以为null。 阵列中允许的最大项目数量为300。discoveryAppliance对象的每个属性如下所示 | Yes |
TMBOY 44:c1d8923072ba 139 |discoveredAppliance.applianceTypes | 包含字符串的数组，其中字符串，表示所连接设备的类别，如LIGHT；或者表示场景。有关支持的字符串的完整列表，请参阅设备类别。任何其他字符串将被拒绝。 | Yes |
TMBOY 44:c1d8923072ba 140 |discoveredAppliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。| Yes |
TMBOY 44:c1d8923072ba 141 |discoveredAppliance.manufacturerName | 设备制造商的名称。此值不能超过128个字符。| Yes |
TMBOY 44:c1d8923072ba 142 |discoveredAppliance.modelName | 设备型号名称。此值不能超过128个字符。 | Yes |
TMBOY 44:c1d8923072ba 143 |discoveredAppliance.version | 供应商提供的设备版本。此值不能超过128个字符。 | Yes |
TMBOY 44:c1d8923072ba 144 |discoveredAppliance.friendlyName | 用户用来识别设备的名称。 此值不能超过128个字符，不应包含特殊字符或标点符号。| Yes |
TMBOY 44:c1d8923072ba 145 |discoveredAppliance.friendlyDescription | 设备的可读描述。 此值不能超过128个字符。 描述应包含设备连接方式的描述。 例如，“通过Wink连接的WiFi温控器”。| Yes |
TMBOY 44:c1d8923072ba 146 |discoveredAppliance.isReachable | true表示设备当前可达; 否则，false。| Yes |
TMBOY 44:c1d8923072ba 147 |discoveredAppliance.actions | 设备可支持的action的数组。合法的action包括： <br>turnOn<br/> <br>timingTurnOn<br/> <br>turnOff<br/> <br>incrementBrightness<br/> <br>decrementBrightness<br/> <br>incrementTemperature<br/> <br>decrementTemperature<br/> <br>setTemperature<br/> <br>incrementFanSpeed<br/> <br>decrementFanSpeed<br/> <br>setMode<br/> <br>timingSetMode<br/> <br>getAirPM25<br/>| Yes |
TMBOY 44:c1d8923072ba 148 |discoveredAppliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 149
TMBOY 44:c1d8923072ba 150 设备 和 场景 类型:
TMBOY 44:c1d8923072ba 151
TMBOY 44:c1d8923072ba 152 |Value | Description | Notes |
TMBOY 44:c1d8923072ba 153 |---|---|---|
TMBOY 44:c1d8923072ba 154 |WASHING_MACHINE| 洗衣机等设备 ||
TMBOY 44:c1d8923072ba 155 |AIR_CONDITION| 空调等设备 ||
TMBOY 44:c1d8923072ba 156 |RANGE_HOOD | 抽油烟机等设备 | |
TMBOY 44:c1d8923072ba 157 |LIGHT| 代表光源的设备 ||
TMBOY 44:c1d8923072ba 158 |CURTAIN | 窗帘等设备 | |
TMBOY 44:c1d8923072ba 159 |ACTIVITY_TRIGGER| 描述设置为特定状态的设备的组合，状态必须以特定顺序变更。例如，“观看优酷视频”场景可能需要 (1)打开电视机; (2)打开HDMI1。| |
TMBOY 44:c1d8923072ba 160 |SCENE_TRIGGER| 描述设置为特定状态的设备的组合，状态不必以特定顺序变更。 例如睡眠模式可能包括关闭灯光和拉上窗帘，但是顺序不重要。| |
TMBOY 44:c1d8923072ba 161
TMBOY 44:c1d8923072ba 162 注：在 场景 类型的appliance下，需对 friendlyDescription 和 friendlyName 的命名有一定规范：
TMBOY 44:c1d8923072ba 163
TMBOY 44:c1d8923072ba 164 * friendlyDescription 的值内容必须包含“场景”及场景提供的设备厂商。如 “来自*厂商*的场景”. 此值不能超过128个字符。
TMBOY 44:c1d8923072ba 165 * friendlyName 是用户用来与您的场景交互并且必须存在的名称。目的是让用户以自然而轻松的方式控制场景。friendlyName应遵循以下准则：
TMBOY 44:c1d8923072ba 166 * 首选项，仅包括场景名称。这为用户控制场景提供了最简单和最自然的方式
TMBOY 44:c1d8923072ba 167 * 可选，包括房间名称，如果在不同的房间提供类似的场景
TMBOY 44:c1d8923072ba 168 * 可选，包括房间“场景”
TMBOY 44:c1d8923072ba 169 * 可选，包括场景名称和房间名称之间的介词，如“在”
TMBOY 44:c1d8923072ba 170 * 不能包含特殊字符活标点符号
TMBOY 44:c1d8923072ba 171 * 不能超过128个字符
TMBOY 44:c1d8923072ba 172
TMBOY 44:c1d8923072ba 173 DiscoverAppliancesResponse 例子：
TMBOY 44:c1d8923072ba 174
TMBOY 44:c1d8923072ba 175 ```
TMBOY 44:c1d8923072ba 176 {
TMBOY 44:c1d8923072ba 177 "header":{
TMBOY 44:c1d8923072ba 178 "messageId":"ff746d98-ab02-4c9e-9d0d-b44711658414",
TMBOY 44:c1d8923072ba 179 "name":"DiscoverAppliancesResponse",
TMBOY 44:c1d8923072ba 180 "namespace":"DuerOS.ConnectedHome.Discovery",
TMBOY 44:c1d8923072ba 181 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 182 },
TMBOY 44:c1d8923072ba 183 "payload":{
TMBOY 44:c1d8923072ba 184 "discoveredAppliances":[
TMBOY 44:c1d8923072ba 185 {
TMBOY 44:c1d8923072ba 186 "actions":[
TMBOY 44:c1d8923072ba 187 "turnOn",
TMBOY 44:c1d8923072ba 188 "turnOff",
TMBOY 44:c1d8923072ba 189 "incrementBrightness",
TMBOY 44:c1d8923072ba 190 "decrementBrightness"
TMBOY 44:c1d8923072ba 191 ],
TMBOY 44:c1d8923072ba 192 "applianceTypes":[
TMBOY 44:c1d8923072ba 193 "LIGHT"
TMBOY 44:c1d8923072ba 194 ],
TMBOY 44:c1d8923072ba 195 "additionalApplianceDetails":{
TMBOY 44:c1d8923072ba 196 "extraDetail1":"optionalDetailForSkillAdapterToReferenceThisDevice",
TMBOY 44:c1d8923072ba 197 "extraDetail2":"There can be multiple entries",
TMBOY 44:c1d8923072ba 198 "extraDetail3":"but they should only be used for reference purposes.",
TMBOY 44:c1d8923072ba 199 "extraDetail4":"This is not a suitable place to maintain current device state"
TMBOY 44:c1d8923072ba 200 },
TMBOY 44:c1d8923072ba 201 "applianceId":"uniqueLightDeviceId",
TMBOY 44:c1d8923072ba 202 "friendlyDescription":"展现给用户的详细介绍",
TMBOY 44:c1d8923072ba 203 "friendlyName":"卧室",
TMBOY 44:c1d8923072ba 204 "isReachable":true,
TMBOY 44:c1d8923072ba 205 "manufacturerName":"设备制造商的名称",
TMBOY 44:c1d8923072ba 206 "modelName":"fancyLight",
TMBOY 44:c1d8923072ba 207 "version":"your software version number here."
TMBOY 44:c1d8923072ba 208 },
TMBOY 44:c1d8923072ba 209 {
TMBOY 44:c1d8923072ba 210 "actions":[
TMBOY 44:c1d8923072ba 211 "turnOn",
TMBOY 44:c1d8923072ba 212 "turnOff"
TMBOY 44:c1d8923072ba 213 ],
TMBOY 44:c1d8923072ba 214 "applianceTypes":[
TMBOY 44:c1d8923072ba 215 "CURTAIN"
TMBOY 44:c1d8923072ba 216 ],
TMBOY 44:c1d8923072ba 217 "additionalApplianceDetails":{
TMBOY 44:c1d8923072ba 218 "extraDetail1":"optionalDetailForSkillAdapterToReferenceThisDevice",
TMBOY 44:c1d8923072ba 219 "extraDetail2":"There can be multiple entries",
TMBOY 44:c1d8923072ba 220 "extraDetail3":"but they should only be used for reference purposes.",
TMBOY 44:c1d8923072ba 221 "extraDetail4":"This is not a suitable place to maintain current device state"
TMBOY 44:c1d8923072ba 222 },
TMBOY 44:c1d8923072ba 223 "applianceId":"uniqueSwitchDeviceId",
TMBOY 44:c1d8923072ba 224 "friendlyDescription":"展现给用户的详细介绍",
TMBOY 44:c1d8923072ba 225 "friendlyName":"卧室的窗帘",
TMBOY 44:c1d8923072ba 226 "isReachable":true,
TMBOY 44:c1d8923072ba 227 "manufacturerName":"设备制造商的名称",
TMBOY 44:c1d8923072ba 228 "modelName":"fancyCurtain",
TMBOY 44:c1d8923072ba 229 "version":"your software version number here."
TMBOY 44:c1d8923072ba 230 },
TMBOY 44:c1d8923072ba 231 {
TMBOY 44:c1d8923072ba 232 "actions": [
TMBOY 44:c1d8923072ba 233 "turnOn",
TMBOY 44:c1d8923072ba 234 "turnOff"
TMBOY 44:c1d8923072ba 235 ],
TMBOY 44:c1d8923072ba 236 "applianceTypes":[
TMBOY 44:c1d8923072ba 237 "SCENE_TRIGGER"
TMBOY 44:c1d8923072ba 238 ],
TMBOY 44:c1d8923072ba 239 "additionalApplianceDetails": {
TMBOY 44:c1d8923072ba 240 "extraDetail1": "detail about the scene",
TMBOY 44:c1d8923072ba 241 "extraDetail2": "another detail about scene",
TMBOY 44:c1d8923072ba 242 "extraDetail3": "only be used for reference purposes."
TMBOY 44:c1d8923072ba 243 },
TMBOY 44:c1d8923072ba 244 "applianceId": "uniqueDeviceId",
TMBOY 44:c1d8923072ba 245 "friendlyDescription": "来自设备商的场景",
TMBOY 44:c1d8923072ba 246 "friendlyName": "回家模式",
TMBOY 44:c1d8923072ba 247 "isReachable": true,
TMBOY 44:c1d8923072ba 248 "manufacturerName": "yourManufacturerName",
TMBOY 44:c1d8923072ba 249 "modelName": "提供场景的设备型号",
TMBOY 44:c1d8923072ba 250 "version": "your software version number here."
TMBOY 44:c1d8923072ba 251 }
TMBOY 44:c1d8923072ba 252 ]
TMBOY 44:c1d8923072ba 253 }
TMBOY 44:c1d8923072ba 254 }
TMBOY 44:c1d8923072ba 255 ```
TMBOY 44:c1d8923072ba 256
TMBOY 44:c1d8923072ba 257 ### 控制设备(Control Message)
TMBOY 44:c1d8923072ba 258
TMBOY 44:c1d8923072ba 259 #### 打开关闭设备(On/Off Messages)
TMBOY 44:c1d8923072ba 260
TMBOY 44:c1d8923072ba 261 消息类型打开或关闭目标设备。这些消息通常由几种不同类型的设备使用。
TMBOY 44:c1d8923072ba 262 * TurnOnRequest
TMBOY 44:c1d8923072ba 263 * TurnOnConfirmation
TMBOY 44:c1d8923072ba 264 * TimingTurnOnRequest
TMBOY 44:c1d8923072ba 265 * TimingTurnOnConfirmation
TMBOY 44:c1d8923072ba 266 * TurnOffRequest
TMBOY 44:c1d8923072ba 267 * TurnOffConfirmation
TMBOY 44:c1d8923072ba 268
TMBOY 44:c1d8923072ba 269 ##### TurnOnRequest
TMBOY 44:c1d8923072ba 270
TMBOY 44:c1d8923072ba 271 **例子：**
TMBOY 44:c1d8923072ba 272 “小度小度，打开 *设备名*”
TMBOY 44:c1d8923072ba 273
TMBOY 44:c1d8923072ba 274 **目的：**
TMBOY 44:c1d8923072ba 275 DuerOS发送给Bot的打开设备的请求
TMBOY 44:c1d8923072ba 276
TMBOY 44:c1d8923072ba 277 ###### Header
TMBOY 44:c1d8923072ba 278
TMBOY 44:c1d8923072ba 279 |Property|Value|
TMBOY 44:c1d8923072ba 280 |---|---|
TMBOY 44:c1d8923072ba 281 |name|TurnOnRequest|
TMBOY 44:c1d8923072ba 282 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 283
TMBOY 44:c1d8923072ba 284 ###### Payload
TMBOY 44:c1d8923072ba 285
TMBOY 44:c1d8923072ba 286 |Property|Description|Required|
TMBOY 44:c1d8923072ba 287 |---|---|---|
TMBOY 44:c1d8923072ba 288 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 289 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 290 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 291 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 292
TMBOY 44:c1d8923072ba 293 TurnOnRequest 例子：
TMBOY 44:c1d8923072ba 294 ```
TMBOY 44:c1d8923072ba 295 {
TMBOY 44:c1d8923072ba 296 "header": {
TMBOY 44:c1d8923072ba 297 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 298 "name": "TurnOnRequest",
TMBOY 44:c1d8923072ba 299 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 300 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 301 },
TMBOY 44:c1d8923072ba 302 "payload": {
TMBOY 44:c1d8923072ba 303 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 304 "appliance": {
TMBOY 44:c1d8923072ba 305 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 306 "applianceId": "[Device ID for Ceiling Fan]"
TMBOY 44:c1d8923072ba 307 }
TMBOY 44:c1d8923072ba 308 }
TMBOY 44:c1d8923072ba 309 }
TMBOY 44:c1d8923072ba 310 ```
TMBOY 44:c1d8923072ba 311
TMBOY 44:c1d8923072ba 312 ##### TurnOnConfirmation
TMBOY 44:c1d8923072ba 313
TMBOY 44:c1d8923072ba 314 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 315 “*设备name*已打开”
TMBOY 44:c1d8923072ba 316
TMBOY 44:c1d8923072ba 317 **目的：**
TMBOY 44:c1d8923072ba 318 表示设备已经被成功打开。表示Bot返回给DuerOS的打开成功的结果
TMBOY 44:c1d8923072ba 319
TMBOY 44:c1d8923072ba 320 ###### Header
TMBOY 44:c1d8923072ba 321
TMBOY 44:c1d8923072ba 322 |Property|Value|
TMBOY 44:c1d8923072ba 323 |---|---|
TMBOY 44:c1d8923072ba 324 |name| TurnOnConfirmation |
TMBOY 44:c1d8923072ba 325 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 326
TMBOY 44:c1d8923072ba 327 ###### Payload
TMBOY 44:c1d8923072ba 328
TMBOY 44:c1d8923072ba 329 |Property|Description|Required|
TMBOY 44:c1d8923072ba 330 |---|---|---|
TMBOY 44:c1d8923072ba 331 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 332
TMBOY 44:c1d8923072ba 333 TurnOnConfirmation 例子：
TMBOY 44:c1d8923072ba 334 ```
TMBOY 44:c1d8923072ba 335 {
TMBOY 44:c1d8923072ba 336 "header": {
TMBOY 44:c1d8923072ba 337 "messageId": "26fa11a8-accb-4f66-a272-8b1ff7abd722",
TMBOY 44:c1d8923072ba 338 "name": "TurnOnConfirmation",
TMBOY 44:c1d8923072ba 339 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 340 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 341 },
TMBOY 44:c1d8923072ba 342 "payload": {}
TMBOY 44:c1d8923072ba 343 }
TMBOY 44:c1d8923072ba 344 ```
TMBOY 44:c1d8923072ba 345
TMBOY 44:c1d8923072ba 346 ##### TimingTurnOnRequest
TMBOY 44:c1d8923072ba 347
TMBOY 44:c1d8923072ba 348 **例子：**
TMBOY 44:c1d8923072ba 349 “小度小度，定时1分钟后打开 *设备名*”
TMBOY 44:c1d8923072ba 350
TMBOY 44:c1d8923072ba 351 **目的：**
TMBOY 44:c1d8923072ba 352 DuerOS发送给Bot的打开设备的请求
TMBOY 44:c1d8923072ba 353
TMBOY 44:c1d8923072ba 354 ###### Header
TMBOY 44:c1d8923072ba 355
TMBOY 44:c1d8923072ba 356 |Property|Value|
TMBOY 44:c1d8923072ba 357 |---|---|
TMBOY 44:c1d8923072ba 358 |name|TimingTurnOnRequest|
TMBOY 44:c1d8923072ba 359 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 360
TMBOY 44:c1d8923072ba 361 ###### Payload
TMBOY 44:c1d8923072ba 362
TMBOY 44:c1d8923072ba 363 |Property|Description|Required|
TMBOY 44:c1d8923072ba 364 |---|---|---|
TMBOY 44:c1d8923072ba 365 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 366 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 367 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 368 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 369 | timestamp | 表示设备定时设置的量的对象。包含一个属性值，它指定一个数字，代表时间戳。 | No |
TMBOY 44:c1d8923072ba 370
TMBOY 44:c1d8923072ba 371 TimingTurnOnRequest 例子：
TMBOY 44:c1d8923072ba 372 ```
TMBOY 44:c1d8923072ba 373 {
TMBOY 44:c1d8923072ba 374 "header": {
TMBOY 44:c1d8923072ba 375 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 376 "name": "TimingTurnOnRequest",
TMBOY 44:c1d8923072ba 377 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 378 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 379 },
TMBOY 44:c1d8923072ba 380 "payload": {
TMBOY 44:c1d8923072ba 381 "timestamp": {
TMBOY 44:c1d8923072ba 382 "value": 1496741861
TMBOY 44:c1d8923072ba 383 },
TMBOY 44:c1d8923072ba 384 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 385 "appliance": {
TMBOY 44:c1d8923072ba 386 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 387 "applianceId": "[Device ID for Ceiling Fan]"
TMBOY 44:c1d8923072ba 388 }
TMBOY 44:c1d8923072ba 389 }
TMBOY 44:c1d8923072ba 390 }
TMBOY 44:c1d8923072ba 391 ```
TMBOY 44:c1d8923072ba 392
TMBOY 44:c1d8923072ba 393 ##### TimingTurnOnConfirmation
TMBOY 44:c1d8923072ba 394
TMBOY 44:c1d8923072ba 395 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 396 “*设备name*已定时成功”
TMBOY 44:c1d8923072ba 397
TMBOY 44:c1d8923072ba 398 **目的：**
TMBOY 44:c1d8923072ba 399 表示设备已经被成功定时。表示Bot返回给DuerOS的打开成功的结果
TMBOY 44:c1d8923072ba 400
TMBOY 44:c1d8923072ba 401 ###### Header
TMBOY 44:c1d8923072ba 402
TMBOY 44:c1d8923072ba 403 |Property|Value|
TMBOY 44:c1d8923072ba 404 |---|---|
TMBOY 44:c1d8923072ba 405 |name| TimingTurnOnConfirmation |
TMBOY 44:c1d8923072ba 406 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 407
TMBOY 44:c1d8923072ba 408 ###### Payload
TMBOY 44:c1d8923072ba 409
TMBOY 44:c1d8923072ba 410 |Property|Description|Required|
TMBOY 44:c1d8923072ba 411 |---|---|---|
TMBOY 44:c1d8923072ba 412 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 413
TMBOY 44:c1d8923072ba 414 TimingTurnOnConfirmation 例子：
TMBOY 44:c1d8923072ba 415 ```
TMBOY 44:c1d8923072ba 416 {
TMBOY 44:c1d8923072ba 417 "header": {
TMBOY 44:c1d8923072ba 418 "messageId": "26fa11a8-accb-4f66-a272-8b1ff7abd722",
TMBOY 44:c1d8923072ba 419 "name": "TimingTurnOnConfirmation",
TMBOY 44:c1d8923072ba 420 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 421 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 422 },
TMBOY 44:c1d8923072ba 423 "payload": {}
TMBOY 44:c1d8923072ba 424 }
TMBOY 44:c1d8923072ba 425 ```
TMBOY 44:c1d8923072ba 426
TMBOY 44:c1d8923072ba 427 ##### TurnOffRequest
TMBOY 44:c1d8923072ba 428
TMBOY 44:c1d8923072ba 429 **例子：**
TMBOY 44:c1d8923072ba 430 “小度小度，关闭 *设备名*”
TMBOY 44:c1d8923072ba 431
TMBOY 44:c1d8923072ba 432 **目的：**
TMBOY 44:c1d8923072ba 433 DuerOS发送给Bot的关闭设备的请求
TMBOY 44:c1d8923072ba 434
TMBOY 44:c1d8923072ba 435 ###### Header
TMBOY 44:c1d8923072ba 436
TMBOY 44:c1d8923072ba 437 |Property|Value|
TMBOY 44:c1d8923072ba 438 |---|---|
TMBOY 44:c1d8923072ba 439 |name|TurnOffRequest|
TMBOY 44:c1d8923072ba 440 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 441
TMBOY 44:c1d8923072ba 442 ###### Payload
TMBOY 44:c1d8923072ba 443
TMBOY 44:c1d8923072ba 444 |Property|Description|Required|
TMBOY 44:c1d8923072ba 445 |---|---|---|
TMBOY 44:c1d8923072ba 446 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 447 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 448 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 449 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 450
TMBOY 44:c1d8923072ba 451 TurnOffRequest 例子：
TMBOY 44:c1d8923072ba 452 ```
TMBOY 44:c1d8923072ba 453 {
TMBOY 44:c1d8923072ba 454 "header": {
TMBOY 44:c1d8923072ba 455 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 456 "name": "TurnOffRequest",
TMBOY 44:c1d8923072ba 457 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 458 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 459 },
TMBOY 44:c1d8923072ba 460 "payload": {
TMBOY 44:c1d8923072ba 461 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 462 "appliance": {
TMBOY 44:c1d8923072ba 463 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 464 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 465 }
TMBOY 44:c1d8923072ba 466 }
TMBOY 44:c1d8923072ba 467 }
TMBOY 44:c1d8923072ba 468 ```
TMBOY 44:c1d8923072ba 469
TMBOY 44:c1d8923072ba 470 ##### TurnOffConfirmation
TMBOY 44:c1d8923072ba 471
TMBOY 44:c1d8923072ba 472 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 473 “*设备name*已关闭”
TMBOY 44:c1d8923072ba 474
TMBOY 44:c1d8923072ba 475 **目的：**
TMBOY 44:c1d8923072ba 476 表示设备已经被成功关闭。表示Bot返回给DuerOS的关闭成功的结果
TMBOY 44:c1d8923072ba 477
TMBOY 44:c1d8923072ba 478 ###### Header
TMBOY 44:c1d8923072ba 479
TMBOY 44:c1d8923072ba 480 |Property|Value|
TMBOY 44:c1d8923072ba 481 |---|---|
TMBOY 44:c1d8923072ba 482 |name| TurnOffConfirmation |
TMBOY 44:c1d8923072ba 483 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 484
TMBOY 44:c1d8923072ba 485 ###### Payload
TMBOY 44:c1d8923072ba 486
TMBOY 44:c1d8923072ba 487 |Property|Description|Required|
TMBOY 44:c1d8923072ba 488 |---|---|---|
TMBOY 44:c1d8923072ba 489 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 490
TMBOY 44:c1d8923072ba 491 TurnOffConfirmation 例子：
TMBOY 44:c1d8923072ba 492 ```
TMBOY 44:c1d8923072ba 493 {
TMBOY 44:c1d8923072ba 494 "header": {
TMBOY 44:c1d8923072ba 495 "messageId": "26fa11a8-accb-4f66-a272-8b1ff7abd722",
TMBOY 44:c1d8923072ba 496 "name": "TurnOffConfirmation",
TMBOY 44:c1d8923072ba 497 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 498 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 499 },
TMBOY 44:c1d8923072ba 500 "payload": {}
TMBOY 44:c1d8923072ba 501 }
TMBOY 44:c1d8923072ba 502 ```
TMBOY 44:c1d8923072ba 503
TMBOY 44:c1d8923072ba 504 #### 可控灯光设备(Tunable Lighting Control Messages)
TMBOY 44:c1d8923072ba 505
TMBOY 44:c1d8923072ba 506 ##### IncrementBrightnessRequest
TMBOY 44:c1d8923072ba 507
TMBOY 44:c1d8923072ba 508 **例子：**
TMBOY 44:c1d8923072ba 509 “小度小度，把卧室的灯调亮一点”
TMBOY 44:c1d8923072ba 510
TMBOY 44:c1d8923072ba 511 **目的：**
TMBOY 44:c1d8923072ba 512 DuerOS发送给Bot的调亮灯光的请求
TMBOY 44:c1d8923072ba 513
TMBOY 44:c1d8923072ba 514 ###### Header
TMBOY 44:c1d8923072ba 515
TMBOY 44:c1d8923072ba 516 |Property|Value|
TMBOY 44:c1d8923072ba 517 |---|---|
TMBOY 44:c1d8923072ba 518 |name|IncrementBrightnessRequest|
TMBOY 44:c1d8923072ba 519 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 520
TMBOY 44:c1d8923072ba 521 ###### Payload
TMBOY 44:c1d8923072ba 522
TMBOY 44:c1d8923072ba 523 |Property|Description|Required|
TMBOY 44:c1d8923072ba 524 |---|---|---|
TMBOY 44:c1d8923072ba 525 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 526 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 527 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 528 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 529 | deltaBrightness | 表示设备的亮度提高的量的对象。包含一个属性值，它指定一个double类型的数字，表示设备亮度调整的值，其有效范围为0.0000至1.0000。 | Yes |
TMBOY 44:c1d8923072ba 530
TMBOY 44:c1d8923072ba 531 TurnOnRequest 例子：
TMBOY 44:c1d8923072ba 532 ```
TMBOY 44:c1d8923072ba 533 {
TMBOY 44:c1d8923072ba 534 "header": {
TMBOY 44:c1d8923072ba 535 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 536 "name": "IncrementBrightnessRequest",
TMBOY 44:c1d8923072ba 537 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 538 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 539 },
TMBOY 44:c1d8923072ba 540 "payload": {
TMBOY 44:c1d8923072ba 541 "deltaBrightness": {
TMBOY 44:c1d8923072ba 542 "value": 0.500
TMBOY 44:c1d8923072ba 543 },
TMBOY 44:c1d8923072ba 544 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 545 "appliance": {
TMBOY 44:c1d8923072ba 546 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 547 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 548 }
TMBOY 44:c1d8923072ba 549 }
TMBOY 44:c1d8923072ba 550 }
TMBOY 44:c1d8923072ba 551 ```
TMBOY 44:c1d8923072ba 552
TMBOY 44:c1d8923072ba 553 ##### IncrementBrightnessConfirmation
TMBOY 44:c1d8923072ba 554
TMBOY 44:c1d8923072ba 555 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 556 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 557
TMBOY 44:c1d8923072ba 558 **目的：**
TMBOY 44:c1d8923072ba 559 表示设备亮度调高成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 560
TMBOY 44:c1d8923072ba 561 ###### Header
TMBOY 44:c1d8923072ba 562
TMBOY 44:c1d8923072ba 563 |Property|Value|
TMBOY 44:c1d8923072ba 564 |---|---|
TMBOY 44:c1d8923072ba 565 |name| IncrementBrightnessConfirmation |
TMBOY 44:c1d8923072ba 566 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 567
TMBOY 44:c1d8923072ba 568 ###### Payload
TMBOY 44:c1d8923072ba 569
TMBOY 44:c1d8923072ba 570 |Property|Description|Required|
TMBOY 44:c1d8923072ba 571 |---|---|---|
TMBOY 44:c1d8923072ba 572 | brightness | double类型，表示亮度增加后的值。 | Yes |
TMBOY 44:c1d8923072ba 573 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 574 | previousState.brightness | double类型，表示亮度增加前的值。 | Yes |
TMBOY 44:c1d8923072ba 575
TMBOY 44:c1d8923072ba 576 TurnOnConfirmation 例子：
TMBOY 44:c1d8923072ba 577 ```
TMBOY 44:c1d8923072ba 578 {
TMBOY 44:c1d8923072ba 579 "header": {
TMBOY 44:c1d8923072ba 580 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 581 "name": "IncrementBrightnessConfirmation",
TMBOY 44:c1d8923072ba 582 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 583 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 584 },
TMBOY 44:c1d8923072ba 585 "payload": {
TMBOY 44:c1d8923072ba 586 "previousState": {
TMBOY 44:c1d8923072ba 587 "brightness": {
TMBOY 44:c1d8923072ba 588 "value": 0.5
TMBOY 44:c1d8923072ba 589 }
TMBOY 44:c1d8923072ba 590 },
TMBOY 44:c1d8923072ba 591 "brightness": {
TMBOY 44:c1d8923072ba 592 "value": 1.0
TMBOY 44:c1d8923072ba 593 }
TMBOY 44:c1d8923072ba 594 }
TMBOY 44:c1d8923072ba 595 }
TMBOY 44:c1d8923072ba 596 ```
TMBOY 44:c1d8923072ba 597
TMBOY 44:c1d8923072ba 598 ##### DecrementBrightnessRequest
TMBOY 44:c1d8923072ba 599
TMBOY 44:c1d8923072ba 600 **例子：**
TMBOY 44:c1d8923072ba 601 “小度小度，把卧室的灯调暗一点”
TMBOY 44:c1d8923072ba 602
TMBOY 44:c1d8923072ba 603 **目的：**
TMBOY 44:c1d8923072ba 604 DuerOS发送给Bot的调低灯光亮度的请求
TMBOY 44:c1d8923072ba 605
TMBOY 44:c1d8923072ba 606 ###### Header
TMBOY 44:c1d8923072ba 607
TMBOY 44:c1d8923072ba 608 |Property|Value|
TMBOY 44:c1d8923072ba 609 |---|---|
TMBOY 44:c1d8923072ba 610 |name|DecrementBrightnessRequest|
TMBOY 44:c1d8923072ba 611 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 612
TMBOY 44:c1d8923072ba 613 ###### Payload
TMBOY 44:c1d8923072ba 614
TMBOY 44:c1d8923072ba 615 |Property|Description|Required|
TMBOY 44:c1d8923072ba 616 |---|---|---|
TMBOY 44:c1d8923072ba 617 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 618 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 619 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 620 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 621 | deltaBrightness | 表示设备的亮度提高的量的对象。包含一个属性值，它指定一个double类型的数字，表示设备亮度调整的值，其有效范围为0.0000至1.0000。 | Yes |
TMBOY 44:c1d8923072ba 622
TMBOY 44:c1d8923072ba 623 DecrementBrightnessRequest 例子：
TMBOY 44:c1d8923072ba 624 ```
TMBOY 44:c1d8923072ba 625 {
TMBOY 44:c1d8923072ba 626 "header": {
TMBOY 44:c1d8923072ba 627 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 628 "name": "DecrementBrightnessRequest",
TMBOY 44:c1d8923072ba 629 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 630 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 631 },
TMBOY 44:c1d8923072ba 632 "payload": {
TMBOY 44:c1d8923072ba 633 "deltaBrightness": {
TMBOY 44:c1d8923072ba 634 "value": 0.500
TMBOY 44:c1d8923072ba 635 },
TMBOY 44:c1d8923072ba 636 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 637 "appliance": {
TMBOY 44:c1d8923072ba 638 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 639 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 640 }
TMBOY 44:c1d8923072ba 641 }
TMBOY 44:c1d8923072ba 642 }
TMBOY 44:c1d8923072ba 643 ```
TMBOY 44:c1d8923072ba 644
TMBOY 44:c1d8923072ba 645 ##### DecrementBrightnessConfirmation
TMBOY 44:c1d8923072ba 646
TMBOY 44:c1d8923072ba 647 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 648 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 649
TMBOY 44:c1d8923072ba 650 **目的：**
TMBOY 44:c1d8923072ba 651 表示设备亮度调低成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 652
TMBOY 44:c1d8923072ba 653 ###### Header
TMBOY 44:c1d8923072ba 654
TMBOY 44:c1d8923072ba 655 |Property|Value|
TMBOY 44:c1d8923072ba 656 |---|---|
TMBOY 44:c1d8923072ba 657 |name| DecrementBrightnessConfirmation |
TMBOY 44:c1d8923072ba 658 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 659
TMBOY 44:c1d8923072ba 660 ###### Payload
TMBOY 44:c1d8923072ba 661
TMBOY 44:c1d8923072ba 662 |Property|Description|Required|
TMBOY 44:c1d8923072ba 663 |---|---|---|
TMBOY 44:c1d8923072ba 664 | brightness | double类型，表示亮度增加后的值。 | Yes |
TMBOY 44:c1d8923072ba 665 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 666 | previousState.brightness | double类型，表示亮度增加前的值。 | Yes |
TMBOY 44:c1d8923072ba 667
TMBOY 44:c1d8923072ba 668 DecrementBrightnessConfirmation 例子：
TMBOY 44:c1d8923072ba 669 ```
TMBOY 44:c1d8923072ba 670 {
TMBOY 44:c1d8923072ba 671 "header": {
TMBOY 44:c1d8923072ba 672 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 673 "name": "DecrementBrightnessConfirmation",
TMBOY 44:c1d8923072ba 674 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 675 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 676 },
TMBOY 44:c1d8923072ba 677 "payload": {
TMBOY 44:c1d8923072ba 678 "previousState": {
TMBOY 44:c1d8923072ba 679 "brightness": {
TMBOY 44:c1d8923072ba 680 "value": 1.0
TMBOY 44:c1d8923072ba 681 }
TMBOY 44:c1d8923072ba 682 },
TMBOY 44:c1d8923072ba 683 "brightness": {
TMBOY 44:c1d8923072ba 684 "value": 0.5
TMBOY 44:c1d8923072ba 685 }
TMBOY 44:c1d8923072ba 686 }
TMBOY 44:c1d8923072ba 687 }
TMBOY 44:c1d8923072ba 688 ```
TMBOY 44:c1d8923072ba 689
TMBOY 44:c1d8923072ba 690 #### 可控温度设备(Temperature Control Messages)
TMBOY 44:c1d8923072ba 691
TMBOY 44:c1d8923072ba 692 ##### IncrementTemperatureRequest
TMBOY 44:c1d8923072ba 693
TMBOY 44:c1d8923072ba 694 **例子：**
TMBOY 44:c1d8923072ba 695 “小度小度，把卧室的温度调高一点”
TMBOY 44:c1d8923072ba 696
TMBOY 44:c1d8923072ba 697 **目的：**
TMBOY 44:c1d8923072ba 698 DuerOS发送给Bot的调高温度的请求
TMBOY 44:c1d8923072ba 699
TMBOY 44:c1d8923072ba 700 ###### Header
TMBOY 44:c1d8923072ba 701
TMBOY 44:c1d8923072ba 702 |Property|Value|
TMBOY 44:c1d8923072ba 703 |---|---|
TMBOY 44:c1d8923072ba 704 |name|IncrementTemperatureRequest|
TMBOY 44:c1d8923072ba 705 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 706
TMBOY 44:c1d8923072ba 707 ###### Payload
TMBOY 44:c1d8923072ba 708
TMBOY 44:c1d8923072ba 709 |Property|Description|Required|
TMBOY 44:c1d8923072ba 710 |---|---|---|
TMBOY 44:c1d8923072ba 711 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 712 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 713 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 714 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 715 | deltaTemperature | 表示设备的温度变化的量的对象。包含一个属性值，它指定一个数字。 | Yes |
TMBOY 44:c1d8923072ba 716
TMBOY 44:c1d8923072ba 717 IncrementTemperatureRequest 例子：
TMBOY 44:c1d8923072ba 718 ```
TMBOY 44:c1d8923072ba 719 {
TMBOY 44:c1d8923072ba 720 "header": {
TMBOY 44:c1d8923072ba 721 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 722 "name": "IncrementTemperatureRequest",
TMBOY 44:c1d8923072ba 723 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 724 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 725 },
TMBOY 44:c1d8923072ba 726 "payload": {
TMBOY 44:c1d8923072ba 727 "deltaTemperature": {
TMBOY 44:c1d8923072ba 728 "value": 2.0
TMBOY 44:c1d8923072ba 729 },
TMBOY 44:c1d8923072ba 730 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 731 "appliance": {
TMBOY 44:c1d8923072ba 732 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 733 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 734 }
TMBOY 44:c1d8923072ba 735 }
TMBOY 44:c1d8923072ba 736 }
TMBOY 44:c1d8923072ba 737 ```
TMBOY 44:c1d8923072ba 738
TMBOY 44:c1d8923072ba 739 ##### IncrementTemperatureConfirmation
TMBOY 44:c1d8923072ba 740
TMBOY 44:c1d8923072ba 741 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 742 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 743
TMBOY 44:c1d8923072ba 744 **目的：**
TMBOY 44:c1d8923072ba 745 表示设备温度调高成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 746
TMBOY 44:c1d8923072ba 747 ###### Header
TMBOY 44:c1d8923072ba 748
TMBOY 44:c1d8923072ba 749 |Property|Value|
TMBOY 44:c1d8923072ba 750 |---|---|
TMBOY 44:c1d8923072ba 751 |name| IncrementTemperatureConfirmation |
TMBOY 44:c1d8923072ba 752 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 753
TMBOY 44:c1d8923072ba 754 ###### Payload
TMBOY 44:c1d8923072ba 755
TMBOY 44:c1d8923072ba 756 |Property|Description|Required|
TMBOY 44:c1d8923072ba 757 |---|---|---|
TMBOY 44:c1d8923072ba 758 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 759 | temperature | double类型，表示设置之后的值。 | Yes |
TMBOY 44:c1d8923072ba 760 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 761 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 762 | previousState.temperature | double类型，表示设置之前的值。 | Yes |
TMBOY 44:c1d8923072ba 763
TMBOY 44:c1d8923072ba 764 IncrementTemperatureConfirmation 例子：
TMBOY 44:c1d8923072ba 765 ```
TMBOY 44:c1d8923072ba 766 {
TMBOY 44:c1d8923072ba 767 "header": {
TMBOY 44:c1d8923072ba 768 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 769 "name": "IncrementTemperatureConfirmation",
TMBOY 44:c1d8923072ba 770 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 771 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 772 },
TMBOY 44:c1d8923072ba 773 "payload": {
TMBOY 44:c1d8923072ba 774 "previousState": {
TMBOY 44:c1d8923072ba 775 "mode": {
TMBOY 44:c1d8923072ba 776 "value": "AUTO"
TMBOY 44:c1d8923072ba 777 },
TMBOY 44:c1d8923072ba 778 "temperature": {
TMBOY 44:c1d8923072ba 779 "value": 21.0
TMBOY 44:c1d8923072ba 780 }
TMBOY 44:c1d8923072ba 781 },
TMBOY 44:c1d8923072ba 782 "temperature": {
TMBOY 44:c1d8923072ba 783 "value": 25.0
TMBOY 44:c1d8923072ba 784 },
TMBOY 44:c1d8923072ba 785 "mode": {
TMBOY 44:c1d8923072ba 786 "value": "AUTO"
TMBOY 44:c1d8923072ba 787 }
TMBOY 44:c1d8923072ba 788 }
TMBOY 44:c1d8923072ba 789 }
TMBOY 44:c1d8923072ba 790 ```
TMBOY 44:c1d8923072ba 791
TMBOY 44:c1d8923072ba 792 ##### DecrementTemperatureRequest
TMBOY 44:c1d8923072ba 793
TMBOY 44:c1d8923072ba 794 **例子：**
TMBOY 44:c1d8923072ba 795 “小度小度，把卧室的温度调低一点”
TMBOY 44:c1d8923072ba 796
TMBOY 44:c1d8923072ba 797 **目的：**
TMBOY 44:c1d8923072ba 798 DuerOS发送给Bot的调低温度的请求
TMBOY 44:c1d8923072ba 799
TMBOY 44:c1d8923072ba 800 ###### Header
TMBOY 44:c1d8923072ba 801
TMBOY 44:c1d8923072ba 802 |Property|Value|
TMBOY 44:c1d8923072ba 803 |---|---|
TMBOY 44:c1d8923072ba 804 |name|DecrementTemperatureRequest|
TMBOY 44:c1d8923072ba 805 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 806
TMBOY 44:c1d8923072ba 807 ###### Payload
TMBOY 44:c1d8923072ba 808
TMBOY 44:c1d8923072ba 809 |Property|Description|Required|
TMBOY 44:c1d8923072ba 810 |---|---|---|
TMBOY 44:c1d8923072ba 811 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 812 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 813 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 814 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 815 | deltaTemperature | 表示设备的温度变化的量的对象。包含一个属性值，它指定一个数字。 | Yes |
TMBOY 44:c1d8923072ba 816
TMBOY 44:c1d8923072ba 817 DecrementTemperatureRequest 例子：
TMBOY 44:c1d8923072ba 818 ```
TMBOY 44:c1d8923072ba 819 {
TMBOY 44:c1d8923072ba 820 "header": {
TMBOY 44:c1d8923072ba 821 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 822 "name": "DecrementTemperatureRequest",
TMBOY 44:c1d8923072ba 823 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 824 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 825 },
TMBOY 44:c1d8923072ba 826 "payload": {
TMBOY 44:c1d8923072ba 827 "deltaTemperature": {
TMBOY 44:c1d8923072ba 828 "value": 2.0
TMBOY 44:c1d8923072ba 829 },
TMBOY 44:c1d8923072ba 830 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 831 "appliance": {
TMBOY 44:c1d8923072ba 832 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 833 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 834 }
TMBOY 44:c1d8923072ba 835 }
TMBOY 44:c1d8923072ba 836 }
TMBOY 44:c1d8923072ba 837 ```
TMBOY 44:c1d8923072ba 838
TMBOY 44:c1d8923072ba 839 ##### DecrementTemperatureConfirmation
TMBOY 44:c1d8923072ba 840
TMBOY 44:c1d8923072ba 841 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 842 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 843
TMBOY 44:c1d8923072ba 844 **目的：**
TMBOY 44:c1d8923072ba 845 表示设备温度调低成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 846
TMBOY 44:c1d8923072ba 847 ###### Header
TMBOY 44:c1d8923072ba 848
TMBOY 44:c1d8923072ba 849 |Property|Value|
TMBOY 44:c1d8923072ba 850 |---|---|
TMBOY 44:c1d8923072ba 851 |name| DecrementTemperatureConfirmation |
TMBOY 44:c1d8923072ba 852 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 853
TMBOY 44:c1d8923072ba 854 ###### Payload
TMBOY 44:c1d8923072ba 855
TMBOY 44:c1d8923072ba 856 |Property|Description|Required|
TMBOY 44:c1d8923072ba 857 |---|---|---|
TMBOY 44:c1d8923072ba 858 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 859 | temperature | double类型，表示设置之后的值。 | Yes |
TMBOY 44:c1d8923072ba 860 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 861 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 862 | previousState.temperature | double类型，表示设置之前的值。 | Yes |
TMBOY 44:c1d8923072ba 863
TMBOY 44:c1d8923072ba 864 DecrementTemperatureConfirmation 例子：
TMBOY 44:c1d8923072ba 865 ```
TMBOY 44:c1d8923072ba 866 {
TMBOY 44:c1d8923072ba 867 "header": {
TMBOY 44:c1d8923072ba 868 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 869 "name": "DecrementTemperatureConfirmation",
TMBOY 44:c1d8923072ba 870 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 871 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 872 },
TMBOY 44:c1d8923072ba 873 "payload": {
TMBOY 44:c1d8923072ba 874 "previousState": {
TMBOY 44:c1d8923072ba 875 "mode": {
TMBOY 44:c1d8923072ba 876 "value": "AUTO"
TMBOY 44:c1d8923072ba 877 },
TMBOY 44:c1d8923072ba 878 "temperature": {
TMBOY 44:c1d8923072ba 879 "value": 25.0
TMBOY 44:c1d8923072ba 880 }
TMBOY 44:c1d8923072ba 881 },
TMBOY 44:c1d8923072ba 882 "temperature": {
TMBOY 44:c1d8923072ba 883 "value": 23.0
TMBOY 44:c1d8923072ba 884 },
TMBOY 44:c1d8923072ba 885 "mode": {
TMBOY 44:c1d8923072ba 886 "value": "AUTO"
TMBOY 44:c1d8923072ba 887 }
TMBOY 44:c1d8923072ba 888 }
TMBOY 44:c1d8923072ba 889 }
TMBOY 44:c1d8923072ba 890 ```
TMBOY 44:c1d8923072ba 891
TMBOY 44:c1d8923072ba 892 ##### SetTemperatureRequest
TMBOY 44:c1d8923072ba 893
TMBOY 44:c1d8923072ba 894 **例子：**
TMBOY 44:c1d8923072ba 895 “小度小度，把卧室的温度设置为20度”
TMBOY 44:c1d8923072ba 896
TMBOY 44:c1d8923072ba 897 **目的：**
TMBOY 44:c1d8923072ba 898 DuerOS发送给Bot的设置温度的请求
TMBOY 44:c1d8923072ba 899
TMBOY 44:c1d8923072ba 900 ###### Header
TMBOY 44:c1d8923072ba 901
TMBOY 44:c1d8923072ba 902 |Property|Value|
TMBOY 44:c1d8923072ba 903 |---|---|
TMBOY 44:c1d8923072ba 904 |name|SetTemperatureRequest|
TMBOY 44:c1d8923072ba 905 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 906
TMBOY 44:c1d8923072ba 907 ###### Payload
TMBOY 44:c1d8923072ba 908
TMBOY 44:c1d8923072ba 909 |Property|Description|Required|
TMBOY 44:c1d8923072ba 910 |---|---|---|
TMBOY 44:c1d8923072ba 911 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 912 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 913 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 914 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 915 | targetTemperature | 表示设备的温度设置的量的对象。包含一个属性值，它指定一个数字。 | Yes |
TMBOY 44:c1d8923072ba 916
TMBOY 44:c1d8923072ba 917 SetTemperatureRequest 例子：
TMBOY 44:c1d8923072ba 918 ```
TMBOY 44:c1d8923072ba 919 {
TMBOY 44:c1d8923072ba 920 "header": {
TMBOY 44:c1d8923072ba 921 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 922 "name": "SetTemperatureRequest",
TMBOY 44:c1d8923072ba 923 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 924 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 925 },
TMBOY 44:c1d8923072ba 926 "payload": {
TMBOY 44:c1d8923072ba 927 "targetTemperature": {
TMBOY 44:c1d8923072ba 928 "value": 2.0
TMBOY 44:c1d8923072ba 929 },
TMBOY 44:c1d8923072ba 930 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 931 "appliance": {
TMBOY 44:c1d8923072ba 932 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 933 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 934 }
TMBOY 44:c1d8923072ba 935 }
TMBOY 44:c1d8923072ba 936 }
TMBOY 44:c1d8923072ba 937 ```
TMBOY 44:c1d8923072ba 938
TMBOY 44:c1d8923072ba 939 ##### SetTemperatureConfirmation
TMBOY 44:c1d8923072ba 940
TMBOY 44:c1d8923072ba 941 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 942 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 943
TMBOY 44:c1d8923072ba 944 **目的：**
TMBOY 44:c1d8923072ba 945 表示设备温度设置成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 946
TMBOY 44:c1d8923072ba 947 ###### Header
TMBOY 44:c1d8923072ba 948
TMBOY 44:c1d8923072ba 949 |Property|Value|
TMBOY 44:c1d8923072ba 950 |---|---|
TMBOY 44:c1d8923072ba 951 |name| SetTemperatureConfirmation |
TMBOY 44:c1d8923072ba 952 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 953
TMBOY 44:c1d8923072ba 954 ###### Payload
TMBOY 44:c1d8923072ba 955
TMBOY 44:c1d8923072ba 956 |Property|Description|Required|
TMBOY 44:c1d8923072ba 957 |---|---|---|
TMBOY 44:c1d8923072ba 958 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 959 | temperature | double类型，表示设置之后的值。 | Yes |
TMBOY 44:c1d8923072ba 960 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 961 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 962 | previousState.temperature | double类型，表示设置之前的值。 | Yes |
TMBOY 44:c1d8923072ba 963
TMBOY 44:c1d8923072ba 964 SetTemperatureConfirmation 例子：
TMBOY 44:c1d8923072ba 965 ```
TMBOY 44:c1d8923072ba 966 {
TMBOY 44:c1d8923072ba 967 "header": {
TMBOY 44:c1d8923072ba 968 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 969 "name": "SetTemperatureConfirmation",
TMBOY 44:c1d8923072ba 970 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 971 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 972 },
TMBOY 44:c1d8923072ba 973 "payload": {
TMBOY 44:c1d8923072ba 974 "previousState": {
TMBOY 44:c1d8923072ba 975 "mode": {
TMBOY 44:c1d8923072ba 976 "value": "AUTO"
TMBOY 44:c1d8923072ba 977 },
TMBOY 44:c1d8923072ba 978 "temperature": {
TMBOY 44:c1d8923072ba 979 "value": 25.0
TMBOY 44:c1d8923072ba 980 }
TMBOY 44:c1d8923072ba 981 },
TMBOY 44:c1d8923072ba 982 "temperature": {
TMBOY 44:c1d8923072ba 983 "value": 23.0
TMBOY 44:c1d8923072ba 984 },
TMBOY 44:c1d8923072ba 985 "mode": {
TMBOY 44:c1d8923072ba 986 "value": "AUTO"
TMBOY 44:c1d8923072ba 987 }
TMBOY 44:c1d8923072ba 988 }
TMBOY 44:c1d8923072ba 989 }
TMBOY 44:c1d8923072ba 990 ```
TMBOY 44:c1d8923072ba 991
TMBOY 44:c1d8923072ba 992 #### 可控风速设备(Fan Speed Control Messages)
TMBOY 44:c1d8923072ba 993
TMBOY 44:c1d8923072ba 994 ##### IncrementFanSpeedRequest
TMBOY 44:c1d8923072ba 995
TMBOY 44:c1d8923072ba 996 **例子：**
TMBOY 44:c1d8923072ba 997 “小度小度，把空调的风速增加一点”
TMBOY 44:c1d8923072ba 998
TMBOY 44:c1d8923072ba 999 **目的：**
TMBOY 44:c1d8923072ba 1000 DuerOS发送给Bot的调高风速的请求
TMBOY 44:c1d8923072ba 1001
TMBOY 44:c1d8923072ba 1002 ###### Header
TMBOY 44:c1d8923072ba 1003
TMBOY 44:c1d8923072ba 1004 |Property|Value|
TMBOY 44:c1d8923072ba 1005 |---|---|
TMBOY 44:c1d8923072ba 1006 |name|IncrementFanSpeedRequest|
TMBOY 44:c1d8923072ba 1007 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1008
TMBOY 44:c1d8923072ba 1009 ###### Payload
TMBOY 44:c1d8923072ba 1010
TMBOY 44:c1d8923072ba 1011 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1012 |---|---|---|
TMBOY 44:c1d8923072ba 1013 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 1014 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 1015 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1016 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 1017 | deltaFanSpeed | 表示设备的风速变化的量的对象。包含一个属性值，它指定一个double类型的数字，表示设备风速调整的值，其有效范围为0.0000至1.0000。 | Yes |
TMBOY 44:c1d8923072ba 1018
TMBOY 44:c1d8923072ba 1019 IncrementFanSpeedRequest 例子：
TMBOY 44:c1d8923072ba 1020 ```
TMBOY 44:c1d8923072ba 1021 {
TMBOY 44:c1d8923072ba 1022 "header": {
TMBOY 44:c1d8923072ba 1023 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 1024 "name": "IncrementFanSpeedRequest",
TMBOY 44:c1d8923072ba 1025 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1026 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1027 },
TMBOY 44:c1d8923072ba 1028 "payload": {
TMBOY 44:c1d8923072ba 1029 "deltaFanSpeed": {
TMBOY 44:c1d8923072ba 1030 "value": 0.5
TMBOY 44:c1d8923072ba 1031 },
TMBOY 44:c1d8923072ba 1032 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 1033 "appliance": {
TMBOY 44:c1d8923072ba 1034 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 1035 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 1036 }
TMBOY 44:c1d8923072ba 1037 }
TMBOY 44:c1d8923072ba 1038 }
TMBOY 44:c1d8923072ba 1039 ```
TMBOY 44:c1d8923072ba 1040
TMBOY 44:c1d8923072ba 1041 ##### IncrementFanSpeedConfirmation
TMBOY 44:c1d8923072ba 1042
TMBOY 44:c1d8923072ba 1043 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 1044 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 1045
TMBOY 44:c1d8923072ba 1046 **目的：**
TMBOY 44:c1d8923072ba 1047 表示设备风速调高成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 1048
TMBOY 44:c1d8923072ba 1049 ###### Header
TMBOY 44:c1d8923072ba 1050
TMBOY 44:c1d8923072ba 1051 |Property|Value|
TMBOY 44:c1d8923072ba 1052 |---|---|
TMBOY 44:c1d8923072ba 1053 |name| IncrementFanSpeedConfirmation |
TMBOY 44:c1d8923072ba 1054 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1055
TMBOY 44:c1d8923072ba 1056 ###### Payload
TMBOY 44:c1d8923072ba 1057
TMBOY 44:c1d8923072ba 1058 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1059 |---|---|---|
TMBOY 44:c1d8923072ba 1060 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1061 | fanSpeed | double类型，表示设置之后的值。 | Yes |
TMBOY 44:c1d8923072ba 1062 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 1063 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1064 | previousState.fanSpeed | double类型，表示设置之前的值。 | Yes |
TMBOY 44:c1d8923072ba 1065
TMBOY 44:c1d8923072ba 1066 IncrementFanSpeedConfirmation 例子：
TMBOY 44:c1d8923072ba 1067 ```
TMBOY 44:c1d8923072ba 1068 {
TMBOY 44:c1d8923072ba 1069 "header": {
TMBOY 44:c1d8923072ba 1070 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 1071 "name": "IncrementFanSpeedConfirmation",
TMBOY 44:c1d8923072ba 1072 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1073 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1074 },
TMBOY 44:c1d8923072ba 1075 "payload": {
TMBOY 44:c1d8923072ba 1076 "previousState": {
TMBOY 44:c1d8923072ba 1077 "mode": {
TMBOY 44:c1d8923072ba 1078 "value": "AUTO"
TMBOY 44:c1d8923072ba 1079 },
TMBOY 44:c1d8923072ba 1080 "fanSpeed": {
TMBOY 44:c1d8923072ba 1081 "value": 0.5
TMBOY 44:c1d8923072ba 1082 }
TMBOY 44:c1d8923072ba 1083 },
TMBOY 44:c1d8923072ba 1084 "fanSpeed": {
TMBOY 44:c1d8923072ba 1085 "value": 1.0
TMBOY 44:c1d8923072ba 1086 },
TMBOY 44:c1d8923072ba 1087 "mode": {
TMBOY 44:c1d8923072ba 1088 "value": "AUTO"
TMBOY 44:c1d8923072ba 1089 }
TMBOY 44:c1d8923072ba 1090 }
TMBOY 44:c1d8923072ba 1091 }
TMBOY 44:c1d8923072ba 1092 ```
TMBOY 44:c1d8923072ba 1093
TMBOY 44:c1d8923072ba 1094 ##### DecrementFanSpeedRequest
TMBOY 44:c1d8923072ba 1095
TMBOY 44:c1d8923072ba 1096 **例子：**
TMBOY 44:c1d8923072ba 1097 “小度小度，把空调的风速降低一点”
TMBOY 44:c1d8923072ba 1098
TMBOY 44:c1d8923072ba 1099 **目的：**
TMBOY 44:c1d8923072ba 1100 DuerOS发送给Bot的调低风速的请求
TMBOY 44:c1d8923072ba 1101
TMBOY 44:c1d8923072ba 1102 ###### Header
TMBOY 44:c1d8923072ba 1103
TMBOY 44:c1d8923072ba 1104 |Property|Value|
TMBOY 44:c1d8923072ba 1105 |---|---|
TMBOY 44:c1d8923072ba 1106 |name|DecrementFanSpeedRequest|
TMBOY 44:c1d8923072ba 1107 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1108
TMBOY 44:c1d8923072ba 1109 ###### Payload
TMBOY 44:c1d8923072ba 1110
TMBOY 44:c1d8923072ba 1111 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1112 |---|---|---|
TMBOY 44:c1d8923072ba 1113 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 1114 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 1115 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1116 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 1117 | deltaFanSpeed | 表示设备的风速变化的量的对象。包含一个属性值，它指定一个double类型的数字，表示设备风速调整的值，其有效范围为0.0000至1.0000。 | Yes |
TMBOY 44:c1d8923072ba 1118
TMBOY 44:c1d8923072ba 1119 DecrementFanSpeedRequest 例子：
TMBOY 44:c1d8923072ba 1120 ```
TMBOY 44:c1d8923072ba 1121 {
TMBOY 44:c1d8923072ba 1122 "header": {
TMBOY 44:c1d8923072ba 1123 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 1124 "name": "DecrementFanSpeedRequest",
TMBOY 44:c1d8923072ba 1125 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1126 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1127 },
TMBOY 44:c1d8923072ba 1128 "payload": {
TMBOY 44:c1d8923072ba 1129 "deltaFanSpeed": {
TMBOY 44:c1d8923072ba 1130 "value": 0.5
TMBOY 44:c1d8923072ba 1131 },
TMBOY 44:c1d8923072ba 1132 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 1133 "appliance": {
TMBOY 44:c1d8923072ba 1134 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 1135 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 1136 }
TMBOY 44:c1d8923072ba 1137 }
TMBOY 44:c1d8923072ba 1138 }
TMBOY 44:c1d8923072ba 1139 ```
TMBOY 44:c1d8923072ba 1140
TMBOY 44:c1d8923072ba 1141 ##### DecrementFanSpeedConfirmation
TMBOY 44:c1d8923072ba 1142
TMBOY 44:c1d8923072ba 1143 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 1144 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 1145
TMBOY 44:c1d8923072ba 1146 **目的：**
TMBOY 44:c1d8923072ba 1147 表示设备风速调低成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 1148
TMBOY 44:c1d8923072ba 1149 ###### Header
TMBOY 44:c1d8923072ba 1150
TMBOY 44:c1d8923072ba 1151 |Property|Value|
TMBOY 44:c1d8923072ba 1152 |---|---|
TMBOY 44:c1d8923072ba 1153 |name| DecrementFanSpeedConfirmation |
TMBOY 44:c1d8923072ba 1154 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1155
TMBOY 44:c1d8923072ba 1156 ###### Payload
TMBOY 44:c1d8923072ba 1157
TMBOY 44:c1d8923072ba 1158 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1159 |---|---|---|
TMBOY 44:c1d8923072ba 1160 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1161 | fanSpeed | double类型，表示设置之后的值。 | Yes |
TMBOY 44:c1d8923072ba 1162 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 1163 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1164 | previousState.fanSpeed | double类型，表示设置之前的值。 | Yes |
TMBOY 44:c1d8923072ba 1165
TMBOY 44:c1d8923072ba 1166 DecrementFanSpeedConfirmation 例子：
TMBOY 44:c1d8923072ba 1167 ```
TMBOY 44:c1d8923072ba 1168 {
TMBOY 44:c1d8923072ba 1169 "header": {
TMBOY 44:c1d8923072ba 1170 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 1171 "name": "DecrementFanSpeedConfirmation",
TMBOY 44:c1d8923072ba 1172 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1173 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1174 },
TMBOY 44:c1d8923072ba 1175 "payload": {
TMBOY 44:c1d8923072ba 1176 "previousState": {
TMBOY 44:c1d8923072ba 1177 "mode": {
TMBOY 44:c1d8923072ba 1178 "value": "AUTO"
TMBOY 44:c1d8923072ba 1179 },
TMBOY 44:c1d8923072ba 1180 "fanSpeed": {
TMBOY 44:c1d8923072ba 1181 "value": 1.0
TMBOY 44:c1d8923072ba 1182 }
TMBOY 44:c1d8923072ba 1183 },
TMBOY 44:c1d8923072ba 1184 "fanSpeed": {
TMBOY 44:c1d8923072ba 1185 "value": 0.5
TMBOY 44:c1d8923072ba 1186 },
TMBOY 44:c1d8923072ba 1187 "mode": {
TMBOY 44:c1d8923072ba 1188 "value": "AUTO"
TMBOY 44:c1d8923072ba 1189 }
TMBOY 44:c1d8923072ba 1190 }
TMBOY 44:c1d8923072ba 1191 }
TMBOY 44:c1d8923072ba 1192 ```
TMBOY 44:c1d8923072ba 1193
TMBOY 44:c1d8923072ba 1194 ##### SetModeRequest
TMBOY 44:c1d8923072ba 1195
TMBOY 44:c1d8923072ba 1196 **例子：**
TMBOY 44:c1d8923072ba 1197 “小度小度，把空调的模式调整为制冷”
TMBOY 44:c1d8923072ba 1198
TMBOY 44:c1d8923072ba 1199 **目的：**
TMBOY 44:c1d8923072ba 1200 DuerOS发送给Bot的设置模式的请求
TMBOY 44:c1d8923072ba 1201
TMBOY 44:c1d8923072ba 1202 ###### Header
TMBOY 44:c1d8923072ba 1203
TMBOY 44:c1d8923072ba 1204 |Property|Value|
TMBOY 44:c1d8923072ba 1205 |---|---|
TMBOY 44:c1d8923072ba 1206 |name|SetModeRequest|
TMBOY 44:c1d8923072ba 1207 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1208
TMBOY 44:c1d8923072ba 1209 ###### Payload
TMBOY 44:c1d8923072ba 1210
TMBOY 44:c1d8923072ba 1211 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1212 |---|---|---|
TMBOY 44:c1d8923072ba 1213 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 1214 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 1215 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1216 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 1217 | mode | 表示设备的模式设置的量的对象。包含一个属性值，它指定一种模式。 | Yes |
TMBOY 44:c1d8923072ba 1218
TMBOY 44:c1d8923072ba 1219 SetModeRequest 例子：
TMBOY 44:c1d8923072ba 1220 ```
TMBOY 44:c1d8923072ba 1221 {
TMBOY 44:c1d8923072ba 1222 "header": {
TMBOY 44:c1d8923072ba 1223 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 1224 "name": "SetModeRequest",
TMBOY 44:c1d8923072ba 1225 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1226 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1227 },
TMBOY 44:c1d8923072ba 1228 "payload": {
TMBOY 44:c1d8923072ba 1229 "mode": {
TMBOY 44:c1d8923072ba 1230 "value": "AUTO"
TMBOY 44:c1d8923072ba 1231 },
TMBOY 44:c1d8923072ba 1232 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 1233 "appliance": {
TMBOY 44:c1d8923072ba 1234 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 1235 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 1236 }
TMBOY 44:c1d8923072ba 1237 }
TMBOY 44:c1d8923072ba 1238 }
TMBOY 44:c1d8923072ba 1239 ```
TMBOY 44:c1d8923072ba 1240
TMBOY 44:c1d8923072ba 1241 ##### SetModeConfirmation
TMBOY 44:c1d8923072ba 1242
TMBOY 44:c1d8923072ba 1243 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 1244 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 1245
TMBOY 44:c1d8923072ba 1246 **目的：**
TMBOY 44:c1d8923072ba 1247 表示设备模式设置成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 1248
TMBOY 44:c1d8923072ba 1249 ###### Header
TMBOY 44:c1d8923072ba 1250
TMBOY 44:c1d8923072ba 1251 |Property|Value|
TMBOY 44:c1d8923072ba 1252 |---|---|
TMBOY 44:c1d8923072ba 1253 |name| SetModeConfirmation |
TMBOY 44:c1d8923072ba 1254 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1255
TMBOY 44:c1d8923072ba 1256 ###### Payload
TMBOY 44:c1d8923072ba 1257
TMBOY 44:c1d8923072ba 1258 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1259 |---|---|---|
TMBOY 44:c1d8923072ba 1260 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1261 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 1262 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1263
TMBOY 44:c1d8923072ba 1264 SetModeConfirmation 例子：
TMBOY 44:c1d8923072ba 1265 ```
TMBOY 44:c1d8923072ba 1266 {
TMBOY 44:c1d8923072ba 1267 "header": {
TMBOY 44:c1d8923072ba 1268 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 1269 "name": "SetModeConfirmation",
TMBOY 44:c1d8923072ba 1270 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1271 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1272 },
TMBOY 44:c1d8923072ba 1273 "payload": {
TMBOY 44:c1d8923072ba 1274 "previousState": {
TMBOY 44:c1d8923072ba 1275 "mode": {
TMBOY 44:c1d8923072ba 1276 "value": "COOL"
TMBOY 44:c1d8923072ba 1277 }
TMBOY 44:c1d8923072ba 1278 },
TMBOY 44:c1d8923072ba 1279 "mode": {
TMBOY 44:c1d8923072ba 1280 "value": "AUTO"
TMBOY 44:c1d8923072ba 1281 }
TMBOY 44:c1d8923072ba 1282 }
TMBOY 44:c1d8923072ba 1283 }
TMBOY 44:c1d8923072ba 1284 ```
TMBOY 44:c1d8923072ba 1285
TMBOY 44:c1d8923072ba 1286 ##### TimingSetModeRequest
TMBOY 44:c1d8923072ba 1287
TMBOY 44:c1d8923072ba 1288 **例子：**
TMBOY 44:c1d8923072ba 1289 “小度小度，1分钟后把空调的模式调整为制冷”
TMBOY 44:c1d8923072ba 1290
TMBOY 44:c1d8923072ba 1291 **目的：**
TMBOY 44:c1d8923072ba 1292 DuerOS发送给Bot的设置模式的请求
TMBOY 44:c1d8923072ba 1293
TMBOY 44:c1d8923072ba 1294 ###### Header
TMBOY 44:c1d8923072ba 1295
TMBOY 44:c1d8923072ba 1296 |Property|Value|
TMBOY 44:c1d8923072ba 1297 |---|---|
TMBOY 44:c1d8923072ba 1298 |name|TimingSetModeRequest|
TMBOY 44:c1d8923072ba 1299 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1300
TMBOY 44:c1d8923072ba 1301 ###### Payload
TMBOY 44:c1d8923072ba 1302
TMBOY 44:c1d8923072ba 1303 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1304 |---|---|---|
TMBOY 44:c1d8923072ba 1305 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 1306 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 1307 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1308 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 1309 | mode | 表示设备的模式设置的量的对象。包含一个属性值，它指定一种模式。 | Yes |
TMBOY 44:c1d8923072ba 1310 | timestamp | 表示设备定时设置的量的对象。包含一个属性值，它指定一个数字，代表时间戳。 | Yes |
TMBOY 44:c1d8923072ba 1311
TMBOY 44:c1d8923072ba 1312 TimingSetModeRequest 例子：
TMBOY 44:c1d8923072ba 1313 ```
TMBOY 44:c1d8923072ba 1314 {
TMBOY 44:c1d8923072ba 1315 "header": {
TMBOY 44:c1d8923072ba 1316 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 1317 "name": "TimingSetModeRequest",
TMBOY 44:c1d8923072ba 1318 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1319 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1320 },
TMBOY 44:c1d8923072ba 1321 "payload": {
TMBOY 44:c1d8923072ba 1322 "mode": {
TMBOY 44:c1d8923072ba 1323 "value": "AUTO"
TMBOY 44:c1d8923072ba 1324 },
TMBOY 44:c1d8923072ba 1325 "timestamp": {
TMBOY 44:c1d8923072ba 1326 "value": 2.0
TMBOY 44:c1d8923072ba 1327 },
TMBOY 44:c1d8923072ba 1328 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 1329 "appliance": {
TMBOY 44:c1d8923072ba 1330 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 1331 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 1332 }
TMBOY 44:c1d8923072ba 1333 }
TMBOY 44:c1d8923072ba 1334 }
TMBOY 44:c1d8923072ba 1335 ```
TMBOY 44:c1d8923072ba 1336
TMBOY 44:c1d8923072ba 1337 ##### TimingSetModeConfirmation
TMBOY 44:c1d8923072ba 1338
TMBOY 44:c1d8923072ba 1339 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 1340 “*设备name*已设置成功”
TMBOY 44:c1d8923072ba 1341
TMBOY 44:c1d8923072ba 1342 **目的：**
TMBOY 44:c1d8923072ba 1343 表示设备模式设置成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 1344
TMBOY 44:c1d8923072ba 1345 ###### Header
TMBOY 44:c1d8923072ba 1346
TMBOY 44:c1d8923072ba 1347 |Property|Value|
TMBOY 44:c1d8923072ba 1348 |---|---|
TMBOY 44:c1d8923072ba 1349 |name| TimingSetModeConfirmation |
TMBOY 44:c1d8923072ba 1350 |namespace|DuerOS.ConnectedHome.Control|
TMBOY 44:c1d8923072ba 1351
TMBOY 44:c1d8923072ba 1352 ###### Payload
TMBOY 44:c1d8923072ba 1353
TMBOY 44:c1d8923072ba 1354 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1355 |---|---|---|
TMBOY 44:c1d8923072ba 1356 | mode | 表示设置之后的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1357 | previousState object | 表示亮度变化之前的对象 | Yes |
TMBOY 44:c1d8923072ba 1358 | previousState.mode | 表示设置之前的设备模式。 | Yes |
TMBOY 44:c1d8923072ba 1359
TMBOY 44:c1d8923072ba 1360 TimingSetModeConfirmation 例子：
TMBOY 44:c1d8923072ba 1361 ```
TMBOY 44:c1d8923072ba 1362 {
TMBOY 44:c1d8923072ba 1363 "header": {
TMBOY 44:c1d8923072ba 1364 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 1365 "name": "TimingSetModeConfirmation",
TMBOY 44:c1d8923072ba 1366 "namespace": "DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1367 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1368 },
TMBOY 44:c1d8923072ba 1369 "payload": {
TMBOY 44:c1d8923072ba 1370 "previousState": {
TMBOY 44:c1d8923072ba 1371 "mode": {
TMBOY 44:c1d8923072ba 1372 "value": "COOL"
TMBOY 44:c1d8923072ba 1373 }
TMBOY 44:c1d8923072ba 1374 },
TMBOY 44:c1d8923072ba 1375 "mode": {
TMBOY 44:c1d8923072ba 1376 "value": "AUTO"
TMBOY 44:c1d8923072ba 1377 }
TMBOY 44:c1d8923072ba 1378 }
TMBOY 44:c1d8923072ba 1379 }
TMBOY 44:c1d8923072ba 1380 ```
TMBOY 44:c1d8923072ba 1381
TMBOY 44:c1d8923072ba 1382 ### 查询状态(Query Message)
TMBOY 44:c1d8923072ba 1383
TMBOY 44:c1d8923072ba 1384 #### 查询空气质量
TMBOY 44:c1d8923072ba 1385
TMBOY 44:c1d8923072ba 1386 ##### GetAirPM25Request
TMBOY 44:c1d8923072ba 1387
TMBOY 44:c1d8923072ba 1388 **例子：**
TMBOY 44:c1d8923072ba 1389 “小度小度，查一下卧室pm2.5”
TMBOY 44:c1d8923072ba 1390
TMBOY 44:c1d8923072ba 1391 **目的：**
TMBOY 44:c1d8923072ba 1392 DuerOS发送给Bot的设置模式的请求
TMBOY 44:c1d8923072ba 1393
TMBOY 44:c1d8923072ba 1394 ###### Header
TMBOY 44:c1d8923072ba 1395
TMBOY 44:c1d8923072ba 1396 |Property|Value|
TMBOY 44:c1d8923072ba 1397 |---|---|
TMBOY 44:c1d8923072ba 1398 |name|GetAirPM25Request|
TMBOY 44:c1d8923072ba 1399 |namespace|DuerOS.ConnectedHome.Query|
TMBOY 44:c1d8923072ba 1400
TMBOY 44:c1d8923072ba 1401 ###### Payload
TMBOY 44:c1d8923072ba 1402
TMBOY 44:c1d8923072ba 1403 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1404 |---|---|---|
TMBOY 44:c1d8923072ba 1405 | accessToken | 从设备云端取到的access token | Yes |
TMBOY 44:c1d8923072ba 1406 | appliance object | 表示具体操作指令 | Yes |
TMBOY 44:c1d8923072ba 1407 | appliance.applianceId | 设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - =＃; ：？ @＆。标识符不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1408 | appliance.additionalApplianceDetails | 提供给Bot使用的设备或场景相关的附加信息的键值对。该属性的内容不能超过5000字节。而且DuerOS也不了解或使用这些数据。 | Yes，但可以为空 |
TMBOY 44:c1d8923072ba 1409
TMBOY 44:c1d8923072ba 1410 GetAirPM25Request 例子：
TMBOY 44:c1d8923072ba 1411 ```
TMBOY 44:c1d8923072ba 1412 {
TMBOY 44:c1d8923072ba 1413 "header": {
TMBOY 44:c1d8923072ba 1414 "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
TMBOY 44:c1d8923072ba 1415 "name": "GetAirPM25Request",
TMBOY 44:c1d8923072ba 1416 "namespace": "DuerOS.ConnectedHome.Query",
TMBOY 44:c1d8923072ba 1417 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1418 },
TMBOY 44:c1d8923072ba 1419 "payload": {
TMBOY 44:c1d8923072ba 1420 "accessToken": "[OAuth token here]",
TMBOY 44:c1d8923072ba 1421 "appliance": {
TMBOY 44:c1d8923072ba 1422 "additionalApplianceDetails": {},
TMBOY 44:c1d8923072ba 1423 "applianceId": "[Device ID for Ceiling Fan]",
TMBOY 44:c1d8923072ba 1424 }
TMBOY 44:c1d8923072ba 1425 }
TMBOY 44:c1d8923072ba 1426 }
TMBOY 44:c1d8923072ba 1427 ```
TMBOY 44:c1d8923072ba 1428
TMBOY 44:c1d8923072ba 1429 ##### GetAirPM25Confirmation
TMBOY 44:c1d8923072ba 1430
TMBOY 44:c1d8923072ba 1431 **度秘返回的结果例子：**
TMBOY 44:c1d8923072ba 1432 “当前卧室pm2.5为100”
TMBOY 44:c1d8923072ba 1433
TMBOY 44:c1d8923072ba 1434 **目的：**
TMBOY 44:c1d8923072ba 1435 表示设备查询结果成功。表示Bot返回给DuerOS的成功的结果
TMBOY 44:c1d8923072ba 1436
TMBOY 44:c1d8923072ba 1437 ###### Header
TMBOY 44:c1d8923072ba 1438
TMBOY 44:c1d8923072ba 1439 |Property|Value|
TMBOY 44:c1d8923072ba 1440 |---|---|
TMBOY 44:c1d8923072ba 1441 |name| GetAirPM25Confirmation |
TMBOY 44:c1d8923072ba 1442 |namespace| DuerOS.ConnectedHome.Query |
TMBOY 44:c1d8923072ba 1443
TMBOY 44:c1d8923072ba 1444 ###### Payload
TMBOY 44:c1d8923072ba 1445
TMBOY 44:c1d8923072ba 1446 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1447 |---|---|---|
TMBOY 44:c1d8923072ba 1448 | PM25 | 表示当前PM2.5的数值。 | Yes |
TMBOY 44:c1d8923072ba 1449
TMBOY 44:c1d8923072ba 1450 GetAirPM25Confirmation 例子：
TMBOY 44:c1d8923072ba 1451 ```
TMBOY 44:c1d8923072ba 1452 {
TMBOY 44:c1d8923072ba 1453 "header": {
TMBOY 44:c1d8923072ba 1454 "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
TMBOY 44:c1d8923072ba 1455 "name": "GetAirPM25Confirmation",
TMBOY 44:c1d8923072ba 1456 "namespace": "DuerOS.ConnectedHome.Query",
TMBOY 44:c1d8923072ba 1457 "payloadVersion": "1"
TMBOY 44:c1d8923072ba 1458 },
TMBOY 44:c1d8923072ba 1459 "payload": {
TMBOY 44:c1d8923072ba 1460 "PM25": {
TMBOY 44:c1d8923072ba 1461 "value": 100
TMBOY 44:c1d8923072ba 1462 }
TMBOY 44:c1d8923072ba 1463 }
TMBOY 44:c1d8923072ba 1464 }
TMBOY 44:c1d8923072ba 1465 ```
TMBOY 44:c1d8923072ba 1466
TMBOY 44:c1d8923072ba 1467 ### 错误消息(Error Message)
TMBOY 44:c1d8923072ba 1468
TMBOY 44:c1d8923072ba 1469 当 DuerOS 向 Bot 发送控制请求时，可能会出现不同种类的错误，如果需要，Bot应返回相应的错误类型和信息。Bot不需要返回每个错误类型，仅返回错误对应的故障类型。本节中列出了错误类型和详细信息。除非另有说明，否则错误消息不适用于设备发现，并且不应返回错误消息作为对DiscoverAppliancesRequest的响应。
TMBOY 44:c1d8923072ba 1470
TMBOY 44:c1d8923072ba 1471 用户故障：由于用户错误操作，请求可能会无效，会发生以下这些错误。 例如，用户要求将空调设置为1000度。
TMBOY 44:c1d8923072ba 1472 * ValueOutOfRangeError
TMBOY 44:c1d8923072ba 1473 * TargetOfflineError
TMBOY 44:c1d8923072ba 1474 * NoSuchTargetError
TMBOY 44:c1d8923072ba 1475 * BridgeOfflineError
TMBOY 44:c1d8923072ba 1476
TMBOY 44:c1d8923072ba 1477 Bot故障：当请求有效时，由于硬件问题或限制，也可能会出现以下这些错误，Bot无法完成所需的任务。
TMBOY 44:c1d8923072ba 1478 * DriverInternalError
TMBOY 44:c1d8923072ba 1479 * DependentServiceUnavailableError
TMBOY 44:c1d8923072ba 1480 * NotSupportedInCurrentModeError
TMBOY 44:c1d8923072ba 1481 * RateLimitExceededError
TMBOY 44:c1d8923072ba 1482 * TargetBridgeConnectivityUnstableError
TMBOY 44:c1d8923072ba 1483 * TargetFirmwareOutdatedError
TMBOY 44:c1d8923072ba 1484 * TargetBridgeFirmwareOutdatedError
TMBOY 44:c1d8923072ba 1485 * TargetHardwareMalfunctionError
TMBOY 44:c1d8923072ba 1486 * TargetBridgeHardwareMalfunctionError
TMBOY 44:c1d8923072ba 1487 * TargetConnectivityUnstableError
TMBOY 44:c1d8923072ba 1488 * TargetHardwareMalfunctionError
TMBOY 44:c1d8923072ba 1489 * UnableToGetValueError
TMBOY 44:c1d8923072ba 1490 * UnableToSetValueError
TMBOY 44:c1d8923072ba 1491 * UnwillingToSetValueError
TMBOY 44:c1d8923072ba 1492
TMBOY 44:c1d8923072ba 1493 其他故障：当请求中的数据内容无法满足时，会发生这些错误; 认证令牌无效，或技能适配器无法满足请求的其他方面。
TMBOY 44:c1d8923072ba 1494 * ExpiredAccessTokenError
TMBOY 44:c1d8923072ba 1495 * InvalidAccessTokenError
TMBOY 44:c1d8923072ba 1496 * UnsupportedTargetError
TMBOY 44:c1d8923072ba 1497 * UnsupportedOperationError
TMBOY 44:c1d8923072ba 1498 * UnsupportedTargetSettingError
TMBOY 44:c1d8923072ba 1499 * UnexpectedInformationReceivedError
TMBOY 44:c1d8923072ba 1500
TMBOY 44:c1d8923072ba 1501 #### 用户故障(User Faults)
TMBOY 44:c1d8923072ba 1502 当用户给出不正确的指示或度秘不能完成的指令时，会发生以下错误。
TMBOY 44:c1d8923072ba 1503
TMBOY 44:c1d8923072ba 1504 ##### ValueOutOfRangeError
TMBOY 44:c1d8923072ba 1505 目的：表示用户请求将目标值设置为超出其支持范围的值。 例如，用户说：“小度小度，将厨房设置为1000度”。
TMBOY 44:c1d8923072ba 1506
TMBOY 44:c1d8923072ba 1507 ###### Payload
TMBOY 44:c1d8923072ba 1508
TMBOY 44:c1d8923072ba 1509 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1510 |---|---|---|
TMBOY 44:c1d8923072ba 1511 | minimumValue | 64位双精度值，表示目标设备设置允许的最低值。 | Yes |
TMBOY 44:c1d8923072ba 1512 | maximumValue | 64位双精度值，表示目标设备设置允许的最高值。 | Yes |
TMBOY 44:c1d8923072ba 1513
TMBOY 44:c1d8923072ba 1514 ValueOutOfRangeError 例子：
TMBOY 44:c1d8923072ba 1515 ```
TMBOY 44:c1d8923072ba 1516 {
TMBOY 44:c1d8923072ba 1517 "header":{
TMBOY 44:c1d8923072ba 1518 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1519 "name":" ValueOutOfRangeError",
TMBOY 44:c1d8923072ba 1520 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1521 "messageId":"697fe957-c842-4545-a159-8a8c75fbe5bd"
TMBOY 44:c1d8923072ba 1522 },
TMBOY 44:c1d8923072ba 1523 "payload":{
TMBOY 44:c1d8923072ba 1524 "minimumValue":15.0,
TMBOY 44:c1d8923072ba 1525 "maximumValue":30.0
TMBOY 44:c1d8923072ba 1526 }
TMBOY 44:c1d8923072ba 1527 }
TMBOY 44:c1d8923072ba 1528 ```
TMBOY 44:c1d8923072ba 1529
TMBOY 44:c1d8923072ba 1530 ##### TargetOfflineError
TMBOY 44:c1d8923072ba 1531 目的：表示目标设备未连接到用户的设备云或设备云不在线。
TMBOY 44:c1d8923072ba 1532
TMBOY 44:c1d8923072ba 1533 ###### Payload
TMBOY 44:c1d8923072ba 1534
TMBOY 44:c1d8923072ba 1535 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1536 |---|---|---|
TMBOY 44:c1d8923072ba 1537 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1538
TMBOY 44:c1d8923072ba 1539 TargetOfflineError 例子：
TMBOY 44:c1d8923072ba 1540 ```
TMBOY 44:c1d8923072ba 1541 {
TMBOY 44:c1d8923072ba 1542 "header":{
TMBOY 44:c1d8923072ba 1543 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1544 "name":"TargetOfflineError",
TMBOY 44:c1d8923072ba 1545 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1546 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1547 },
TMBOY 44:c1d8923072ba 1548 "payload":{
TMBOY 44:c1d8923072ba 1549 }
TMBOY 44:c1d8923072ba 1550 }
TMBOY 44:c1d8923072ba 1551 ```
TMBOY 44:c1d8923072ba 1552
TMBOY 44:c1d8923072ba 1553 ##### BridgeOfflineError
TMBOY 44:c1d8923072ba 1554 目的：指示目标设备连接到已关闭电源。
TMBOY 44:c1d8923072ba 1555
TMBOY 44:c1d8923072ba 1556 ###### Payload
TMBOY 44:c1d8923072ba 1557
TMBOY 44:c1d8923072ba 1558 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1559 |---|---|---|
TMBOY 44:c1d8923072ba 1560 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1561
TMBOY 44:c1d8923072ba 1562 BridgeOfflineError 例子：
TMBOY 44:c1d8923072ba 1563 ```
TMBOY 44:c1d8923072ba 1564 {
TMBOY 44:c1d8923072ba 1565 "header":{
TMBOY 44:c1d8923072ba 1566 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1567 "name":"BridgeOfflineError",
TMBOY 44:c1d8923072ba 1568 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1569 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1570 },
TMBOY 44:c1d8923072ba 1571 "payload":{
TMBOY 44:c1d8923072ba 1572 }
TMBOY 44:c1d8923072ba 1573 }
TMBOY 44:c1d8923072ba 1574 ```
TMBOY 44:c1d8923072ba 1575
TMBOY 44:c1d8923072ba 1576 #### Bot故障(Bot Faults)
TMBOY 44:c1d8923072ba 1577 当Bot与设备云交互出现问题时，会发生以下错误。在这些情况下，用户请求有效，但由于某种原因无法完成。
TMBOY 44:c1d8923072ba 1578
TMBOY 44:c1d8923072ba 1579 ##### DriverInternalError
TMBOY 44:c1d8923072ba 1580 目的：指示Bot内的通用运行时错误。如果可能，应该返回一个更具体的错误。
TMBOY 44:c1d8923072ba 1581
TMBOY 44:c1d8923072ba 1582 ###### Payload
TMBOY 44:c1d8923072ba 1583
TMBOY 44:c1d8923072ba 1584 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1585 |---|---|---|
TMBOY 44:c1d8923072ba 1586 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1587
TMBOY 44:c1d8923072ba 1588 DriverInternalError 例子：
TMBOY 44:c1d8923072ba 1589 ```
TMBOY 44:c1d8923072ba 1590 {
TMBOY 44:c1d8923072ba 1591 "header":{
TMBOY 44:c1d8923072ba 1592 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1593 "name":"DriverInternalError",
TMBOY 44:c1d8923072ba 1594 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1595 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1596 },
TMBOY 44:c1d8923072ba 1597 "payload":{
TMBOY 44:c1d8923072ba 1598 }
TMBOY 44:c1d8923072ba 1599 }
TMBOY 44:c1d8923072ba 1600 ```
TMBOY 44:c1d8923072ba 1601
TMBOY 44:c1d8923072ba 1602 ##### DependentServiceUnavailableError
TMBOY 44:c1d8923072ba 1603 目的：表示技Bot依赖的模块不可用，Bot无法完成请求。
TMBOY 44:c1d8923072ba 1604
TMBOY 44:c1d8923072ba 1605 ###### Payload
TMBOY 44:c1d8923072ba 1606
TMBOY 44:c1d8923072ba 1607 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1608 |---|---|---|
TMBOY 44:c1d8923072ba 1609 | dependentServiceName | 表示不可用的依赖模块的字符串。必须以字母数字字符和空格指定。此值在256个字符后截断。 | Yes |
TMBOY 44:c1d8923072ba 1610
TMBOY 44:c1d8923072ba 1611 DependentServiceUnavailableError 例子：
TMBOY 44:c1d8923072ba 1612 ```
TMBOY 44:c1d8923072ba 1613 {
TMBOY 44:c1d8923072ba 1614 "header":{
TMBOY 44:c1d8923072ba 1615 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1616 "name":"DependentServiceUnavailableError",
TMBOY 44:c1d8923072ba 1617 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1618 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1619 },
TMBOY 44:c1d8923072ba 1620 "payload":{
TMBOY 44:c1d8923072ba 1621 "dependentServiceName":"Customer Credential Database"
TMBOY 44:c1d8923072ba 1622 }
TMBOY 44:c1d8923072ba 1623 }
TMBOY 44:c1d8923072ba 1624 ```
TMBOY 44:c1d8923072ba 1625
TMBOY 44:c1d8923072ba 1626 ##### TargetConnectivityUnstableError
TMBOY 44:c1d8923072ba 1627 目的：表示目标设备的云连接不稳定可靠。
TMBOY 44:c1d8923072ba 1628
TMBOY 44:c1d8923072ba 1629 ###### Payload
TMBOY 44:c1d8923072ba 1630
TMBOY 44:c1d8923072ba 1631 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1632 |---|---|---|
TMBOY 44:c1d8923072ba 1633 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1634
TMBOY 44:c1d8923072ba 1635 TargetConnectivityUnstableError 例子：
TMBOY 44:c1d8923072ba 1636 ```
TMBOY 44:c1d8923072ba 1637 {
TMBOY 44:c1d8923072ba 1638 "header":{
TMBOY 44:c1d8923072ba 1639 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1640 "name":"TargetConnectivityUnstableError ",
TMBOY 44:c1d8923072ba 1641 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1642 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1643 },
TMBOY 44:c1d8923072ba 1644 "payload":{
TMBOY 44:c1d8923072ba 1645 }
TMBOY 44:c1d8923072ba 1646 }
TMBOY 44:c1d8923072ba 1647 ```
TMBOY 44:c1d8923072ba 1648
TMBOY 44:c1d8923072ba 1649 ##### TargetBridgeConnectivityUnstableError
TMBOY 44:c1d8923072ba 1650 目的：表示连接目标设备的家庭hub或网桥的云连接不稳定和不可靠。
TMBOY 44:c1d8923072ba 1651
TMBOY 44:c1d8923072ba 1652 ###### Payload
TMBOY 44:c1d8923072ba 1653
TMBOY 44:c1d8923072ba 1654 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1655 |---|---|---|
TMBOY 44:c1d8923072ba 1656 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1657
TMBOY 44:c1d8923072ba 1658 TargetBridgeConnectivityUnstableError 例子：
TMBOY 44:c1d8923072ba 1659 ```
TMBOY 44:c1d8923072ba 1660 {
TMBOY 44:c1d8923072ba 1661 "header":{
TMBOY 44:c1d8923072ba 1662 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1663 "name":"TargetBridgeConnectivityUnstableError",
TMBOY 44:c1d8923072ba 1664 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1665 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1666 },
TMBOY 44:c1d8923072ba 1667 "payload":{
TMBOY 44:c1d8923072ba 1668 }
TMBOY 44:c1d8923072ba 1669 }
TMBOY 44:c1d8923072ba 1670 ```
TMBOY 44:c1d8923072ba 1671
TMBOY 44:c1d8923072ba 1672 ##### TargetFirmwareOutdatedError
TMBOY 44:c1d8923072ba 1673 目的：表示目标设备的固件版本太低。
TMBOY 44:c1d8923072ba 1674
TMBOY 44:c1d8923072ba 1675 ###### Payload
TMBOY 44:c1d8923072ba 1676
TMBOY 44:c1d8923072ba 1677 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1678 |---|---|---|
TMBOY 44:c1d8923072ba 1679 | minimumFirmwareVersion | 表示最低允许固件版本。不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1680 | currentFirmwareVersion | 表示当前固件版本。不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1681
TMBOY 44:c1d8923072ba 1682 TargetFirmwareOutdatedError 例子：
TMBOY 44:c1d8923072ba 1683 ```
TMBOY 44:c1d8923072ba 1684 {
TMBOY 44:c1d8923072ba 1685 "header":{
TMBOY 44:c1d8923072ba 1686 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1687 "name":"TargetFirmwareOutdatedError",
TMBOY 44:c1d8923072ba 1688 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1689 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1690 },
TMBOY 44:c1d8923072ba 1691 "payload":{
TMBOY 44:c1d8923072ba 1692 "minimumFirmwareVersion":"17",
TMBOY 44:c1d8923072ba 1693 "currentFirmwareVersion":"6"
TMBOY 44:c1d8923072ba 1694 }
TMBOY 44:c1d8923072ba 1695 }
TMBOY 44:c1d8923072ba 1696 ```
TMBOY 44:c1d8923072ba 1697
TMBOY 44:c1d8923072ba 1698 ##### TargetBridgeFirmwareOutdatedError
TMBOY 44:c1d8923072ba 1699 目的：表示连接目标设备的家庭hub或网桥的固件版本太低。
TMBOY 44:c1d8923072ba 1700
TMBOY 44:c1d8923072ba 1701 ###### Payload
TMBOY 44:c1d8923072ba 1702
TMBOY 44:c1d8923072ba 1703 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1704 |---|---|---|
TMBOY 44:c1d8923072ba 1705 | minimumFirmwareVersion | 表示最低允许固件版本。不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1706 | currentFirmwareVersion | 表示当前固件版本。不能超过256个字符。 | Yes |
TMBOY 44:c1d8923072ba 1707
TMBOY 44:c1d8923072ba 1708 TargetBridgeFirmwareOutdatedError 例子：
TMBOY 44:c1d8923072ba 1709 ```
TMBOY 44:c1d8923072ba 1710 {
TMBOY 44:c1d8923072ba 1711 "header":{
TMBOY 44:c1d8923072ba 1712 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1713 "name":"TargetBridgeFirmwareOutdatedError",
TMBOY 44:c1d8923072ba 1714 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1715 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1716 },
TMBOY 44:c1d8923072ba 1717 "payload":{
TMBOY 44:c1d8923072ba 1718 "minimumFirmwareVersion":"17",
TMBOY 44:c1d8923072ba 1719 "currentFirmwareVersion":"6"
TMBOY 44:c1d8923072ba 1720 }
TMBOY 44:c1d8923072ba 1721 }
TMBOY 44:c1d8923072ba 1722 ```
TMBOY 44:c1d8923072ba 1723
TMBOY 44:c1d8923072ba 1724 ##### TargetHardwareMalfunctionError
TMBOY 44:c1d8923072ba 1725 目的：表示目标设备出现硬件故障。
TMBOY 44:c1d8923072ba 1726
TMBOY 44:c1d8923072ba 1727 ###### Payload
TMBOY 44:c1d8923072ba 1728
TMBOY 44:c1d8923072ba 1729 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1730 |---|---|---|
TMBOY 44:c1d8923072ba 1731 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1732
TMBOY 44:c1d8923072ba 1733 TargetHardwareMalfunctionError 例子：
TMBOY 44:c1d8923072ba 1734 ```
TMBOY 44:c1d8923072ba 1735 {
TMBOY 44:c1d8923072ba 1736 "header":{
TMBOY 44:c1d8923072ba 1737 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1738 "name":"TargetHardwareMalfunctionError",
TMBOY 44:c1d8923072ba 1739 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1740 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1741 },
TMBOY 44:c1d8923072ba 1742 "payload":{
TMBOY 44:c1d8923072ba 1743 }
TMBOY 44:c1d8923072ba 1744 }
TMBOY 44:c1d8923072ba 1745 ```
TMBOY 44:c1d8923072ba 1746
TMBOY 44:c1d8923072ba 1747 ##### TargetBridgeHardwareMalfunctionError
TMBOY 44:c1d8923072ba 1748 目的：表示连接目标设备的家庭hub或桥接器出现硬件故障。
TMBOY 44:c1d8923072ba 1749
TMBOY 44:c1d8923072ba 1750 ###### Payload
TMBOY 44:c1d8923072ba 1751
TMBOY 44:c1d8923072ba 1752 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1753 |---|---|---|
TMBOY 44:c1d8923072ba 1754 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1755
TMBOY 44:c1d8923072ba 1756 TargetBridgeHardwareMalfunctionError 例子：
TMBOY 44:c1d8923072ba 1757 ```
TMBOY 44:c1d8923072ba 1758 {
TMBOY 44:c1d8923072ba 1759 "header":{
TMBOY 44:c1d8923072ba 1760 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1761 "name":"TargetBridgeHardwareMalfunctionError",
TMBOY 44:c1d8923072ba 1762 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1763 "messageId":"15a248f6-8ab5-433d-a3ac-73c358e0bebd"
TMBOY 44:c1d8923072ba 1764 },
TMBOY 44:c1d8923072ba 1765 "payload":{
TMBOY 44:c1d8923072ba 1766 }
TMBOY 44:c1d8923072ba 1767 }
TMBOY 44:c1d8923072ba 1768 ```
TMBOY 44:c1d8923072ba 1769
TMBOY 44:c1d8923072ba 1770 ##### UnableToGetValueError
TMBOY 44:c1d8923072ba 1771 目的：表示尝试在目标设备上获取指定值时发生错误。当返回此错误时，适当的errorInfo.code值可以让DuerOS能够适应不同类型的故障。您只需生成适用于目标设备的错误代码。
TMBOY 44:c1d8923072ba 1772
TMBOY 44:c1d8923072ba 1773 ###### Payload
TMBOY 44:c1d8923072ba 1774
TMBOY 44:c1d8923072ba 1775 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1776 |---|---|---|
TMBOY 44:c1d8923072ba 1777 | errorInfo | 描述为什么不能设置值的错误对象。 | Yes |
TMBOY 44:c1d8923072ba 1778 | errorInfo.code | 字符串格式的错误代码。有效值是: DEVICE_AJAR：由于门打开，无法获取指定的状态。DEVICE_BUSY：设备正忙。DEVICE_JAMMED：设备卡住。DEVICE_OVERHEATED：设备过热。HARDWARE_FAILURE：由于未确定的硬件故障，请求失败。LOW_BATTERY：设备的电池电量不足。NOT_CALIBRATED：设备未校准。 | Yes |
TMBOY 44:c1d8923072ba 1779 | errorInfo.Description | 来自设备制造商的错误的自定义描述。 | No |
TMBOY 44:c1d8923072ba 1780
TMBOY 44:c1d8923072ba 1781 UnableToGetValueError 例子：
TMBOY 44:c1d8923072ba 1782 ```
TMBOY 44:c1d8923072ba 1783 {
TMBOY 44:c1d8923072ba 1784 "header":{
TMBOY 44:c1d8923072ba 1785 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1786 "name":"UnableToGetValueError",
TMBOY 44:c1d8923072ba 1787 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1788 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1789 },
TMBOY 44:c1d8923072ba 1790 "payload":{
TMBOY 44:c1d8923072ba 1791 "errorInfo":{
TMBOY 44:c1d8923072ba 1792 "code":"DEVICE_JAMMED",
TMBOY 44:c1d8923072ba 1793 "description":"A custom description of the error.."
TMBOY 44:c1d8923072ba 1794 }
TMBOY 44:c1d8923072ba 1795 }
TMBOY 44:c1d8923072ba 1796 }
TMBOY 44:c1d8923072ba 1797 ```
TMBOY 44:c1d8923072ba 1798
TMBOY 44:c1d8923072ba 1799 ##### UnableToSetValueError
TMBOY 44:c1d8923072ba 1800 目的：表示尝试在目标设备上设置指定值时发生错误。当返回此错误时，适当的errorInfo.code值使得DuerOS能够适应不同类型的故障。您只需生成适用于目标设备的错误代码。
TMBOY 44:c1d8923072ba 1801
TMBOY 44:c1d8923072ba 1802 ###### Payload
TMBOY 44:c1d8923072ba 1803
TMBOY 44:c1d8923072ba 1804 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1805 |---|---|---|
TMBOY 44:c1d8923072ba 1806 | errorInfo | 描述为什么不能设置值的错误对象。 | Yes |
TMBOY 44:c1d8923072ba 1807 | errorInfo.code | 字符串格式的错误代码。有效值是: DEVICE_AJAR：由于门打开，无法获取指定的状态。DEVICE_BUSY：设备正忙。DEVICE_JAMMED：设备卡住。DEVICE_OVERHEATED：设备过热。HARDWARE_FAILURE：由于未确定的硬件故障，请求失败。LOW_BATTERY：设备的电池电量不足。NOT_CALIBRATED：设备未校准。 | Yes |
TMBOY 44:c1d8923072ba 1808 | errorInfo.Description | 来自设备制造商的错误的自定义描述。 | No |
TMBOY 44:c1d8923072ba 1809
TMBOY 44:c1d8923072ba 1810 UnableToSetValueError 例子：
TMBOY 44:c1d8923072ba 1811 ```
TMBOY 44:c1d8923072ba 1812 {
TMBOY 44:c1d8923072ba 1813 "header":{
TMBOY 44:c1d8923072ba 1814 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1815 "name":"UnableToSetValueError",
TMBOY 44:c1d8923072ba 1816 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1817 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1818 },
TMBOY 44:c1d8923072ba 1819 "payload":{
TMBOY 44:c1d8923072ba 1820 "errorInfo":{
TMBOY 44:c1d8923072ba 1821 "code":"DEVICE_JAMMED",
TMBOY 44:c1d8923072ba 1822 "description":"A custom description of the error.."
TMBOY 44:c1d8923072ba 1823 }
TMBOY 44:c1d8923072ba 1824 }
TMBOY 44:c1d8923072ba 1825 }
TMBOY 44:c1d8923072ba 1826 ```
TMBOY 44:c1d8923072ba 1827
TMBOY 44:c1d8923072ba 1828 ##### UnwillingToSetValueError
TMBOY 44:c1d8923072ba 1829 目的：表示目标设备商不愿意在指定的设备上设置请求的值。使用此错误进行温度设置。
TMBOY 44:c1d8923072ba 1830
TMBOY 44:c1d8923072ba 1831 ###### Payload
TMBOY 44:c1d8923072ba 1832
TMBOY 44:c1d8923072ba 1833 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1834 |---|---|---|
TMBOY 44:c1d8923072ba 1835 | errorInfo | 描述为什么不能设置值的错误对象。 | Yes |
TMBOY 44:c1d8923072ba 1836 | errorInfo.code | 字符串格式的错误代码。目前，代码的有效值为ThermostatIsOff，表示由于恒温器关闭，制造商不愿自动将其启动，因此被请求的操作被拒绝。 | Yes |
TMBOY 44:c1d8923072ba 1837 | errorInfo.Description | 来自设备制造商的错误的自定义描述。 | No |
TMBOY 44:c1d8923072ba 1838
TMBOY 44:c1d8923072ba 1839 UnwillingToSetValueError 例子：
TMBOY 44:c1d8923072ba 1840 ```
TMBOY 44:c1d8923072ba 1841 {
TMBOY 44:c1d8923072ba 1842 "header":{
TMBOY 44:c1d8923072ba 1843 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1844 "name":"UnwillingToSetValueError",
TMBOY 44:c1d8923072ba 1845 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1846 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1847 },
TMBOY 44:c1d8923072ba 1848 "payload":{
TMBOY 44:c1d8923072ba 1849 "errorInfo":{
TMBOY 44:c1d8923072ba 1850 "code":"ThermostatIsOff",
TMBOY 44:c1d8923072ba 1851 "description":"The requested operation is unsafe because it requires changing the mode."
TMBOY 44:c1d8923072ba 1852 }
TMBOY 44:c1d8923072ba 1853 }
TMBOY 44:c1d8923072ba 1854 }
TMBOY 44:c1d8923072ba 1855 ```
TMBOY 44:c1d8923072ba 1856
TMBOY 44:c1d8923072ba 1857 ##### RateLimitExceededError
TMBOY 44:c1d8923072ba 1858 目的：表示超出设备接受的最大请求数。此消息提供有关设备的最大请求数和这些请求的时间单位的信息。例如，如果设备每小时接受四个请求，则消息应分别指定4和HOUR作为rateLimit和timeUnit。
TMBOY 44:c1d8923072ba 1859
TMBOY 44:c1d8923072ba 1860 ###### Payload
TMBOY 44:c1d8923072ba 1861
TMBOY 44:c1d8923072ba 1862 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1863 |---|---|---|
TMBOY 44:c1d8923072ba 1864 | rateLimit | Integer，表示设备在指定的时间单位中接受的最大请求数。 | Yes |
TMBOY 44:c1d8923072ba 1865 | timeUnit | 大写字符串，表示rateLimit的时间单位，如MINUTE，HOUR或DAY。 | Yes |
TMBOY 44:c1d8923072ba 1866
TMBOY 44:c1d8923072ba 1867 RateLimitExceededError 例子：
TMBOY 44:c1d8923072ba 1868 ```
TMBOY 44:c1d8923072ba 1869 {
TMBOY 44:c1d8923072ba 1870 "header":{
TMBOY 44:c1d8923072ba 1871 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1872 "name":"RateLimitExceededError",
TMBOY 44:c1d8923072ba 1873 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1874 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1875 },
TMBOY 44:c1d8923072ba 1876 "payload":{
TMBOY 44:c1d8923072ba 1877 "errorInfo":{
TMBOY 44:c1d8923072ba 1878 "rateLimit":"10",
TMBOY 44:c1d8923072ba 1879 "timeUnit":"HOUR"
TMBOY 44:c1d8923072ba 1880 }
TMBOY 44:c1d8923072ba 1881 }
TMBOY 44:c1d8923072ba 1882 }
TMBOY 44:c1d8923072ba 1883 ```
TMBOY 44:c1d8923072ba 1884
TMBOY 44:c1d8923072ba 1885 ##### NotSupportedInCurrentModeError
TMBOY 44:c1d8923072ba 1886 目的：表示目标设备处于无法通过DuerOS进行控制的模式，并提供有关设备当前模式的信息。
TMBOY 44:c1d8923072ba 1887
TMBOY 44:c1d8923072ba 1888 ###### Payload
TMBOY 44:c1d8923072ba 1889
TMBOY 44:c1d8923072ba 1890 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1891 |---|---|---|
TMBOY 44:c1d8923072ba 1892 | currentDeviceMode | 表示设备当前模式的字符串。有效值为AUTO，AWAY，COLOR，COOL，HEAT和OTHER。 | Yes |
TMBOY 44:c1d8923072ba 1893
TMBOY 44:c1d8923072ba 1894 NotSupportedInCurrentModeError 例子：
TMBOY 44:c1d8923072ba 1895 ```
TMBOY 44:c1d8923072ba 1896 {
TMBOY 44:c1d8923072ba 1897 "header":{
TMBOY 44:c1d8923072ba 1898 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1899 "name":"NotSupportedInCurrentModeError",
TMBOY 44:c1d8923072ba 1900 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1901 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1902 },
TMBOY 44:c1d8923072ba 1903 "payload":{
TMBOY 44:c1d8923072ba 1904 "errorInfo":{
TMBOY 44:c1d8923072ba 1905 "currentDeviceMode":"COOL",
TMBOY 44:c1d8923072ba 1906 }
TMBOY 44:c1d8923072ba 1907 }
TMBOY 44:c1d8923072ba 1908 }
TMBOY 44:c1d8923072ba 1909 ```
TMBOY 44:c1d8923072ba 1910
TMBOY 44:c1d8923072ba 1911 #### 其他错误(Other Faults)
TMBOY 44:c1d8923072ba 1912 当一个或多个请求输入无效DuerOS无法处理时，会发生以下错误。例如，访问令牌(access token)无效。
TMBOY 44:c1d8923072ba 1913
TMBOY 44:c1d8923072ba 1914 ##### ExpiredAccessTokenError
TMBOY 44:c1d8923072ba 1915 目的：表示用于认证的访问令牌(access token)已过期，不再有效。
TMBOY 44:c1d8923072ba 1916
TMBOY 44:c1d8923072ba 1917 ###### Payload
TMBOY 44:c1d8923072ba 1918
TMBOY 44:c1d8923072ba 1919 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1920 |---|---|---|
TMBOY 44:c1d8923072ba 1921 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1922
TMBOY 44:c1d8923072ba 1923 ExpiredAccessTokenError 例子：
TMBOY 44:c1d8923072ba 1924 ```
TMBOY 44:c1d8923072ba 1925 {
TMBOY 44:c1d8923072ba 1926 "header":{
TMBOY 44:c1d8923072ba 1927 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1928 "name":"ExpiredAccessTokenError",
TMBOY 44:c1d8923072ba 1929 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1930 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1931 },
TMBOY 44:c1d8923072ba 1932 "payload":{
TMBOY 44:c1d8923072ba 1933 }
TMBOY 44:c1d8923072ba 1934 }
TMBOY 44:c1d8923072ba 1935 ```
TMBOY 44:c1d8923072ba 1936
TMBOY 44:c1d8923072ba 1937 ##### InvalidAccessTokenError
TMBOY 44:c1d8923072ba 1938 目的：表示用于身份验证的访问令牌(access token)无效，除了已过期的原因。
TMBOY 44:c1d8923072ba 1939
TMBOY 44:c1d8923072ba 1940 ###### Payload
TMBOY 44:c1d8923072ba 1941
TMBOY 44:c1d8923072ba 1942 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1943 |---|---|---|
TMBOY 44:c1d8923072ba 1944 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1945
TMBOY 44:c1d8923072ba 1946 InvalidAccessTokenError 例子：
TMBOY 44:c1d8923072ba 1947 ```
TMBOY 44:c1d8923072ba 1948 {
TMBOY 44:c1d8923072ba 1949 "header":{
TMBOY 44:c1d8923072ba 1950 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1951 "name":"InvalidAccessTokenError",
TMBOY 44:c1d8923072ba 1952 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1953 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1954 },
TMBOY 44:c1d8923072ba 1955 "payload":{
TMBOY 44:c1d8923072ba 1956 }
TMBOY 44:c1d8923072ba 1957 }
TMBOY 44:c1d8923072ba 1958 ```
TMBOY 44:c1d8923072ba 1959
TMBOY 44:c1d8923072ba 1960 ##### UnsupportedTargetError
TMBOY 44:c1d8923072ba 1961 目的：指示Bot不支持目标设备。
TMBOY 44:c1d8923072ba 1962
TMBOY 44:c1d8923072ba 1963 ###### Payload
TMBOY 44:c1d8923072ba 1964
TMBOY 44:c1d8923072ba 1965 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1966 |---|---|---|
TMBOY 44:c1d8923072ba 1967 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1968
TMBOY 44:c1d8923072ba 1969 UnsupportedTargetError 例子：
TMBOY 44:c1d8923072ba 1970 ```
TMBOY 44:c1d8923072ba 1971 {
TMBOY 44:c1d8923072ba 1972 "header":{
TMBOY 44:c1d8923072ba 1973 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1974 "name":"UnsupportedTargetError",
TMBOY 44:c1d8923072ba 1975 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1976 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 1977 },
TMBOY 44:c1d8923072ba 1978 "payload":{
TMBOY 44:c1d8923072ba 1979 }
TMBOY 44:c1d8923072ba 1980 }
TMBOY 44:c1d8923072ba 1981 ```
TMBOY 44:c1d8923072ba 1982
TMBOY 44:c1d8923072ba 1983 ##### UnsupportedOperationError
TMBOY 44:c1d8923072ba 1984 目的：表示目标设备不支持请求的操作。
TMBOY 44:c1d8923072ba 1985
TMBOY 44:c1d8923072ba 1986 ###### Payload
TMBOY 44:c1d8923072ba 1987
TMBOY 44:c1d8923072ba 1988 |Property|Description|Required|
TMBOY 44:c1d8923072ba 1989 |---|---|---|
TMBOY 44:c1d8923072ba 1990 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 1991
TMBOY 44:c1d8923072ba 1992 UnsupportedOperationError 例子：
TMBOY 44:c1d8923072ba 1993 ```
TMBOY 44:c1d8923072ba 1994 {
TMBOY 44:c1d8923072ba 1995 "header":{
TMBOY 44:c1d8923072ba 1996 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 1997 "name":"UnsupportedOperationError",
TMBOY 44:c1d8923072ba 1998 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 1999 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 2000 },
TMBOY 44:c1d8923072ba 2001 "payload":{
TMBOY 44:c1d8923072ba 2002 }
TMBOY 44:c1d8923072ba 2003 }
TMBOY 44:c1d8923072ba 2004 ```
TMBOY 44:c1d8923072ba 2005
TMBOY 44:c1d8923072ba 2006 ##### UnsupportedTargetSettingError
TMBOY 44:c1d8923072ba 2007 目的：表示所请求的设置对于指定的设备和操作无效。
TMBOY 44:c1d8923072ba 2008
TMBOY 44:c1d8923072ba 2009 ###### Payload
TMBOY 44:c1d8923072ba 2010
TMBOY 44:c1d8923072ba 2011 |Property|Description|Required|
TMBOY 44:c1d8923072ba 2012 |---|---|---|
TMBOY 44:c1d8923072ba 2013 | N/A | N/A | N/A |
TMBOY 44:c1d8923072ba 2014
TMBOY 44:c1d8923072ba 2015 UnsupportedTargetSettingError 例子：
TMBOY 44:c1d8923072ba 2016 ```
TMBOY 44:c1d8923072ba 2017 {
TMBOY 44:c1d8923072ba 2018 "header":{
TMBOY 44:c1d8923072ba 2019 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 2020 "name":"UnsupportedTargetSettingError",
TMBOY 44:c1d8923072ba 2021 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 2022 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 2023 },
TMBOY 44:c1d8923072ba 2024 "payload":{
TMBOY 44:c1d8923072ba 2025 }
TMBOY 44:c1d8923072ba 2026 }
TMBOY 44:c1d8923072ba 2027 ```
TMBOY 44:c1d8923072ba 2028
TMBOY 44:c1d8923072ba 2029 ##### UnexpectedInformationReceivedError
TMBOY 44:c1d8923072ba 2030 目的：由于格式错误，Bot无法处理请求消息。
TMBOY 44:c1d8923072ba 2031
TMBOY 44:c1d8923072ba 2032 ###### Payload
TMBOY 44:c1d8923072ba 2033
TMBOY 44:c1d8923072ba 2034 |Property|Description|Required|
TMBOY 44:c1d8923072ba 2035 |---|---|---|
TMBOY 44:c1d8923072ba 2036 | faultingParameter | 请求消息中的属性或字段格式错误，导致Bot无法处理。 | Yes |
TMBOY 44:c1d8923072ba 2037
TMBOY 44:c1d8923072ba 2038 UnexpectedInformationReceivedError 例子：
TMBOY 44:c1d8923072ba 2039 ```
TMBOY 44:c1d8923072ba 2040 {
TMBOY 44:c1d8923072ba 2041 "header":{
TMBOY 44:c1d8923072ba 2042 "namespace":"DuerOS.ConnectedHome.Control",
TMBOY 44:c1d8923072ba 2043 "name":"UnexpectedInformationReceivedError",
TMBOY 44:c1d8923072ba 2044 "payloadVersion":"1",
TMBOY 44:c1d8923072ba 2045 "messageId":"917314cd-ca00-49ca-b75e-d6f65ac43503"
TMBOY 44:c1d8923072ba 2046 },
TMBOY 44:c1d8923072ba 2047 "payload":{
TMBOY 44:c1d8923072ba 2048 "faultingParameter": "value"
TMBOY 44:c1d8923072ba 2049 }
TMBOY 44:c1d8923072ba 2050 }
TMBOY 44:c1d8923072ba 2051 ```