@quec/rn-device-module 1.9.13

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.
package/README.md ADDED
@@ -0,0 +1,1043 @@
1
+ # QuecRNDeviceModule
2
+
3
+ 设备桥组件
4
+
5
+
6
+
7
+ 类型|版本|适用平台|负责人
8
+ -|-|-|-
9
+ module|1.9.13|all|vic.huang@quectel.com
10
+
11
+ > **1.9.13 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
+