@quec/rn-device-module 1.9.19 → 2.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/.vscode/settings.json +3 -0
  2. package/QuecRNDeviceModule.podspec +54 -0
  3. package/README.md +1535 -1043
  4. package/android/build.gradle +119 -0
  5. package/android/gradle/wrapper/gradle-wrapper.jar +0 -0
  6. package/android/gradle/wrapper/gradle-wrapper.properties +5 -0
  7. package/android/gradle.properties +23 -0
  8. package/android/gradlew +185 -0
  9. package/android/gradlew.bat +89 -0
  10. package/android/old-info.properties +2 -0
  11. package/android/proguard-rules.pro +21 -0
  12. package/android/publishInfo.properties +4 -0
  13. package/android/settings.gradle +3 -0
  14. package/android/src/main/AndroidManifest.xml +6 -0
  15. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/IQuecRNDeviceModuleSpec.java +1352 -0
  16. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/QuecRNDeviceModule.java +2423 -0
  17. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/QuecRNDeviceModulePackage.java +23 -0
  18. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/DataInfo.java +25 -0
  19. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/DataRes.java +31 -0
  20. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/DeviceDpsUpdateModel.java +18 -0
  21. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/ModelBridgeBasic.java +86 -0
  22. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/OtaUpgradePlanModel.java +292 -0
  23. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/ShareInfo.java +166 -0
  24. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/UserInfo.java +137 -0
  25. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/bean/WriteCmdWithId.java +10 -0
  26. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/AnalysisChannelDataUtils.java +82 -0
  27. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/DataConvertUtils.kt +130 -0
  28. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/ErrorCode.java +26 -0
  29. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/ErrorUtils.java +11 -0
  30. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/IpcUtil.java +75 -0
  31. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/NetUtils.java +85 -0
  32. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/OnConnectListener.java +22 -0
  33. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/ParamsValueUtils.java +79 -0
  34. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/QuecIotChannelMode.java +8 -0
  35. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/ReactNativeJson.java +199 -0
  36. package/android/src/main/java/com/quectel/smart/rnplugin/quecrndevicemodule/utils/ResponseUtils.java +156 -0
  37. package/android/src/main/res/values/strings.xml +4 -0
  38. package/android/src/main/res/values-en/strings.xml +4 -0
  39. package/android/src/main/res/values-zh/strings.xml +4 -0
  40. package/android/src/test/java/com/quectel/smart/template/ExampleUnitTest.java +17 -0
  41. package/build.gradle +1 -0
  42. package/gradle/wrapper/gradle-wrapper.jar +0 -0
  43. package/gradle/wrapper/gradle-wrapper.properties +6 -0
  44. package/ios/Example/Podfile +17 -0
  45. package/ios/Example/QuecRNDeviceModule/AppDelegate.h +13 -0
  46. package/ios/Example/QuecRNDeviceModule/AppDelegate.m +46 -0
  47. package/ios/Example/QuecRNDeviceModule/Base.lproj/LaunchScreen.storyboard +31 -0
  48. package/ios/Example/QuecRNDeviceModule/Base.lproj/Main.storyboard +31 -0
  49. package/ios/Example/QuecRNDeviceModule/Images.xcassets/AppIcon.appiconset/Contents.json +98 -0
  50. package/ios/Example/QuecRNDeviceModule/QuecRNDeviceModule-Info.plist +40 -0
  51. package/ios/Example/QuecRNDeviceModule/QuecRNDeviceModule-Prefix.pch +16 -0
  52. package/ios/Example/QuecRNDeviceModule/ViewController.h +12 -0
  53. package/ios/Example/QuecRNDeviceModule/ViewController.m +29 -0
  54. package/ios/Example/QuecRNDeviceModule/en.lproj/InfoPlist.strings +2 -0
  55. package/ios/Example/QuecRNDeviceModule/main.m +15 -0
  56. package/ios/Example/QuecRNDeviceModule.xcodeproj/project.pbxproj +583 -0
  57. package/ios/Example/QuecRNDeviceModule.xcodeproj/project.xcworkspace/contents.xcworkspacedata +7 -0
  58. package/ios/Example/QuecRNDeviceModule.xcodeproj/xcshareddata/xcschemes/QuecRNDeviceModule-Example.xcscheme +101 -0
  59. package/ios/Example/QuecRNDeviceModule.xcworkspace/contents.xcworkspacedata +10 -0
  60. package/ios/Example/QuecRNDeviceModule.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  61. package/ios/LICENSE +4 -0
  62. package/ios/QuecRNDeviceModule/Assets/.gitkeep +0 -0
  63. package/ios/QuecRNDeviceModule/Classes/QuecRNDeviceModule+Ext.h +27 -0
  64. package/ios/QuecRNDeviceModule/Classes/QuecRNDeviceModule+Impl.h +1137 -0
  65. package/ios/QuecRNDeviceModule/Classes/QuecRNDeviceModule+Impl.m +1524 -0
  66. package/ios/QuecRNDeviceModule/Classes/QuecRNDeviceModule.h +157 -0
  67. package/ios/QuecRNDeviceModule/Classes/QuecRNDeviceModule.m +721 -0
  68. package/ios/README.md +20 -0
  69. package/{.prettierrc.js → js/.prettierrc.js} +11 -11
  70. package/js/README.md +1535 -0
  71. package/js/package.json +25 -0
  72. package/{src → js/src}/index.ts +12 -12
  73. package/{src → js/src}/module.ts +1332 -939
  74. package/{src → js/src}/viewCommon.ts +3 -3
  75. package/js/tsconfig.json +26 -0
  76. package/js/yarn.lock +4 -0
  77. package/package.json +10 -25
  78. package/plugin.ts +1180 -0
  79. package/settings.gradle +2 -0
  80. package/tsconfig.json +9 -0
package/README.md CHANGED
@@ -1,1043 +1,1535 @@
1
- # QuecRNDeviceModule
2
-
3
- 设备桥组件
4
-
5
-
6
-
7
- 类型|版本|适用平台|负责人
8
- -|-|-|-
9
- module|1.9.19|all|vic.huang@quectel.com
10
-
11
- > **1.9.19 Changelog:**
12
- > none
13
-
14
-
15
- ## 方法
16
-
17
-
18
- ### isWebSocketSubscribe
19
-
20
- 获取当前设备WS订阅通道状态,订阅状态为true,不代表设备在线,只代表app和云端对当前设备进行了订阅
21
-
22
-
23
-
24
- 起始版本|适用平台
25
- -|-
26
- 1.8.0|all
27
-
28
- 序号|参数名|参数类型|描述
29
- -|-|-|-
30
- 1|promise|promisecb|回调 callback {"subscribe": true/false }
31
-
32
-
33
- ### getDeviceConnectingState
34
-
35
- 获取设备通道连接中状态
36
-
37
-
38
-
39
- 起始版本|适用平台
40
- -|-
41
- 1.8.0|all
42
-
43
- 序号|参数名|参数类型|描述
44
- -|-|-|-
45
- 1|promise|promisecb|回调 callback {"connectingState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
46
-
47
-
48
- ### writeDpsByHttp
49
-
50
- writeDpsByHttp
51
-
52
-
53
-
54
- 起始版本|适用平台
55
- -|-
56
- 1.8.0|all
57
-
58
- 序号|参数名|参数类型|描述
59
- -|-|-|-
60
- 1|dps|Array&lt;object&gt;|– dps 确保code和value不为空 [ {id:0, code:"electric" type:BOOL, value:false} ,{id:1, code:"electric2", type:INT, value:2}]
61
- 2|deviceList|Array&lt;object&gt;|– deviceList 设备列表 [{"deviceKey":"", "productKey":""}]
62
- 3|type|integer|- 类型 1:透传 2:属性 3:服务
63
- 4|extraData|object|– {<br>dataFormat 数据类型 1:Hex 2:Text(当type为透传时,需要指定 dataFormat)<br>cacheTime 缓存时间,单位为秒,缓存时间范围 1-7776000 秒,启用缓存时必须设置缓存时间<br>isCache 是否启用缓存 1:启用 2:不启用,默认不启用<br>isCover 是否覆盖之前发送的相同的命令 1:覆盖 2:不覆盖,默认不覆盖,启用缓存时此参数有效<br><br>查看接口定义<br>}
64
- 5|promise|promisecb|回调 callback
65
-
66
-
67
- ### readDpsWithExtraData
68
-
69
- read data points
70
-
71
-
72
-
73
- 起始版本|适用平台
74
- -|-
75
- 1.6.8|all
76
-
77
- 序号|参数名|参数类型|描述
78
- -|-|-|-
79
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
80
- 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
81
- 3|promise|promisecb|回调 callback
82
-
83
-
84
- ### readDpsWithExtraDataAndMode
85
-
86
- read data points
87
-
88
-
89
-
90
- 起始版本|适用平台
91
- -|-
92
- 1.6.8|all
93
-
94
- 序号|参数名|参数类型|描述
95
- -|-|-|-
96
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
97
- 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
98
- 3|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
99
- 4|promise|promisecb|回调 callback
100
-
101
-
102
- ### writeDpsWithExtraData
103
-
104
- write data points
105
-
106
-
107
-
108
- 起始版本|适用平台
109
- -|-
110
- 1.6.8|all
111
-
112
- 序号|参数名|参数类型|描述
113
- -|-|-|-
114
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
115
- 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
116
- 3|promise|promisecb|回调 callback
117
-
118
-
119
- ### writeDpsWithExtraDataAndMode
120
-
121
- write data points
122
-
123
-
124
-
125
- 起始版本|适用平台
126
- -|-
127
- 1.6.8|all
128
-
129
- 序号|参数名|参数类型|描述
130
- -|-|-|-
131
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
132
- 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
133
- 3|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
134
- 4|promise|promisecb|回调 callback
135
-
136
-
137
- ### getBleState
138
-
139
- 获取设备通道状态
140
-
141
-
142
-
143
- 起始版本|适用平台
144
- -|-
145
- 1.4.0|all
146
-
147
- 序号|参数名|参数类型|描述
148
- -|-|-|-
149
- 1|promise|promisecb|回调 callback {"state": 0/1/2}<br>(0: 未开启, 1: 未授权, 2 : 可用)
150
-
151
-
152
- ### getTslAndAttrs
153
-
154
- 获取物模型以及属性值
155
-
156
-
157
-
158
- 起始版本|适用平台
159
- -|-
160
- 1.4.0|all
161
-
162
- 序号|参数名|参数类型|描述
163
- -|-|-|-
164
- 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>gatewayDk string 网关设备的 Device Key<br>gatewayPk string 网关设备的 Product Key<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔
165
- 2|promise|promisecb|promise 执行回调
166
-
167
-
168
- ### readDps
169
-
170
- read data points
171
-
172
-
173
-
174
- 起始版本|适用平台
175
- -|-
176
- 1.4.0|all
177
-
178
- 序号|参数名|参数类型|描述
179
- -|-|-|-
180
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
181
- 2|promise|promisecb|回调 callback
182
-
183
-
184
- ### writeDps
185
-
186
- write data points
187
-
188
-
189
-
190
- 起始版本|适用平台
191
- -|-
192
- 1.4.0|all
193
-
194
- 序号|参数名|参数类型|描述
195
- -|-|-|-
196
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
197
- 2|promise|promisecb|回调 callback
198
-
199
-
200
- ### readDpsWithMode
201
-
202
- read data points
203
-
204
-
205
-
206
- 起始版本|适用平台
207
- -|-
208
- 1.4.0|all
209
-
210
- 序号|参数名|参数类型|描述
211
- -|-|-|-
212
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
213
- 2|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
214
- 3|promise|promisecb|回调 callback
215
-
216
-
217
- ### writeDpsWithMode
218
-
219
- write data points
220
-
221
-
222
-
223
- 起始版本|适用平台
224
- -|-
225
- 1.4.0|all
226
-
227
- 序号|参数名|参数类型|描述
228
- -|-|-|-
229
- 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
230
- 2|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
231
- 3|promise|promisecb|回调 callback
232
-
233
-
234
- ### getOnlineState
235
-
236
- 获取设备通道状态
237
-
238
-
239
-
240
- 起始版本|适用平台
241
- -|-
242
- 1.4.0|all
243
-
244
- 序号|参数名|参数类型|描述
245
- -|-|-|-
246
- 1|promise|promisecb|回调 callback {"onlineState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
247
-
248
-
249
- ### connectChannel
250
-
251
- 建立通道,(设备会自动根据设备通道能力capabilitiesBitmask建立通道,此API用于手动切换指定通道)
252
-
253
-
254
-
255
- 起始版本|适用平台
256
- -|-
257
- 1.4.0|all
258
-
259
- 序号|参数名|参数类型|描述
260
- -|-|-|-
261
- 1|mode|integer|– mode 建立通道模式: 0 auto,1: websocket 2:wifi 3:ble<br>注意:1,建立的通通与已连接通道不同时,已连接通道会断开。<br>2,当设备不具备相应通道,建立其不具备的通道会失败。不会再自动建立其他通道
262
-
263
-
264
- ### disconnectChannel
265
-
266
- 断开通道,(
267
-
268
-
269
-
270
- 起始版本|适用平台
271
- -|-
272
- 1.4.0|all
273
-
274
- 序号|参数名|参数类型|描述
275
- -|-|-|-
276
- 1|type|integer|– type 通道类型,0: 关闭所有通道(关闭wifi和ble), 2:wifi 3:ble
277
-
278
-
279
- ### isWebSocketLoginCallback `弃用`
280
-
281
- 获取websocket是否登录成功
282
-
283
-
284
- > 该方法已弃用并不再维护,如遇问题请联系开发者
285
-
286
-
287
- 起始版本|适用平台
288
- -|-
289
- 1.0.0|all
290
-
291
- 序号|参数名|参数类型|描述
292
- -|-|-|-
293
- 1|isLoginCallback|successcb|Func 接受是否登录websocket回调 已登录成功 true 登录失败 false
294
-
295
-
296
- ### subscribeDevicesWithList `弃用`
297
-
298
- 订阅设备
299
-
300
-
301
- > 该方法已弃用并不再维护,如遇问题请联系开发者
302
-
303
-
304
- 起始版本|适用平台
305
- -|-
306
- 1.0.0|all
307
-
308
- 序号|参数名|参数类型|描述
309
- -|-|-|-
310
- 1|list|Array&lt;object&gt;|订阅设备列表,订阅结果QuecDeviceServiceWebSocketDelegate返回<br>[<br>{<br>"deviceKey": "1234567890",<br>"messageType": [<br>"ONLINE"<br>],<br>"productKey": "p12345"<br>},<br>{<br>"deviceKey": "1234567890",<br>"messageType": [<br>"ONLINE",<br>"STATUS"<br>],<br>"productKey": "p12345"<br>}<br>]
311
-
312
-
313
- ### unSubscribeDevicesWithList `弃用`
314
-
315
- 取消订阅设备
316
-
317
-
318
- > 该方法已弃用并不再维护,如遇问题请联系开发者
319
-
320
-
321
- 起始版本|适用平台
322
- -|-
323
- 1.0.0|all
324
-
325
- 序号|参数名|参数类型|描述
326
- -|-|-|-
327
- 1|list|Array&lt;object&gt;|取消订阅设备列表,取消订阅结果QuecDeviceServiceWebSocketDelegate返回<br>[<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345"<br>},<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345"<br>}<br>]
328
-
329
-
330
- ### sendDataToDeviceByWebSocketWithDataDict `弃用`
331
-
332
- 获取设备业务属性值
333
-
334
-
335
- > 该方法已弃用并不再维护,如遇问题请联系开发者
336
-
337
-
338
- 起始版本|适用平台
339
- -|-
340
- 1.0.0|all
341
-
342
- 序号|参数名|参数类型|描述
343
- -|-|-|-
344
- 1|params|object|发送数据,需要在delegate的websocketDidOpen回调之后才能调用<br>透传<br>{<br>"cmd": "send",<br>"data": {<br>"cacheTime": 3600,<br>"dataFormat": "Text",<br>"deviceKey": "866123456789015",<br>"isCache": true,<br>"productKey": "p12345",<br>"raw": "123456",<br>"type": "RAW"<br>}<br>}<br>物模型<br>{<br>"cmd": "send",<br>"data": {<br>"deviceKey": "1234567890",<br>"kv": "[{\"id\":5,\"name\":\"openapi\",\"type\":\"BOOL\",\"value\":\"true\"}]",<br>"productKey": "p12345",<br>"type": "WRITE-ATTR"<br>}<br>}
345
-
346
-
347
- ### getDeviceListWithPageNumber `弃用`
348
-
349
- 获取设备列表
350
-
351
-
352
- > 该方法已弃用并不再维护,如遇问题请联系开发者
353
-
354
-
355
- 起始版本|适用平台
356
- -|-
357
- 1.0.0|all
358
-
359
- 序号|参数名|参数类型|描述
360
- -|-|-|-
361
- 1|pageNumber|integer|number 页码
362
- 2|pageSize|integer|number 页大小
363
- 3|promise|promisecb|promise 执行回调<br>callback {"data": {"list" : [], "total" : 12}}
364
-
365
-
366
- ### getProductTSLWithProductKey `弃用`
367
-
368
- 获取设备业务物模型属性值
369
-
370
-
371
- > 该方法已弃用并不再维护,如遇问题请联系开发者
372
-
373
-
374
- 起始版本|适用平台
375
- -|-
376
- 1.0.0|all
377
-
378
- 序号|参数名|参数类型|描述
379
- -|-|-|-
380
- 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>gatewayDk string 网关设备的 Device Key<br>gatewayPk string 网关设备的 Product Key<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔
381
- 2|promise|promisecb|promise 执行回调
382
-
383
-
384
- ### getDeviceBusinessAttributesWithProductKey `弃用`
385
-
386
- 获取设备业务属性值
387
-
388
-
389
- > 该方法已弃用并不再维护,如遇问题请联系开发者
390
-
391
-
392
- 起始版本|适用平台
393
- -|-
394
- 1.0.0|all
395
-
396
- 序号|参数名|参数类型|描述
397
- -|-|-|-
398
- 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔
399
- 2|promise|promisecb|promise 执行回调
400
-
401
-
402
- ### updateDeviceNameByShareUserWithDeviceName `弃用`
403
-
404
- 更改分享设备名称
405
-
406
-
407
- > 该方法已弃用并不再维护,如遇问题请联系开发者
408
-
409
-
410
- 起始版本|适用平台
411
- -|-
412
- 1.0.0|all
413
-
414
- 序号|参数名|参数类型|描述
415
- -|-|-|-
416
- 1|deviceName|string|string 设备名称
417
- 2|shareCode|string|string 分享码
418
- 3|promise|promisecb|promise 执行回调
419
-
420
-
421
- ### updateDeviceName `弃用`
422
-
423
- 更改分享设备名称
424
-
425
-
426
- > 该方法已弃用并不再维护,如遇问题请联系开发者
427
-
428
-
429
- 起始版本|适用平台
430
- -|-
431
- 1.0.0|all
432
-
433
- 序号|参数名|参数类型|描述
434
- -|-|-|-
435
- 1|deviceName|string|string deviceName
436
- 2|productKey|string|string product key
437
- 3|deviceKey|string|string deviceKey
438
- 4|promise|promisecb|promise 执行回调
439
-
440
-
441
- ### getGatewayDeviceChildListWithParams `弃用`
442
-
443
- 查询网关设备下子设备列表
444
-
445
-
446
- > 该方法已弃用并不再维护,如遇问题请联系开发者
447
-
448
-
449
- 起始版本|适用平台
450
- -|-
451
- 1.0.0|all
452
-
453
- 序号|参数名|参数类型|描述
454
- -|-|-|-
455
- 1|params|object|deviceKey string 必传 网关设备deviceKey<br>productKey string 必传 网关设备productKey<br>pageNumber number 必传 页码<br>pageSize number 必传 页大小
456
- 2|promise|promisecb|promise 执行回调<br>callback {"data": {"list" : [], "total" : 12}}
457
-
458
-
459
- ### unbindDeviceWithDeviceKey `弃用`
460
-
461
- 设备解绑
462
-
463
-
464
- > 该方法已弃用并不再维护,如遇问题请联系开发者
465
-
466
-
467
- 起始版本|适用平台
468
- -|-
469
- 1.0.0|all
470
-
471
- 序号|参数名|参数类型|描述
472
- -|-|-|-
473
- 1|deviceKey|string|string device key
474
- 2|productKey|string|string product key
475
- 3|promise|promisecb|promise 执行回调
476
-
477
-
478
- ### unShareDeviceByShareUserWithShareCode `弃用`
479
-
480
- 设备解绑
481
-
482
-
483
- > 该方法已弃用并不再维护,如遇问题请联系开发者
484
-
485
-
486
- 起始版本|适用平台
487
- -|-
488
- 1.0.0|all
489
-
490
- 序号|参数名|参数类型|描述
491
- -|-|-|-
492
- 1|shareCode|string|string 分享码
493
- 2|promise|promisecb|promise 执行回调
494
-
495
-
496
- ### getPropertyChartListWithParams
497
-
498
- 获取设备属性图表列表
499
-
500
-
501
-
502
- 起始版本|适用平台
503
- -|-
504
- 1.1.0|all
505
-
506
- 序号|参数名|参数类型|描述
507
- -|-|-|-
508
- 1|params|object|productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>countType 聚合类型(默认3):1-最大值 2-最小值 3-平均值 4-差值 5-总值<br>timeGranularity 统计时间粒度(默认2):1-月 2-日 3-小时 4-分钟 5-秒<br>callback {"data": []}
509
- 2|promise|promisecb|promise 执行回调
510
-
511
-
512
- ### getDeviceShareUserListWithDeviceKey
513
-
514
- 获取设备分享人列表
515
-
516
-
517
-
518
- 起始版本|适用平台
519
- -|-
520
- 1.1.0|all
521
-
522
- 序号|参数名|参数类型|描述
523
- -|-|-|-
524
- 1|deviceKey|string|string 设备名称
525
- 2|productKey|string|string 产品key
526
- 3|promise|promisecb|promise 执行回调
527
-
528
-
529
- ### setShareInfoByOwnerWithDeviceKey
530
-
531
- 分享人设置分享信息
532
-
533
-
534
-
535
- 起始版本|适用平台
536
- -|-
537
- 1.1.0|all
538
-
539
- 序号|参数名|参数类型|描述
540
- -|-|-|-
541
- 1|params|object|deviceKey string 设备key<br>productKey string 产品key<br>acceptingExpireTime number 分享二维码种子失效时间 时间戳(毫秒),表示该分享在此时间戳时间内没有使用,会失效<br>coverMark number 覆盖标志:1 直接覆盖上条有效分享(默认)(覆盖原有的分享码);2 直接添加,允许多条并存;3 只有分享时间延长了,才允许覆盖上条分享<br>isSharingAlwaysValid bool 设备是否永久有效<br>sharingExpireTime number 设备使用到期时间 时间戳(毫秒),表示该分享的设备,被分享人可以使用的时间,isSharingAlwaysValid为YES时该参数无效
542
- 2|promise|promisecb|promise 执行回调
543
-
544
-
545
- ### unShareDeviceByOwnerWithShareCode
546
-
547
- 分享人取消分享
548
-
549
-
550
-
551
- 起始版本|适用平台
552
- -|-
553
- 1.1.0|all
554
-
555
- 序号|参数名|参数类型|描述
556
- -|-|-|-
557
- 1|shareCode|string|string 分享码
558
- 2|promise|promisecb|promise 执行回调
559
-
560
-
561
- ### getLocationHistoryWithParams
562
-
563
- 获取设备历史轨迹
564
-
565
-
566
-
567
- 起始版本|适用平台
568
- -|-
569
- 1.1.0|all
570
-
571
- 序号|参数名|参数类型|描述
572
- -|-|-|-
573
- 1|params|object|productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>locateTypes 定位类型(默认查询所有类型的定位),查询多种定位时使用英文逗号分隔<br>GNSS-全球导航卫星系统<br>GPS-美国导航定位系统<br>GL-俄罗斯格洛纳导航定位系统<br>GA-欧盟伽利略卫星导航系统<br>BD/PQ-中国导航定位系统<br>LBS-基于通信运营商的基站定位系统
574
- 2|promise|promisecb|
575
-
576
-
577
- ### getDeviceInfoByDeviceKey
578
-
579
- 获取设备信息
580
-
581
-
582
-
583
- 起始版本|适用平台
584
- -|-
585
- 1.2.0|all
586
-
587
- 序号|参数名|参数类型|描述
588
- -|-|-|-
589
- 1|deviceKey|string|string 设备key
590
- 2|productKey|string|string 产品key
591
- 3|promise|promisecb|promise 执行回调
592
-
593
-
594
- ### getPropertyDataListWithParams
595
-
596
- 获取设备属性信息
597
-
598
-
599
-
600
- 起始版本|适用平台
601
- -|-
602
- 1.2.0|all
603
-
604
- 序号|参数名|参数类型|描述
605
- -|-|-|-
606
- 1|params|object|map<br>productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>pageNumber 当前页,默认为第 1 页<br>pageSize 页大小,默认为 10 条
607
- 2|promise|promisecb|promise 执行回调
608
-
609
-
610
- ### getPropertyStatisticsWithParams
611
-
612
- 获取设备属性环比统计数据
613
-
614
-
615
-
616
- 起始版本|适用平台
617
- -|-
618
- 1.2.0|all
619
-
620
- 序号|参数名|参数类型|描述
621
- -|-|-|-
622
- 1|params|object|map<br>productKey 产品key<br>deviceKey 设备key<br>currentTimestamp 当前时间(毫秒时间戳<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>countType 聚合类型(默认3):1-最大值 2-最小值 3-平均值 4-差值 5-总值<br>timeGranularities 统计时间粒度,查询多个粒度时使用英文逗号分隔(默认1):1-日 2-周 3-月 4-年<br>callback {"data": []}
623
- 2|promise|promisecb|promise 执行回调
624
-
625
-
626
- ### getDeviceInfoByShareCode
627
-
628
- 通过分享码查询设备信息
629
-
630
-
631
-
632
- 起始版本|适用平台
633
- -|-
634
- 1.3.0|all
635
-
636
- 序号|参数名|参数类型|描述
637
- -|-|-|-
638
- 1|shareCode|string|分享码
639
- 2|promise|promisecb|回调
640
-
641
-
642
- ### getDeviceListByDeviceName
643
-
644
- 获取设备列表-根据设备名称搜索
645
-
646
-
647
-
648
- 起始版本|适用平台
649
- -|-
650
- 1.3.0|all
651
-
652
- 序号|参数名|参数类型|描述
653
- -|-|-|-
654
- 1|deviceName|string|设备名称
655
- 2|pageNumber|integer|number 页码
656
- 3|pageSize|integer|number 页大小
657
- 4|promise|promisecb|回调 callback {"data": {"list" : [], "total" : 12}}
658
-
659
-
660
- ### bindDeviceBySerialNumber
661
-
662
- 通过SN绑定设备
663
-
664
-
665
-
666
- 起始版本|适用平台
667
- -|-
668
- 1.3.0|all
669
-
670
- 序号|参数名|参数类型|描述
671
- -|-|-|-
672
- 1|serialNumber|string|string 设备SN码
673
- 2|productKey|string|string 产品key
674
- 3|deviceName|string|string 设备名称
675
- 4|promise|promisecb|回调 callback
676
-
677
-
678
- ### bindDeviceByAuthCode
679
-
680
- 通过authCode绑定设备
681
- 可用于wifi/wifi+蓝牙设备绑定
682
-
683
-
684
-
685
- 起始版本|适用平台
686
- -|-
687
- 1.3.0|all
688
-
689
- 序号|参数名|参数类型|描述
690
- -|-|-|-
691
- 1|params|object|Map 包含以下属性<br>authCode string 设备authCode<br>productKey string 产品key<br>deviceKey string 设备key<br>deviceName string 设备名称
692
- 2|promise|promisecb|回调 callback
693
-
694
-
695
- ### bindDeviceByPSWAuthCode
696
-
697
- 通过authCode + password绑定设备
698
- 可用于蓝牙设备绑定
699
-
700
-
701
-
702
- 起始版本|适用平台
703
- -|-
704
- 1.3.0|all
705
-
706
- 序号|参数名|参数类型|描述
707
- -|-|-|-
708
- 1|params|object|Map 包含以下属性<br>authCode string 设备authCode<br>productKey string 产品key<br>deviceKey string 设备key<br>password string 设备password<br>deviceName string 设备名称
709
- 2|promise|promisecb|回调 callback
710
-
711
-
712
- ### getFetchPlanWithProductKey
713
-
714
- 查询设备升级信息
715
-
716
-
717
-
718
- 起始版本|适用平台
719
- -|-
720
- 1.3.0|all
721
-
722
- 序号|参数名|参数类型|描述
723
- -|-|-|-
724
- 1|productKey|string|string 产品key
725
- 2|deviceKey|string|string 设备key
726
- 3|params|object|map 其他信息 非必传<br>batteryLevelLimit number 设备剩余电量百分比<br>mcuVersions array 固件信息 componentNo string 升级组件标识 version string 升级组件版本<br>minSignalIntensity number 设备最小信号量 dbM<br>moduleVersion string 模组版本<br>upgradeTime number 升级时间时间戳,默认为当前时间戳<br>useSpace number 所需磁盘空间,KB<br>{'batteryLevelLimit':1, 'mcuVersions':[{'componentNo': '', 'version': ''}], 'minSignalIntensity':1, 'moduleVersion':'', 'upgradeTime':1, 'useSpace':1}
727
- 4|promise|promisecb|回调 callback
728
-
729
-
730
- ### reportDeviceUpgradeStatusWithProductKey
731
-
732
- 上报设备升级信息
733
-
734
-
735
-
736
- 起始版本|适用平台
737
- -|-
738
- 1.3.0|all
739
-
740
- 序号|参数名|参数类型|描述
741
- -|-|-|-
742
- 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>componentNo string 升级固件标识<br>reportStatus number 升级状态 0 - 1 2
743
- 2|promise|promisecb|回调 callback
744
-
745
-
746
- ### sendDataToDevicesByHttpWithData
747
-
748
- 设备批量控制
749
-
750
-
751
-
752
- 起始版本|适用平台
753
- -|-
754
- 1.3.0|all
755
-
756
- 序号|参数名|参数类型|描述
757
- -|-|-|-
758
- 1|params|object|Map<br>data 遵循tsl格式的json string [{"id":62,"value":99,"type":"INT","name":"温度(temp)"},{"id":63,"value":"true","type":"BOOL","name":"开关机状态(powerstate)"}]<br>deviceList 设备列表 [{"deviceKey":"", "productKey":""}]<br>type number 类型 1:透传 2:属性 3:服务<br>dataFormat number 数据类型 1:Hex 2:Text(当type为透传时,需要指定 dataFormat)<br>cacheTime number 非必传 缓存时间,单位为秒,缓存时间范围 1-7776000 秒,启用缓存时必须设置缓存时间<br>isCache number 非必传 是否启用缓存 1:启用 2:不启用,默认不启用<br>isCover number 非必传 是否覆盖之前发送的相同的命令 1:覆盖 2:不覆盖,默认不覆盖,启用缓存时此参数有效
759
- 2|promise|promisecb|回调 callback
760
-
761
-
762
- ### addCornJob
763
-
764
- 创建定时任务
765
-
766
-
767
-
768
- 起始版本|适用平台
769
- -|-
770
- 1.3.0|all
771
-
772
- 序号|参数名|参数类型|描述
773
- -|-|-|-
774
- 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>timers:[{<br>action – string 必传 定时任务执行的命令,格式:物模型的 json 字符串,<br>time – string 非必传 执行时间,格式为 HH:mm:ss, 当 type = once || day-repeat || custom-repeat ||<br>multi-section 时必填,<br>startTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>endTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>delay – number 非必传 延迟执行时间,单位为秒, 当 type = delay 时必填,单位为 s<br>}]<br>enabled – 定时任务状态:false-停止(默认) true-启动<br>dayOfWeek – string 非必传 周几执行:1-周一 2-周二 3-周三 4-周四 5-周五 6-周六 7-周日, 可以多选,传多个值时使用英文逗号分隔, 当 type = custom-repeat || multi-section || random 时必填
775
- 2|promise|promisecb|回调 callback {"data": {}}
776
-
777
-
778
- ### setCronJob
779
-
780
- 修改定时任务
781
-
782
-
783
-
784
- 起始版本|适用平台
785
- -|-
786
- 1.3.0|all
787
-
788
- 序号|参数名|参数类型|描述
789
- -|-|-|-
790
- 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>ruleId – string 必传 规则唯一标识,修改规则实例信息时必填<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>timers:[{<br>action – string 必传 定时任务执行的命令,格式:物模型的 json 字符串,<br>time – string 非必传 执行时间,格式为 HH:mm:ss, 当 type = once || day-repeat || custom-repeat ||<br>multi-section 时必填,<br>startTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>endTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>delay – number 非必传 延迟执行时间,单位为秒, 当 type = delay 时必填,单位为 s<br>}]<br>enabled – 定时任务状态:false-停止(默认) true-启动<br>dayOfWeek – string 非必传 周几执行:1-周一 2-周二 3-周三 4-周四 5-周五 6-周六 7-周日, 可以多选,传多个值时使用英文逗号分隔, 当 type = custom-repeat || multi-section || random 时必填
791
- 2|promise|promisecb|回调 callback {"data": {}}
792
-
793
-
794
- ### getCronJobList
795
-
796
- 查询设备下定时任务列表
797
-
798
-
799
-
800
- 起始版本|适用平台
801
- -|-
802
- 1.3.0|all
803
-
804
- 序号|参数名|参数类型|描述
805
- -|-|-|-
806
- 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>page – number 分页页码,默认: 1<br>pageSize – number 分页大小,默认: 10
807
- 2|promise|promisecb|回调 callback {"data": {"list" : [], "total" : 12}}
808
-
809
-
810
- ### getCronJobInfo
811
-
812
- 查询定时任务详情
813
-
814
-
815
-
816
- 起始版本|适用平台
817
- -|-
818
- 1.3.0|all
819
-
820
- 序号|参数名|参数类型|描述
821
- -|-|-|-
822
- 1|ruleId|string|– string 必传 定时任务ID
823
- 2|promise|promisecb|回调 callback {"data": {}}
824
-
825
-
826
- ### batchDeleteCronJob
827
-
828
- 批量删除定时任务
829
-
830
-
831
-
832
- 起始版本|适用平台
833
- -|-
834
- 1.3.0|all
835
-
836
- 序号|参数名|参数类型|描述
837
- -|-|-|-
838
- 1|params|object|– {ruleIdList:[] String[] 必传 定时任务ID}
839
- 2|promise|promisecb|回调 callback {"data": {}}
840
-
841
-
842
- ### getProductCornJobLimit
843
-
844
- 查询产品下定时任务限制数
845
-
846
-
847
-
848
- 起始版本|适用平台
849
- -|-
850
- 1.3.0|all
851
-
852
- 序号|参数名|参数类型|描述
853
- -|-|-|-
854
- 1|productKey|string|– string 必传 产品key
855
- 2|promise|promisecb|回调callback {"data": {}}
856
-
857
-
858
- ### openWebSocket
859
-
860
- 打开websocket
861
-
862
-
863
-
864
- 起始版本|适用平台
865
- -|-
866
- 1.3.0|all
867
-
868
-
869
-
870
- ### closeWebSocket
871
-
872
- 关闭websocket
873
-
874
-
875
-
876
- 起始版本|适用平台
877
- -|-
878
- 1.3.0|all
879
-
880
-
881
-
882
- ### getProductTSLWithCacheByProductKey
883
-
884
- 查询产品的tls模型
885
-
886
-
887
-
888
- 起始版本|适用平台
889
- -|-
890
- 1.5.0|all
891
-
892
- 序号|参数名|参数类型|描述
893
- -|-|-|-
894
- 1|param|object|-{productKey:String } --必传
895
- 2|promise|promisecb|-{callback:{data:{}}
896
-
897
-
898
- ### listDeviceEvent
899
-
900
- 门锁事件日志
901
-
902
-
903
-
904
- 起始版本|适用平台
905
- -|-
906
- 1.9.0|all
907
-
908
- 序号|参数名|参数类型|描述
909
- -|-|-|-
910
- 1|params|object|{codeList:["",""],productKey:"",deviceKey:"",startTime:long,endTime:long,pageNumber:1,pageSize:10}
911
- 2|promise|promisecb|
912
-
913
-
914
- ### unShareDeviceByShareUserWithShareCodeIpc `弃用`
915
-
916
- 设备解绑
917
-
918
-
919
- > 该方法已弃用并不再维护,如遇问题请联系开发者
920
-
921
-
922
- 起始版本|适用平台
923
- -|-
924
- 1.9.6|all
925
-
926
- 序号|参数名|参数类型|描述
927
- -|-|-|-
928
- 1|pk|string|string 产品id
929
- 2|dk|string|string 设备id
930
- 3|shareCode|string|string 分享码
931
- 4|promise|promisecb|promise 执行回调
932
-
933
-
934
- ## 事件
935
-
936
-
937
- ### onDeviceConnectingState
938
-
939
- 设备链路连接状态状态通知
940
-
941
-
942
-
943
- 起始版本|适用平台
944
- -|-
945
- 1.8.0|all
946
-
947
- 参数类型|描述
948
- -|-
949
- object|事件数据 {"connectingState": 0/1/2/3/4/5/6/7}<br>connectingStateMaskWS = 1 << 0,<br>connectingStateMaskWifi = 1 << 1,<br>connectingStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
950
-
951
-
952
- ### onDeviceOnlineState
953
-
954
- 设备在离线状态通知
955
-
956
-
957
-
958
- 起始版本|适用平台
959
- -|-
960
- 1.4.0|all
961
-
962
- 参数类型|描述
963
- -|-
964
- object|事件数据 {"onlineState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
965
-
966
-
967
- ### onDeviceDpsUpdate
968
-
969
- 设备dps更新
970
-
971
-
972
-
973
- 起始版本|适用平台
974
- -|-
975
- 1.4.0|all
976
-
977
- 参数类型|描述
978
- -|-
979
- object|事件数据 {<br>type: (1:ws 2: wifi 3: ble,)<br>pk: "xxxx",<br>dk: "xxxx",<br>"dps": [{id: 0, type:BOOL, value, true/false},{id: 1, type:INT, value, 1}, ...]<br>}
980
-
981
-
982
- ### onDeviceInfoUpdate
983
-
984
- 设备信息更新
985
-
986
-
987
-
988
- 起始版本|适用平台
989
- -|-
990
- 1.4.0|all
991
-
992
- 参数类型|描述
993
- -|-
994
- object|事件数据
995
-
996
-
997
- ### onWebSocketDidOpen
998
-
999
- WebSocket 已打开事件
1000
-
1001
-
1002
-
1003
- 起始版本|适用平台
1004
- -|-
1005
- 1.0.0|all
1006
-
1007
- 参数类型|描述
1008
- -|-
1009
- object|事件数据 data = {"code":"this is code", @"message":" this is reason"}<br>reminder.data = {}
1010
-
1011
-
1012
- ### onWebSocketDidError
1013
-
1014
- WebSocket 错误事件
1015
-
1016
-
1017
-
1018
- 起始版本|适用平台
1019
- -|-
1020
- 1.0.0|all
1021
-
1022
- 参数类型|描述
1023
- -|-
1024
- object|事件数据 data = {"code":"this is code", @"message":" this is reason"}
1025
-
1026
-
1027
- ### onWebSocketDidReceiveMessage
1028
-
1029
- WebSocket 消息事件
1030
-
1031
-
1032
-
1033
- 起始版本|适用平台
1034
- -|-
1035
- 1.0.0|all
1036
-
1037
- 参数类型|描述
1038
- -|-
1039
- object|事件数据<br>object.data = {<br>"cmd": "message",<br>"data": {<br>"createdAt": 1609316592000,<br>"data": {<br>"value": 1<br>},<br>"deviceKey": "866123456789015",<br>"productKey": "123456",<br>"ticket": "5f9924d171977c33bc5ad1b1",<br>"type": "ONLINE"<br>}<br>}<br>error<br>{<br>cmd = error;<br>data = {<br>code = 4010;<br>msg = "user not logged in";<br>reqMsg = "";<br>};
1040
-
1041
-
1042
-
1043
-
1
+ # QuecRNDeviceModule
2
+
3
+ 设备桥组件
4
+
5
+
6
+
7
+ 类型|版本|适用平台|负责人
8
+ -|-|-|-
9
+ module|3.2.0|all|vic.huang@quectel.com
10
+
11
+ > **3.2.0 Changelog:**
12
+ > none
13
+
14
+
15
+ ## 方法
16
+
17
+
18
+ ### isWebSocketSubscribe
19
+
20
+ 获取当前设备WS订阅通道状态,订阅状态为true,不代表设备在线,只代表app和云端对当前设备进行了订阅
21
+
22
+
23
+
24
+ 起始版本|适用平台
25
+ -|-
26
+ 1.8.0|all
27
+
28
+ 序号|参数名|参数类型|描述
29
+ -|-|-|-
30
+ 1|promise|promisecb|回调 callback {"subscribe": true/false }
31
+
32
+
33
+ ### getDeviceConnectingState
34
+
35
+ 获取设备通道连接中状态
36
+
37
+
38
+
39
+ 起始版本|适用平台
40
+ -|-
41
+ 1.8.0|all
42
+
43
+ 序号|参数名|参数类型|描述
44
+ -|-|-|-
45
+ 1|promise|promisecb|回调 callback {"connectingState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
46
+
47
+
48
+ ### writeDpsByHttp
49
+
50
+ writeDpsByHttp
51
+
52
+
53
+
54
+ 起始版本|适用平台
55
+ -|-
56
+ 1.8.0|all
57
+
58
+ 序号|参数名|参数类型|描述
59
+ -|-|-|-
60
+ 1|dps|Array&lt;object&gt;|– dps 确保code和value不为空 [ {id:0, code:"electric" type:BOOL, value:false} ,{id:1, code:"electric2", type:INT, value:2}]
61
+ 2|deviceList|Array&lt;object&gt;|– deviceList 设备列表 [{"deviceKey":"", "productKey":""}]
62
+ 3|type|integer|- 类型 1:透传 2:属性 3:服务
63
+ 4|extraData|object|– {<br>dataFormat 数据类型 1:Hex 2:Text(当type为透传时,需要指定 dataFormat)<br>cacheTime 缓存时间,单位为秒,缓存时间范围 1-7776000 秒,启用缓存时必须设置缓存时间<br>isCache 是否启用缓存 1:启用 2:不启用,默认不启用<br>isCover 是否覆盖之前发送的相同的命令 1:覆盖 2:不覆盖,默认不覆盖,启用缓存时此参数有效<br><br>查看接口定义<br>}
64
+ 5|promise|promisecb|回调 callback
65
+
66
+
67
+ ### readDpsWithExtraData
68
+
69
+ read data points
70
+
71
+
72
+
73
+ 起始版本|适用平台
74
+ -|-
75
+ 1.6.8|all
76
+
77
+ 序号|参数名|参数类型|描述
78
+ -|-|-|-
79
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
80
+ 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
81
+ 3|promise|promisecb|回调 callback
82
+
83
+
84
+ ### readDpsWithExtraDataAndMode
85
+
86
+ read data points
87
+
88
+
89
+
90
+ 起始版本|适用平台
91
+ -|-
92
+ 1.6.8|all
93
+
94
+ 序号|参数名|参数类型|描述
95
+ -|-|-|-
96
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
97
+ 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
98
+ 3|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
99
+ 4|promise|promisecb|回调 callback
100
+
101
+
102
+ ### writeDpsWithExtraData
103
+
104
+ write data points
105
+
106
+
107
+
108
+ 起始版本|适用平台
109
+ -|-
110
+ 1.6.8|all
111
+
112
+ 序号|参数名|参数类型|描述
113
+ -|-|-|-
114
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
115
+ 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
116
+ 3|promise|promisecb|回调 callback
117
+
118
+
119
+ ### writeDpsWithExtraDataAndMode
120
+
121
+ write data points
122
+
123
+
124
+
125
+ 起始版本|适用平台
126
+ -|-
127
+ 1.6.8|all
128
+
129
+ 序号|参数名|参数类型|描述
130
+ -|-|-|-
131
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
132
+ 2|extraData|object|– map<br>cacheTime number 指令缓存时间,ws通道有效,单位是s<br>msgId number 消息Id,ws通道有效
133
+ 3|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
134
+ 4|promise|promisecb|回调 callback
135
+
136
+
137
+ ### getBleState
138
+
139
+ 获取设备通道状态
140
+
141
+
142
+
143
+ 起始版本|适用平台
144
+ -|-
145
+ 1.4.0|all
146
+
147
+ 序号|参数名|参数类型|描述
148
+ -|-|-|-
149
+ 1|promise|promisecb|回调 callback {"state": 0/1/2}<br>(0: 未开启, 1: 未授权, 2 : 可用)
150
+
151
+
152
+ ### getTslAndAttrs
153
+
154
+ 获取物模型以及属性值
155
+
156
+
157
+
158
+ 起始版本|适用平台
159
+ -|-
160
+ 2.16.0|all
161
+
162
+ 序号|参数名|参数类型|描述
163
+ -|-|-|-
164
+ 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>gatewayDk string 网关设备的 Device Key<br>gatewayPk string 网关设备的 Product Key<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br><br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔<br><br>filterType 过滤类型<br>0: 仅获取属性定义(默认行为)<br>1: 获取属性和事件定义<br>2: 获取属性,事件和服务定义 (为后续预留)
165
+ 2|promise|promisecb|promise 执行回调
166
+
167
+
168
+ ### readDps
169
+
170
+ read data points
171
+
172
+
173
+
174
+ 起始版本|适用平台
175
+ -|-
176
+ 1.4.0|all
177
+
178
+ 序号|参数名|参数类型|描述
179
+ -|-|-|-
180
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
181
+ 2|promise|promisecb|回调 callback
182
+
183
+
184
+ ### writeDps
185
+
186
+ write data points
187
+
188
+
189
+
190
+ 起始版本|适用平台
191
+ -|-
192
+ 1.4.0|all
193
+
194
+ 序号|参数名|参数类型|描述
195
+ -|-|-|-
196
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
197
+ 2|promise|promisecb|回调 callback
198
+
199
+
200
+ ### writeTransparent
201
+
202
+ write transparent data
203
+
204
+
205
+
206
+ 起始版本|适用平台
207
+ -|-
208
+ 1.7.0|all
209
+
210
+ 序号|参数名|参数类型|描述
211
+ -|-|-|-
212
+ 1|data|string|透传数据, 二进制base64转换的字符串
213
+ 2|mode|integer|发送模式
214
+ 3|extraData|object|额外参数(预留)
215
+ 4|promise|promisecb|回调callback
216
+
217
+
218
+ ### readDpsWithMode
219
+
220
+ read data points
221
+
222
+
223
+
224
+ 起始版本|适用平台
225
+ -|-
226
+ 1.4.0|all
227
+
228
+ 序号|参数名|参数类型|描述
229
+ -|-|-|-
230
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
231
+ 2|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
232
+ 3|promise|promisecb|回调 callback
233
+
234
+
235
+ ### writeDpsWithMode
236
+
237
+ write data points
238
+
239
+
240
+
241
+ 起始版本|适用平台
242
+ -|-
243
+ 1.4.0|all
244
+
245
+ 序号|参数名|参数类型|描述
246
+ -|-|-|-
247
+ 1|dps|Array&lt;object&gt;|– dps [ {id:0, type:BOOL, value:false} ,{id:1, type:INT, value:2}]
248
+ 2|mode|integer|– mode 下发模式: 0 auto,1: websocket 2:wifi 3:ble
249
+ 3|promise|promisecb|回调 callback
250
+
251
+
252
+ ### getOnlineState
253
+
254
+ 获取设备通道状态
255
+
256
+
257
+
258
+ 起始版本|适用平台
259
+ -|-
260
+ 1.4.0|all
261
+
262
+ 序号|参数名|参数类型|描述
263
+ -|-|-|-
264
+ 1|promise|promisecb|回调 callback {"onlineState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
265
+
266
+
267
+ ### connectChannel
268
+
269
+ 建立通道,(设备会自动根据设备通道能力capabilitiesBitmask建立通道,此API用于手动切换指定通道)
270
+
271
+
272
+
273
+ 起始版本|适用平台
274
+ -|-
275
+ 1.4.0|all
276
+
277
+ 序号|参数名|参数类型|描述
278
+ -|-|-|-
279
+ 1|mode|integer|– mode 建立通道模式: 0 auto,1: websocket 2:wifi 3:ble<br>注意:1,建立的通通与已连接通道不同时,已连接通道会断开。<br>2,当设备不具备相应通道,建立其不具备的通道会失败。不会再自动建立其他通道
280
+
281
+
282
+ ### disconnectChannel
283
+
284
+ 断开通道,(
285
+
286
+
287
+
288
+ 起始版本|适用平台
289
+ -|-
290
+ 1.4.0|all
291
+
292
+ 序号|参数名|参数类型|描述
293
+ -|-|-|-
294
+ 1|type|integer|– type 通道类型,0: 关闭所有通道(关闭wifi和ble), 2:wifi 3:ble
295
+
296
+
297
+ ### isWebSocketLoginCallback `弃用`
298
+
299
+ 获取websocket是否登录成功
300
+
301
+
302
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
303
+
304
+
305
+ 起始版本|适用平台
306
+ -|-
307
+ 1.0.0|all
308
+
309
+ 序号|参数名|参数类型|描述
310
+ -|-|-|-
311
+ 1|isLoginCallback|successcb|Func 接受是否登录websocket回调 已登录成功 true 登录失败 false
312
+
313
+
314
+ ### subscribeDevicesWithList `弃用`
315
+
316
+ 订阅设备
317
+
318
+
319
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
320
+
321
+
322
+ 起始版本|适用平台
323
+ -|-
324
+ 1.0.0|all
325
+
326
+ 序号|参数名|参数类型|描述
327
+ -|-|-|-
328
+ 1|list|Array&lt;object&gt;|订阅设备列表,订阅结果QuecDeviceServiceWebSocketDelegate返回<br>[<br>{<br>"deviceKey": "1234567890",<br>"messageType": [<br>"ONLINE"<br>],<br>"productKey": "p12345"<br>},<br>{<br>"deviceKey": "1234567890",<br>"messageType": [<br>"ONLINE",<br>"STATUS"<br>],<br>"productKey": "p12345"<br>}<br>]
329
+
330
+
331
+ ### unSubscribeDevicesWithList `弃用`
332
+
333
+ 取消订阅设备
334
+
335
+
336
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
337
+
338
+
339
+ 起始版本|适用平台
340
+ -|-
341
+ 1.0.0|all
342
+
343
+ 序号|参数名|参数类型|描述
344
+ -|-|-|-
345
+ 1|list|Array&lt;object&gt;|取消订阅设备列表,取消订阅结果QuecDeviceServiceWebSocketDelegate返回<br>[<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345"<br>},<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345"<br>}<br>]
346
+
347
+
348
+ ### sendDataToDeviceByWebSocketWithDataDict `弃用`
349
+
350
+ 获取设备业务属性值
351
+
352
+
353
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
354
+
355
+
356
+ 起始版本|适用平台
357
+ -|-
358
+ 1.0.0|all
359
+
360
+ 序号|参数名|参数类型|描述
361
+ -|-|-|-
362
+ 1|params|object|发送数据,需要在delegate的websocketDidOpen回调之后才能调用<br>透传<br>{<br>"cmd": "send",<br>"data": {<br>"cacheTime": 3600,<br>"dataFormat": "Text",<br>"deviceKey": "866123456789015",<br>"isCache": true,<br>"productKey": "p12345",<br>"raw": "123456",<br>"type": "RAW"<br>}<br>}<br>物模型<br>{<br>"cmd": "send",<br>"data": {<br>"deviceKey": "1234567890",<br>"kv": "[{\"id\":5,\"name\":\"openapi\",\"type\":\"BOOL\",\"value\":\"true\"}]",<br>"productKey": "p12345",<br>"type": "WRITE-ATTR"<br>}<br>}
363
+
364
+
365
+ ### getDeviceListWithPageNumber `弃用`
366
+
367
+ 获取设备列表
368
+
369
+
370
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
371
+
372
+
373
+ 起始版本|适用平台
374
+ -|-
375
+ 1.0.0|all
376
+
377
+ 序号|参数名|参数类型|描述
378
+ -|-|-|-
379
+ 1|pageNumber|integer|number 页码
380
+ 2|pageSize|integer|number 页大小
381
+ 3|promise|promisecb|promise 执行回调<br>callback {"data": {"list" : [], "total" : 12}}
382
+
383
+
384
+ ### getProductTSLWithProductKey `弃用`
385
+
386
+ 获取设备业务物模型属性值
387
+
388
+
389
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
390
+
391
+
392
+ 起始版本|适用平台
393
+ -|-
394
+ 1.0.0|all
395
+
396
+ 序号|参数名|参数类型|描述
397
+ -|-|-|-
398
+ 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>gatewayDk string 网关设备的 Device Key<br>gatewayPk string 网关设备的 Product Key<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔
399
+ 2|promise|promisecb|promise 执行回调
400
+
401
+
402
+ ### getDeviceBusinessAttributesWithProductKey `弃用`
403
+
404
+ 获取设备业务属性值
405
+
406
+
407
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
408
+
409
+
410
+ 起始版本|适用平台
411
+ -|-
412
+ 1.0.0|all
413
+
414
+ 序号|参数名|参数类型|描述
415
+ -|-|-|-
416
+ 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>codeList string 非必填 查询的属性标识符<br>和查询类型配合使用,如果查询多个属性,使用英文逗号分隔<br>type string 非必填 查询类型<br>1 查询设备基础属性<br>2 查询物模型属性<br>3 查询定位信息<br>查询类型可以单选和多选,如果需要查询多个类型的属性值,使用英文逗号分隔
417
+ 2|promise|promisecb|promise 执行回调
418
+
419
+
420
+ ### updateDeviceNameByShareUserWithDeviceName `弃用`
421
+
422
+ 更改分享设备名称
423
+
424
+
425
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
426
+
427
+
428
+ 起始版本|适用平台
429
+ -|-
430
+ 1.0.0|all
431
+
432
+ 序号|参数名|参数类型|描述
433
+ -|-|-|-
434
+ 1|deviceName|string|string 设备名称
435
+ 2|shareCode|string|string 分享码
436
+ 3|promise|promisecb|promise 执行回调
437
+
438
+
439
+ ### updateDeviceName `弃用`
440
+
441
+ 更改分享设备名称
442
+
443
+
444
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
445
+
446
+
447
+ 起始版本|适用平台
448
+ -|-
449
+ 1.0.0|all
450
+
451
+ 序号|参数名|参数类型|描述
452
+ -|-|-|-
453
+ 1|deviceName|string|string deviceName
454
+ 2|productKey|string|string product key
455
+ 3|deviceKey|string|string deviceKey
456
+ 4|promise|promisecb|promise 执行回调
457
+
458
+
459
+ ### getGatewayDeviceChildListWithParams `弃用`
460
+
461
+ 查询网关设备下子设备列表
462
+
463
+
464
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
465
+
466
+
467
+ 起始版本|适用平台
468
+ -|-
469
+ 1.0.0|all
470
+
471
+ 序号|参数名|参数类型|描述
472
+ -|-|-|-
473
+ 1|params|object|deviceKey string 必传 网关设备deviceKey<br>productKey string 必传 网关设备productKey<br>pageNumber number 必传 页码<br>pageSize number 必传 页大小
474
+ 2|promise|promisecb|promise 执行回调<br>callback {"data": {"list" : [], "total" : 12}}
475
+
476
+
477
+ ### unbindDeviceWithDeviceKey `弃用`
478
+
479
+ 设备解绑
480
+
481
+
482
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
483
+
484
+
485
+ 起始版本|适用平台
486
+ -|-
487
+ 1.0.0|all
488
+
489
+ 序号|参数名|参数类型|描述
490
+ -|-|-|-
491
+ 1|deviceKey|string|string device key
492
+ 2|productKey|string|string product key
493
+ 3|promise|promisecb|promise 执行回调
494
+
495
+
496
+ ### unShareDeviceByShareUserWithShareCode `弃用`
497
+
498
+ 设备解绑
499
+
500
+
501
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
502
+
503
+
504
+ 起始版本|适用平台
505
+ -|-
506
+ 1.0.0|all
507
+
508
+ 序号|参数名|参数类型|描述
509
+ -|-|-|-
510
+ 1|shareCode|string|string 分享码
511
+ 2|promise|promisecb|promise 执行回调
512
+
513
+
514
+ ### getPropertyChartListWithParams
515
+
516
+ 获取设备属性图表列表
517
+
518
+
519
+
520
+ 起始版本|适用平台
521
+ -|-
522
+ 1.1.0|all
523
+
524
+ 序号|参数名|参数类型|描述
525
+ -|-|-|-
526
+ 1|params|object|productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>countType 聚合类型(默认3):1-最大值 2-最小值 3-平均值 4-差值 5-总值<br>timeGranularity 统计时间粒度(默认2):1-月 2-日 3-小时 4-分钟 5-秒<br>callback {"data": []}
527
+ 2|promise|promisecb|promise 执行回调
528
+
529
+
530
+ ### getDeviceShareUserListWithDeviceKey
531
+
532
+ 获取设备分享人列表
533
+
534
+
535
+
536
+ 起始版本|适用平台
537
+ -|-
538
+ 1.1.0|all
539
+
540
+ 序号|参数名|参数类型|描述
541
+ -|-|-|-
542
+ 1|deviceKey|string|string 设备名称
543
+ 2|productKey|string|string 产品key
544
+ 3|promise|promisecb|promise 执行回调
545
+
546
+
547
+ ### setShareInfoByOwnerWithDeviceKey
548
+
549
+ 分享人设置分享信息
550
+
551
+
552
+
553
+ 起始版本|适用平台
554
+ -|-
555
+ 1.1.0|all
556
+
557
+ 序号|参数名|参数类型|描述
558
+ -|-|-|-
559
+ 1|params|object|deviceKey string 设备key<br>productKey string 产品key<br>acceptingExpireTime number 分享二维码种子失效时间 时间戳(毫秒),表示该分享在此时间戳时间内没有使用,会失效<br>coverMark number 覆盖标志:1 直接覆盖上条有效分享(默认)(覆盖原有的分享码);2 直接添加,允许多条并存;3 只有分享时间延长了,才允许覆盖上条分享<br>isSharingAlwaysValid bool 设备是否永久有效<br>sharingExpireTime number 设备使用到期时间 时间戳(毫秒),表示该分享的设备,被分享人可以使用的时间,isSharingAlwaysValid为YES时该参数无效
560
+ 2|promise|promisecb|promise 执行回调
561
+
562
+
563
+ ### unShareDeviceByOwnerWithShareCode
564
+
565
+ 分享人取消分享
566
+
567
+
568
+
569
+ 起始版本|适用平台
570
+ -|-
571
+ 1.1.0|all
572
+
573
+ 序号|参数名|参数类型|描述
574
+ -|-|-|-
575
+ 1|shareCode|string|string 分享码
576
+ 2|promise|promisecb|promise 执行回调
577
+
578
+
579
+ ### getLocationHistoryWithParams
580
+
581
+ 获取设备历史轨迹
582
+
583
+
584
+
585
+ 起始版本|适用平台
586
+ -|-
587
+ 1.1.0|all
588
+
589
+ 序号|参数名|参数类型|描述
590
+ -|-|-|-
591
+ 1|params|object|productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>locateTypes 定位类型(默认查询所有类型的定位),查询多种定位时使用英文逗号分隔<br>GNSS-全球导航卫星系统<br>GPS-美国导航定位系统<br>GL-俄罗斯格洛纳导航定位系统<br>GA-欧盟伽利略卫星导航系统<br>BD/PQ-中国导航定位系统<br>LBS-基于通信运营商的基站定位系统
592
+ 2|promise|promisecb|
593
+
594
+
595
+ ### getDeviceInfoByDeviceKey
596
+
597
+ 获取设备信息
598
+
599
+
600
+
601
+ 起始版本|适用平台
602
+ -|-
603
+ 1.2.0|all
604
+
605
+ 序号|参数名|参数类型|描述
606
+ -|-|-|-
607
+ 1|deviceKey|string|string 设备key
608
+ 2|productKey|string|string 产品key
609
+ 3|promise|promisecb|promise 执行回调
610
+
611
+
612
+ ### getPropertyDataListWithParams
613
+
614
+ 获取设备属性信息
615
+
616
+
617
+
618
+ 起始版本|适用平台
619
+ -|-
620
+ 1.2.0|all
621
+
622
+ 序号|参数名|参数类型|描述
623
+ -|-|-|-
624
+ 1|params|object|map<br>productKey 产品key<br>deviceKey 设备key<br>startTimestamp 开始时间(毫秒时间戳)<br>endTimestamp 结束时间(毫秒时间戳)<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>pageNumber 当前页,默认为第 1 页<br>pageSize 页大小,默认为 10 条
625
+ 2|promise|promisecb|promise 执行回调
626
+
627
+
628
+ ### getPropertyStatisticsWithParams
629
+
630
+ 获取设备属性环比统计数据
631
+
632
+
633
+
634
+ 起始版本|适用平台
635
+ -|-
636
+ 1.2.0|all
637
+
638
+ 序号|参数名|参数类型|描述
639
+ -|-|-|-
640
+ 1|params|object|map<br>productKey 产品key<br>deviceKey 设备key<br>currentTimestamp 当前时间(毫秒时间戳<br>attributeCode 物模型属性标识符,查询多个属性时使用英文逗号分隔<br>gatewayDk 网关设备的 Device Key<br>gatewayPk 网关设备的 Product Key<br>countType 聚合类型(默认3):1-最大值 2-最小值 3-平均值 4-差值 5-总值<br>timeGranularities 统计时间粒度,查询多个粒度时使用英文逗号分隔(默认1):1-日 2-周 3-月 4-年<br>callback {"data": []}
641
+ 2|promise|promisecb|promise 执行回调
642
+
643
+
644
+ ### getDeviceInfoByShareCode
645
+
646
+ 通过分享码查询设备信息
647
+
648
+
649
+
650
+ 起始版本|适用平台
651
+ -|-
652
+ 1.3.0|all
653
+
654
+ 序号|参数名|参数类型|描述
655
+ -|-|-|-
656
+ 1|shareCode|string|分享码
657
+ 2|promise|promisecb|回调
658
+
659
+
660
+ ### getDeviceListByDeviceName
661
+
662
+ 获取设备列表-根据设备名称搜索
663
+
664
+
665
+
666
+ 起始版本|适用平台
667
+ -|-
668
+ 1.3.0|all
669
+
670
+ 序号|参数名|参数类型|描述
671
+ -|-|-|-
672
+ 1|deviceName|string|设备名称
673
+ 2|pageNumber|integer|number 页码
674
+ 3|pageSize|integer|number 页大小
675
+ 4|promise|promisecb|回调 callback {"data": {"list" : [], "total" : 12}}
676
+
677
+
678
+ ### bindDeviceBySerialNumber
679
+
680
+ 通过SN绑定设备
681
+
682
+
683
+
684
+ 起始版本|适用平台
685
+ -|-
686
+ 1.3.0|all
687
+
688
+ 序号|参数名|参数类型|描述
689
+ -|-|-|-
690
+ 1|serialNumber|string|string 设备SN码
691
+ 2|productKey|string|string 产品key
692
+ 3|deviceName|string|string 设备名称
693
+ 4|promise|promisecb|回调 callback
694
+
695
+
696
+ ### bindDeviceByAuthCode
697
+
698
+ 通过authCode绑定设备
699
+ 可用于wifi/wifi+蓝牙设备绑定
700
+
701
+
702
+
703
+ 起始版本|适用平台
704
+ -|-
705
+ 1.3.0|all
706
+
707
+ 序号|参数名|参数类型|描述
708
+ -|-|-|-
709
+ 1|params|object|Map 包含以下属性<br>authCode string 设备authCode<br>productKey string 产品key<br>deviceKey string 设备key<br>deviceName string 设备名称
710
+ 2|promise|promisecb|回调 callback
711
+
712
+
713
+ ### bindDeviceByPSWAuthCode
714
+
715
+ 通过authCode + password绑定设备
716
+ 可用于蓝牙设备绑定
717
+
718
+
719
+
720
+ 起始版本|适用平台
721
+ -|-
722
+ 1.3.0|all
723
+
724
+ 序号|参数名|参数类型|描述
725
+ -|-|-|-
726
+ 1|params|object|Map 包含以下属性<br>authCode string 设备authCode<br>productKey string 产品key<br>deviceKey string 设备key<br>password string 设备password<br>deviceName string 设备名称
727
+ 2|promise|promisecb|回调 callback
728
+
729
+
730
+ ### getFetchPlanWithProductKey
731
+
732
+ 查询设备升级信息
733
+
734
+
735
+
736
+ 起始版本|适用平台
737
+ -|-
738
+ 1.3.0|all
739
+
740
+ 序号|参数名|参数类型|描述
741
+ -|-|-|-
742
+ 1|productKey|string|string 产品key
743
+ 2|deviceKey|string|string 设备key
744
+ 3|params|object|map 其他信息 非必传<br>batteryLevelLimit number 设备剩余电量百分比<br>mcuVersions array 固件信息 componentNo string 升级组件标识 version string 升级组件版本<br>minSignalIntensity number 设备最小信号量 dbM<br>moduleVersion string 模组版本<br>upgradeTime number 升级时间时间戳,默认为当前时间戳<br>useSpace number 所需磁盘空间,KB<br>{'batteryLevelLimit':1, 'mcuVersions':[{'componentNo': '', 'version': ''}], 'minSignalIntensity':1, 'moduleVersion':'', 'upgradeTime':1, 'useSpace':1}
745
+ 4|promise|promisecb|回调 callback
746
+
747
+
748
+ ### reportDeviceUpgradeStatusWithProductKey
749
+
750
+ 上报设备升级信息
751
+
752
+
753
+
754
+ 起始版本|适用平台
755
+ -|-
756
+ 1.3.0|all
757
+
758
+ 序号|参数名|参数类型|描述
759
+ -|-|-|-
760
+ 1|params|object|map<br>productKey string 产品key<br>deviceKey string 设备key<br>componentNo string 升级固件标识<br>reportStatus number 升级状态 0 - 1 2
761
+ 2|promise|promisecb|回调 callback
762
+
763
+
764
+ ### sendDataToDevicesByHttpWithData
765
+
766
+ 设备批量控制
767
+
768
+
769
+
770
+ 起始版本|适用平台
771
+ -|-
772
+ 1.3.0|all
773
+
774
+ 序号|参数名|参数类型|描述
775
+ -|-|-|-
776
+ 1|params|object|Map<br>data 遵循tsl格式的json string [{"id":62,"value":99,"type":"INT","name":"温度(temp)"},{"id":63,"value":"true","type":"BOOL","name":"开关机状态(powerstate)"}]<br>deviceList 设备列表 [{"deviceKey":"", "productKey":""}]<br>type number 类型 1:透传 2:属性 3:服务<br>dataFormat number 数据类型 1:Hex 2:Text(当type为透传时,需要指定 dataFormat)<br>cacheTime number 非必传 缓存时间,单位为秒,缓存时间范围 1-7776000 秒,启用缓存时必须设置缓存时间<br>isCache number 非必传 是否启用缓存 1:启用 2:不启用,默认不启用<br>isCover number 非必传 是否覆盖之前发送的相同的命令 1:覆盖 2:不覆盖,默认不覆盖,启用缓存时此参数有效
777
+ 2|promise|promisecb|回调 callback
778
+
779
+
780
+ ### addCornJob
781
+
782
+ 创建定时任务
783
+
784
+
785
+
786
+ 起始版本|适用平台
787
+ -|-
788
+ 1.3.0|all
789
+
790
+ 序号|参数名|参数类型|描述
791
+ -|-|-|-
792
+ 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>timers:[{<br>action – string 必传 定时任务执行的命令,格式:物模型的 json 字符串,<br>time – string 非必传 执行时间,格式为 HH:mm:ss, 当 type = once || day-repeat || custom-repeat ||<br>multi-section 时必填,<br>startTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>endTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>delay – number 非必传 延迟执行时间,单位为秒, 当 type = delay 时必填,单位为 s<br>}]<br>enabled – 定时任务状态:false-停止(默认) true-启动<br>dayOfWeek – string 非必传 周几执行:1-周一 2-周二 3-周三 4-周四 5-周五 6-周六 7-周日, 可以多选,传多个值时使用英文逗号分隔, 当 type = custom-repeat || multi-section || random 时必填
793
+ 2|promise|promisecb|回调 callback {"data": {}}
794
+
795
+
796
+ ### setCronJob
797
+
798
+ 修改定时任务
799
+
800
+
801
+
802
+ 起始版本|适用平台
803
+ -|-
804
+ 1.3.0|all
805
+
806
+ 序号|参数名|参数类型|描述
807
+ -|-|-|-
808
+ 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>ruleId – string 必传 规则唯一标识,修改规则实例信息时必填<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>timers:[{<br>action – string 必传 定时任务执行的命令,格式:物模型的 json 字符串,<br>time – string 非必传 执行时间,格式为 HH:mm:ss, 当 type = once || day-repeat || custom-repeat ||<br>multi-section 时必填,<br>startTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>endTime – string 非必传 当 type 为 random 时必填,格式为 "HH:mm:ss",如 "12:00:00"<br>delay – number 非必传 延迟执行时间,单位为秒, 当 type = delay 时必填,单位为 s<br>}]<br>enabled – 定时任务状态:false-停止(默认) true-启动<br>dayOfWeek – string 非必传 周几执行:1-周一 2-周二 3-周三 4-周四 5-周五 6-周六 7-周日, 可以多选,传多个值时使用英文逗号分隔, 当 type = custom-repeat || multi-section || random 时必填
809
+ 2|promise|promisecb|回调 callback {"data": {}}
810
+
811
+
812
+ ### getCronJobList
813
+
814
+ 查询设备下定时任务列表
815
+
816
+
817
+
818
+ 起始版本|适用平台
819
+ -|-
820
+ 1.3.0|all
821
+
822
+ 序号|参数名|参数类型|描述
823
+ -|-|-|-
824
+ 1|params|object|productKey – string 必传 产品key<br>deviceKey – string 必传 设备key<br>type – string 必传 定时任务类型,once: 执行一次,day-repeat: 每天重复,custom-repeat: 自定义重复,multi-section: 多段执行,random: 随机执行,delay: 延迟执行(倒计时)<br>page – number 分页页码,默认: 1<br>pageSize – number 分页大小,默认: 10
825
+ 2|promise|promisecb|回调 callback {"data": {"list" : [], "total" : 12}}
826
+
827
+
828
+ ### getCronJobInfo
829
+
830
+ 查询定时任务详情
831
+
832
+
833
+
834
+ 起始版本|适用平台
835
+ -|-
836
+ 1.3.0|all
837
+
838
+ 序号|参数名|参数类型|描述
839
+ -|-|-|-
840
+ 1|ruleId|string|– string 必传 定时任务ID
841
+ 2|promise|promisecb|回调 callback {"data": {}}
842
+
843
+
844
+ ### batchDeleteCronJob
845
+
846
+ 批量删除定时任务
847
+
848
+
849
+
850
+ 起始版本|适用平台
851
+ -|-
852
+ 1.3.0|all
853
+
854
+ 序号|参数名|参数类型|描述
855
+ -|-|-|-
856
+ 1|params|object|– {ruleIdList:[] String[] 必传 定时任务ID}
857
+ 2|promise|promisecb|回调 callback {"data": {}}
858
+
859
+
860
+ ### getProductCornJobLimit
861
+
862
+ 查询产品下定时任务限制数
863
+
864
+
865
+
866
+ 起始版本|适用平台
867
+ -|-
868
+ 1.3.0|all
869
+
870
+ 序号|参数名|参数类型|描述
871
+ -|-|-|-
872
+ 1|productKey|string|– string 必传 产品key
873
+ 2|promise|promisecb|回调callback {"data": {}}
874
+
875
+
876
+ ### openWebSocket
877
+
878
+ 打开websocket
879
+
880
+
881
+
882
+ 起始版本|适用平台
883
+ -|-
884
+ 1.3.0|all
885
+
886
+
887
+
888
+ ### closeWebSocket
889
+
890
+ 关闭websocket
891
+
892
+
893
+
894
+ 起始版本|适用平台
895
+ -|-
896
+ 1.3.0|all
897
+
898
+
899
+
900
+ ### getProductTSLWithCacheByProductKey
901
+
902
+ 查询产品的tls模型
903
+
904
+
905
+
906
+ 起始版本|适用平台
907
+ -|-
908
+ 1.5.0|all
909
+
910
+ 序号|参数名|参数类型|描述
911
+ -|-|-|-
912
+ 1|param|object|-{productKey:String } --必传
913
+ 2|promise|promisecb|-{callback:{data:{}}
914
+
915
+
916
+ ### listDeviceEvent
917
+
918
+ 门锁事件日志
919
+
920
+
921
+
922
+ 起始版本|适用平台
923
+ -|-
924
+ 1.9.0|all
925
+
926
+ 序号|参数名|参数类型|描述
927
+ -|-|-|-
928
+ 1|params|object|{codeList:["",""],productKey:"",deviceKey:"",startTime:long,endTime:long,pageNumber:1,pageSize:10}
929
+ 2|promise|promisecb|
930
+
931
+
932
+ ### unShareDeviceByShareUserWithShareCodeIpc `弃用`
933
+
934
+ 设备解绑
935
+
936
+
937
+ > 该方法已弃用并不再维护,如遇问题请联系开发者
938
+
939
+
940
+ 起始版本|适用平台
941
+ -|-
942
+ 1.9.6|all
943
+
944
+ 序号|参数名|参数类型|描述
945
+ -|-|-|-
946
+ 1|pk|string|string 产品id
947
+ 2|dk|string|string 设备id
948
+ 3|shareCode|string|string 分享码
949
+ 4|promise|promisecb|promise 执行回调
950
+
951
+
952
+ ### subscribeDevice
953
+
954
+ 订阅设备(非当前面板设备)
955
+
956
+
957
+
958
+ 起始版本|适用平台
959
+ -|-
960
+ 2.0.0|all
961
+
962
+ 序号|参数名|参数类型|描述
963
+ -|-|-|-
964
+ 1|pk|string|string 产品id
965
+ 2|dk|string|string 设备id
966
+
967
+
968
+ ### unSubscribeDevice
969
+
970
+ 取消订阅 (非当前面板设备)
971
+
972
+
973
+
974
+ 起始版本|适用平台
975
+ -|-
976
+ 2.0.0|all
977
+
978
+ 序号|参数名|参数类型|描述
979
+ -|-|-|-
980
+ 1|pk|string|string 产品id
981
+ 2|dk|string|string 设备id
982
+
983
+
984
+ ### deviceAssociationWithList
985
+
986
+ 设置主从设备关联关系
987
+
988
+
989
+
990
+ 起始版本|适用平台
991
+ -|-
992
+ 2.0.0|all
993
+
994
+ 序号|参数名|参数类型|描述
995
+ -|-|-|-
996
+ 1|list|Array&lt;object&gt;|- array<DeviceModel> 关联设备列表<br>[<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345",<br>...设备其他信息<br>},<br>{<br>"deviceKey": "1234567890",<br>"productKey": "p12345"<br>...设备其他信息<br>}<br>]
997
+ 2|master|object|- DeviceModel Object 主设备信息
998
+ 3|fid|string|- string 家庭 id, 没有传空
999
+ 4|promise|promisecb|promise 执行回调
1000
+
1001
+
1002
+ ### deviceAssociation
1003
+
1004
+ 设备关联关系查询
1005
+
1006
+
1007
+
1008
+ 起始版本|适用平台
1009
+ -|-
1010
+ 2.0.0|all
1011
+
1012
+ 序号|参数名|参数类型|描述
1013
+ -|-|-|-
1014
+ 1|master|object|- DeviceModel Object 主设备信息
1015
+ 2|fid|string|- string 家庭 id, 没有传空
1016
+ 3|codelist|string|- string 物模型code, 用逗号分隔
1017
+ 4|promise|promisecb|promise 执行回调
1018
+
1019
+
1020
+ ### deviceDisassociation
1021
+
1022
+ 设备关联关系解除
1023
+
1024
+
1025
+
1026
+ 起始版本|适用平台
1027
+ -|-
1028
+ 2.0.0|all
1029
+
1030
+ 序号|参数名|参数类型|描述
1031
+ -|-|-|-
1032
+ 1|device|object|- DeviceModel Object 从设备信息
1033
+ 2|fid|string|- string 家庭 id, 没有传空
1034
+ 3|promise|promisecb|promise 执行回调
1035
+
1036
+
1037
+ ### deviceAssociationConfig
1038
+
1039
+ 设备关联关系配置查询
1040
+
1041
+
1042
+
1043
+ 起始版本|适用平台
1044
+ -|-
1045
+ 2.0.0|all
1046
+
1047
+ 序号|参数名|参数类型|描述
1048
+ -|-|-|-
1049
+ 1|pk|string|string 主设备pk
1050
+ 2|promise|promisecb|promise 执行回调
1051
+
1052
+
1053
+ ### getDeviceOnlineState
1054
+
1055
+ 通过设备dk,pk获取指定设备设备通道状态
1056
+
1057
+
1058
+
1059
+ 起始版本|适用平台
1060
+ -|-
1061
+ 2.0.0|all
1062
+
1063
+ 序号|参数名|参数类型|描述
1064
+ -|-|-|-
1065
+ 1|pk|string|- string 设备 productkey
1066
+ 2|dk|string|- string 设备 devicekey
1067
+ 3|promise|promisecb|回调 callback {"onlineState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
1068
+
1069
+
1070
+ ### setOfflineReminder
1071
+
1072
+ 设置离线提醒开关
1073
+
1074
+
1075
+
1076
+ 起始版本|适用平台
1077
+ -|-
1078
+ 2.4.0|all
1079
+
1080
+ 序号|参数名|参数类型|描述
1081
+ -|-|-|-
1082
+ 1|enableOfflineReminder|integer|number 开关 0关闭1开启
1083
+ 2|productKey|string|- string productKey
1084
+ 3|deviceKey|string|- string deviceKey
1085
+ 4|promise|promisecb|promise回调
1086
+
1087
+
1088
+ ### getOfflineReminderInfo
1089
+
1090
+ 离线提醒开关查询
1091
+
1092
+
1093
+
1094
+ 起始版本|适用平台
1095
+ -|-
1096
+ 2.4.0|all
1097
+
1098
+ 序号|参数名|参数类型|描述
1099
+ -|-|-|-
1100
+ 1|productKey|string|- string productKey
1101
+ 2|deviceKey|string|- string deviceKey
1102
+ 3|promise|promisecb|promise 回调
1103
+
1104
+
1105
+ ### checkDeviceUpdatePlan
1106
+
1107
+ 获取设备是否有OTA计划
1108
+
1109
+
1110
+
1111
+ 起始版本|适用平台
1112
+ -|-
1113
+ 2.4.0|all
1114
+
1115
+ 序号|参数名|参数类型|描述
1116
+ -|-|-|-
1117
+ 1|device|object|- DeviceModel Object 设备信息
1118
+ 2|promise|promisecb|promise 回调
1119
+
1120
+
1121
+ ### openDeviceOTAPage
1122
+
1123
+ 打开设备OTA详情
1124
+
1125
+
1126
+
1127
+ 起始版本|适用平台
1128
+ -|-
1129
+ 2.4.0|all
1130
+
1131
+ 序号|参数名|参数类型|描述
1132
+ -|-|-|-
1133
+ 1|productKey|string|- string productKey
1134
+ 2|deviceKey|string|- string deviceKey
1135
+ 3|promise|promisecb|promise 回调
1136
+
1137
+
1138
+ ### getTimeDifferenceWithGMT
1139
+
1140
+ 获取当前手机设置时区
1141
+
1142
+
1143
+
1144
+ 起始版本|适用平台
1145
+ -|-
1146
+ 2.5.7|all
1147
+
1148
+ 序号|参数名|参数类型|描述
1149
+ -|-|-|-
1150
+ 1|promise|promisecb|promise 执行回调
1151
+
1152
+
1153
+ ### getDeviceTimeZone
1154
+
1155
+ 获取当前设备设置时区
1156
+
1157
+
1158
+
1159
+ 起始版本|适用平台
1160
+ -|-
1161
+ 2.5.7|all
1162
+
1163
+ 序号|参数名|参数类型|描述
1164
+ -|-|-|-
1165
+ 1|productKey|string|- string productKey
1166
+ 2|deviceKey|string|- string deviceKey
1167
+ 3|promise|promisecb|promise 执行回调
1168
+
1169
+
1170
+ ### setDeviceTimeZone
1171
+
1172
+ 设置设备时区
1173
+
1174
+
1175
+
1176
+ 起始版本|适用平台
1177
+ -|-
1178
+ 2.5.7|all
1179
+
1180
+ 序号|参数名|参数类型|描述
1181
+ -|-|-|-
1182
+ 1|productKey|string|- string productKey
1183
+ 2|deviceKey|string|- string deviceKey
1184
+ 3|timezone|string|- string 时区
1185
+ 4|promise|promisecb|promise 执行回调
1186
+
1187
+
1188
+ ### getDeviceStateInfo
1189
+
1190
+ 获取设备当前连接WiFi信息
1191
+
1192
+
1193
+
1194
+ 起始版本|适用平台
1195
+ -|-
1196
+ 2.10.0|all
1197
+
1198
+ 序号|参数名|参数类型|描述
1199
+ -|-|-|-
1200
+ 1|productKey|string|- string productKey
1201
+ 2|deviceKey|string|- string deviceKey
1202
+ 3|promise|promisecb|promise 执行回调
1203
+
1204
+
1205
+ ### jumpDeviceWiFiListPage
1206
+
1207
+ 跳转WiFi列表页
1208
+
1209
+
1210
+
1211
+ 起始版本|适用平台
1212
+ -|-
1213
+ 2.10.0|all
1214
+
1215
+ 序号|参数名|参数类型|描述
1216
+ -|-|-|-
1217
+ 1|productKey|string|- string productKey
1218
+ 2|deviceKey|string|- string deviceKey
1219
+ 3|oldSsid|string|- string 已连接ssid
1220
+ 4|signal_strength|string|- string 信号强度
1221
+ 5|supportOnlineWiFiScan|boolean|- boolean 设备是否支持在线WiFi扫描
1222
+ 6|promise|promisecb|promise 执行回调
1223
+
1224
+
1225
+ ### getProductDescription
1226
+
1227
+ 获取产品说明书地址
1228
+
1229
+
1230
+
1231
+ 起始版本|适用平台
1232
+ -|-
1233
+ 2.10.0|all
1234
+
1235
+ 序号|参数名|参数类型|描述
1236
+ -|-|-|-
1237
+ 1|productKey|string|- string productKey
1238
+ 2|promise|promisecb|promise 执行回调 { "data":{"url": "https://xxx.pdf"}}
1239
+
1240
+
1241
+ ### getFamilyDeviceList
1242
+
1243
+ 获取设备列表
1244
+
1245
+
1246
+
1247
+ 起始版本|适用平台
1248
+ -|-
1249
+ 2.11.5|all
1250
+
1251
+ 序号|参数名|参数类型|描述
1252
+ -|-|-|-
1253
+ 1|pageNumber|integer|number 页码
1254
+ 2|pageSize|integer|number 页大小
1255
+ 3|promise|promisecb|promise 执行回调<br>callback {"data": {"list" : [], "total" : 12}}
1256
+
1257
+
1258
+ ### timeZoneSync
1259
+
1260
+ 设备校时 only pure bt
1261
+
1262
+
1263
+
1264
+ 起始版本|适用平台
1265
+ -|-
1266
+ 2.11.0|all
1267
+
1268
+ 序号|参数名|参数类型|描述
1269
+ -|-|-|-
1270
+ 1|productKey|string|- string productKey
1271
+ 2|deviceKey|string|- string deviceKey
1272
+ 3|promise|promisecb|回调
1273
+
1274
+
1275
+ ### unbindlingPureBtDevice
1276
+
1277
+ 纯蓝牙设备解绑
1278
+
1279
+
1280
+
1281
+ 起始版本|适用平台
1282
+ -|-
1283
+ 2.11.0|all
1284
+
1285
+ 序号|参数名|参数类型|描述
1286
+ -|-|-|-
1287
+ 1|productKey|string|- string productKey
1288
+ 2|deviceKey|string|- string deviceKey
1289
+ 3|isInit|boolean|- boolean 是否重置设备
1290
+ 4|random|string|- string 非必传 random
1291
+ 5|pureBtResetCredentials|string|- string 非必传 重置凭证
1292
+ 6|promise|promisecb|回调
1293
+
1294
+
1295
+ ### getTsl
1296
+
1297
+ 获取产品物模型(无网络获取缓存)
1298
+
1299
+
1300
+
1301
+ 起始版本|适用平台
1302
+ -|-
1303
+ 2.11.0|all
1304
+
1305
+ 序号|参数名|参数类型|描述
1306
+ -|-|-|-
1307
+ 1|productKey|string|- string productKey
1308
+ 2|promise|promisecb|promise 执行回调
1309
+
1310
+
1311
+ ### startVerifyDevice
1312
+
1313
+ 激活设备(设备配网)
1314
+
1315
+
1316
+
1317
+ 起始版本|适用平台
1318
+ -|-
1319
+ 2.12.0|all
1320
+
1321
+ 序号|参数名|参数类型|描述
1322
+ -|-|-|-
1323
+ 1|productKey|string|productKey
1324
+ 2|deviceKey|string|deviceKey
1325
+ 3|promise|promisecb|执行结果
1326
+
1327
+
1328
+ ### startNetConfigDevice
1329
+
1330
+ 已绑定设备配网
1331
+
1332
+
1333
+
1334
+ 起始版本|适用平台
1335
+ -|-
1336
+ 2.14.5|all
1337
+
1338
+ 序号|参数名|参数类型|描述
1339
+ -|-|-|-
1340
+ 1|productKey|string|productKey
1341
+ 2|deviceKey|string|deviceKey
1342
+ 3|promise|promisecb|执行结果
1343
+
1344
+
1345
+ ### getSharePermList
1346
+
1347
+ 被分享人查询分享权限
1348
+
1349
+
1350
+
1351
+ 起始版本|适用平台
1352
+ -|-
1353
+ 2.19.0|all
1354
+
1355
+ 序号|参数名|参数类型|描述
1356
+ -|-|-|-
1357
+ 1|shareCodeList|Array&lt;string&gt;|分享码列表
1358
+ 2|promise|promisecb|执行结果
1359
+
1360
+
1361
+ ### uploadDeviceHistoricalData
1362
+
1363
+ 立刻上传设备历史数据
1364
+
1365
+
1366
+
1367
+ 起始版本|适用平台
1368
+ -|-
1369
+ 3.1.0|all
1370
+
1371
+ 序号|参数名|参数类型|描述
1372
+ -|-|-|-
1373
+ 1|productKey|string|productKey
1374
+ 2|deviceKey|string|deviceKey
1375
+ 3|promise|promisecb|执行结果
1376
+
1377
+
1378
+ ### getVoiceSupport
1379
+
1380
+ 获取产品语音技能支持
1381
+
1382
+
1383
+
1384
+ 起始版本|适用平台
1385
+ -|-
1386
+ 3.2.0|all
1387
+
1388
+ 序号|参数名|参数类型|描述
1389
+ -|-|-|-
1390
+ 1|productKey|string|productKey
1391
+ 2|uid|string|终端用户id
1392
+ 3|account|string|当前用户的账号(优先邮箱 没有就手机号, 都没有就不传)
1393
+ 4|promise|promisecb|执行结果 callback {"supportAlexa": true/false, "supportAssistant": true/false,}<br>supportAlexa 是否支持Alexa 语音<br>supportAssistant 是否支持google assistant
1394
+
1395
+
1396
+ ## 事件
1397
+
1398
+
1399
+ ### onDeviceConnectingState
1400
+
1401
+ 设备链路连接状态状态通知
1402
+
1403
+
1404
+
1405
+ 起始版本|适用平台
1406
+ -|-
1407
+ 1.8.0|all
1408
+
1409
+ 参数类型|描述
1410
+ -|-
1411
+ object|事件数据 {"connectingState": 0/1/2/3/4/5/6/7}<br>connectingStateMaskWS = 1 << 0,<br>connectingStateMaskWifi = 1 << 1,<br>connectingStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
1412
+
1413
+
1414
+ ### onDeviceOnlineState
1415
+
1416
+ 设备在离线状态通知
1417
+
1418
+
1419
+
1420
+ 起始版本|适用平台
1421
+ -|-
1422
+ 1.4.0|all
1423
+
1424
+ 参数类型|描述
1425
+ -|-
1426
+ object|事件数据 {"onlineState": 0/1/2/3/4/5/6/7}<br>onlineStateMaskWS = 1 << 0,<br>onlineStateMaskWifi = 1 << 1,<br>onlineStateMaskBle = 1 << 2,<br>(0: all offline, 1: websocket online, 2 : wifi online, 3: wifi + websocket online, 4: ble online, 5: websocket + ble online, 6: ble + wifi online , 7: wifi + ble + ws online)
1427
+
1428
+
1429
+ ### onDeviceDpsUpdate
1430
+
1431
+ 设备dps更新 (尽量)
1432
+
1433
+
1434
+
1435
+ 起始版本|适用平台
1436
+ -|-
1437
+ 1.4.0|all
1438
+
1439
+ 参数类型|描述
1440
+ -|-
1441
+ object|事件数据 {<br>type: (1:ws 2: wifi 3: ble,)<br>action: {<br>1.读取消息(面板不需要处理)<br>2.设备上报-读响应<br>3.发生消息(面板不需要处理)<br>4.设备上报-写响应<br>5.调用 EXE-SERV2服务 (面板暂时不需要处理)<br>6.设备上报-服务调用<br>7.设备告警-info<br>8.设备告警-warn<br>9.设备告警-error<br>10.位置信息LOCATION<br>11.发生RAW (面板暂时不需要处理)<br>12.接受RAW (面板暂时不需要处理)<br>13.设备上报-自动上报<br>14.设备在线状态 (面板不需要处理)<br>15.设备上报-信号量<br>16.设备上报-设备<br>17.设备上报-设备被移除(value: 1 解绑, 2.重置, 3.分享过期, 4.取消分享, 5.覆盖分享, 6. 用户注销, 7. 从设备组中移除)<br>18.设备状态信息回复<br>19.透传数据方向 app → iot<br>20.透传数据 方向 iot→ app<br>}<br>pk: "xxxx",<br>dk: "xxxx",<br>"dps": [{id: 0, type:BOOL, value, true/false},{id: 1, type:INT, value, 1}, ...]<br>"transparent": "xxx"(二进制数据base64后转字符串),<br>}
1442
+
1443
+
1444
+ ### onDeviceInfoUpdate
1445
+
1446
+ 设备信息更新
1447
+
1448
+
1449
+
1450
+ 起始版本|适用平台
1451
+ -|-
1452
+ 1.4.0|all
1453
+
1454
+ 参数类型|描述
1455
+ -|-
1456
+ object|事件数据
1457
+
1458
+
1459
+ ### onWebSocketDidOpen
1460
+
1461
+ WebSocket 已打开事件
1462
+
1463
+
1464
+
1465
+ 起始版本|适用平台
1466
+ -|-
1467
+ 1.0.0|all
1468
+
1469
+ 参数类型|描述
1470
+ -|-
1471
+ object|事件数据 data = {"code":"this is code", @"message":" this is reason"}<br>reminder.data = {}
1472
+
1473
+
1474
+ ### onWebSocketDidError
1475
+
1476
+ WebSocket 错误事件
1477
+
1478
+
1479
+
1480
+ 起始版本|适用平台
1481
+ -|-
1482
+ 1.0.0|all
1483
+
1484
+ 参数类型|描述
1485
+ -|-
1486
+ object|事件数据 data = {"code":"this is code", @"message":" this is reason"}
1487
+
1488
+
1489
+ ### onWebSocketDidReceiveMessage
1490
+
1491
+ WebSocket 消息事件
1492
+
1493
+
1494
+
1495
+ 起始版本|适用平台
1496
+ -|-
1497
+ 1.0.0|all
1498
+
1499
+ 参数类型|描述
1500
+ -|-
1501
+ object|事件数据<br>object.data = {<br>"cmd": "message",<br>"data": {<br>"createdAt": 1609316592000,<br>"data": {<br>"value": 1<br>},<br>"deviceKey": "866123456789015",<br>"productKey": "123456",<br>"ticket": "5f9924d171977c33bc5ad1b1",<br>"type": "ONLINE"<br>}<br>}<br>error<br>{<br>cmd = error;<br>data = {<br>code = 4010;<br>msg = "user not logged in";<br>reqMsg = "";<br>};
1502
+
1503
+
1504
+ ### deviceAssociationSelected
1505
+
1506
+ 设备关联选中的设备
1507
+
1508
+
1509
+
1510
+ 起始版本|适用平台
1511
+ -|-
1512
+ 2.0.0|all
1513
+
1514
+ 参数类型|描述
1515
+ -|-
1516
+ Array&lt;object&gt;|设备列表数组,Object是devcie model
1517
+
1518
+
1519
+ ### onDeviceStatusUpdate
1520
+
1521
+ 设备信息更新
1522
+
1523
+
1524
+
1525
+ 起始版本|适用平台
1526
+ -|-
1527
+ 2.10.0|all
1528
+
1529
+ 参数类型|描述
1530
+ -|-
1531
+ object|设备状态数据
1532
+
1533
+
1534
+
1535
+