在1.1版本后提供websocket方式订阅平台消息的功能.
可以通过websocket来订阅设备,规则引擎,设备告警等相关消息.

接口

websocket统一接口为: /messaging/{token},
{token}可通过登录系统或者使用OpenAPI获取.
以前端js为例:

  1. var ws = new WebSocket("ws://localhost:8848/messaging/a872d8e6cf6ccd38deb0c8772f6040e3");
  2. ws.onclose=function(e){console.log(e)};
  3. ws.onmessage=function(e){console.log(e.data)}
  5. // 如果认证失败,会立即返回消息: {"message":"认证失败","type":"authError"},并断开连接.

订阅消息

向websocket发送消息,格式为:

  1. {
  2.     "type": "sub", //固定为sub
  3.     "topic": "/device/*/*/**", // topic,见topic列表.
  4.     "parameter": {       //参数,不同的订阅请求,支持的参数不同
  6.     },
  7.     "id": "request-id" //请求ID, 请求的标识,服务端在推送消息时,会将此标识一并返回.
  8. }

在取消订阅之前,多次传入相同的id是无效的,不会重复订阅. 平台推送消息:

  1. {
  2.     "payload": //消息内容, topic不同,内容不同,
  3.     "requestId": "request-id", //与订阅请求的id一致
  4.     "topic": "/device/demo-device/test0/offline", //topic,实际产生数据的topic
  5.     "type": "result" //类型 result:订阅结果 complete:结束订阅 error:发生错误 
  6. }

::: tip 提示
type为complete时标识本此订阅已结束,通常是订阅有限数据流时(比如发送设备指令),或者取消订阅时会返回此消息.
:::

取消订阅

向websocket发送消息,格式为:

  1. {
  2.     "type":"unsub",//固定为unsub
  3.      "id": "request-id" //与订阅请求ID一致
  4. }

订阅设备消息

与消息网关中的设备topic一致,查看topic列表.
消息内容(payload)将与设备消息类型一致.

发送设备指令

发送消息到websocket

  1. {
  2.     "type": "sub", //固定为sub
  3.     "topic": "/device-message-sender/demo-device/test0,test1", // 发送消息给demo-device型号下的test0和test1设备
  4.     "parameter": {
  5.         // 消息类型,支持: READ_PROPERTY (读取属性),WRITE_PROPERTY (修改属性),INVOKE_FUNCTION (调用功能)
  6.         "messageType":"READ_PROPERTY" 
  7.         //根据不同的消息,参数也不同. 具体见: 平台统一消息定义
  8.         "properties":["temperature"],
  9.         //头信息
  10.         "headers":{
  11.             "async":false // 是否异步,异步时,平台不等待设备返回指令结果.
  12.         }
  13.     },
  14.     "id": "request-id" //请求ID, 请求的标识,服务端在推送消息时,会将此标识一并返回.
  15. }

平台将推送设备返的结果:

  1. {
  2.     "payload": {   //请求消息类型不同,结果不同
  3.         "deviceId": "test0",
  4.         "messageType": "READ_PROPERTY_REPLY",
  5.         "success":true, //指令是否成功
  6.         "properties": {
  7.             "temperature": 28.21
  8.         },
  9.         "timestamp": 1588148129787
  10.     },
  11.     "requestId": "request-id", //订阅请求的ID
  12.     "topic": "/device/demo-device/test7/offline",
  13.     "type": "result"
  14. }

::: tip 提示
deviceId支持*和逗号,分割,批量发送消息到设备.如: /device-message-sender/{productId}/{deviceId}.
如果要终止发送,直接取消订阅即可.
:::

批量同步设备状态

发送消息到websocket

  1. {
  2.     "type": "sub", //固定为sub
  3.     "topic": "/device-batch/state-sync",
  4.     "parameter": {
  5.         "query":{"where":"productId is test-device"}//查询条件为动态查询条件
  6.     },
  7.     "id": "request-id" //请求ID, 请求的标识,服务端在推送消息时,会将此标识一并返回.
  8. }

平台推送:

  1. {
  2.     "payload": {   //请求消息类型不同,结果不同
  3.         "deviceId": "test0",
  4.         "state": {
  5.             "value":"offline",
  6.             "text":"离线"
  7.         }
  8.     },
  9.     "requestId": "request-id", //订阅请求的ID
  10.     "topic": "/device-batch/state-sync",
  11.     "type": "result" //为comlete是则表示同步完成.
  12. }

dashboard

订阅仪表盘数据:
topic: /dashboard/{dashboard}/{object}/{measurement}/{dimension}

  1. {
  2.     "type": "sub", //固定为sub
  3.     "topic": "/dashboard/device/demo-device/property/agg", //聚合查询属性
  4.     "parameter": {
  5.         "deviceId":"test0", //
  6.         "limit":"30",
  7.         "time":"1d",
  8.         "agg":"avg",
  9.         "from":"now-30d",
  10.         "to":"now",
  11.         "format":"MM月dd日"
  12.     },
  13.     "id": "request-id" //请求ID, 请求的标识,服务端在推送消息时,会将此标识一并返回.
  14. }

::: tip
详细使用见Dashboard说明
:::