文档

什么是消息解析

更新时间:

物联网平台定义设备消息的标准数据格式为Alink JSON。对于低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信,可将原数据透传到物联网平台。物联网平台提供消息解析功能,可以根据您提交的脚本,将消息数据在设备自定义格式和JSON格式之间转换。

背景信息

目前支持解析两类消息:

  • 自定义Topic上行消息:将设备通过自定义Topic上报给物联网平台云端的自定义格式数据Payload解析为JSON格式。

  • 上、下行物模型Topic的消息:将设备上报给物联网平台云端的自定义格式物模型数据解析为Alink JSON格式;将云端下发的Alink JSON格式数据解析为设备自定义的格式。

自定义Topic消息解析

设备通过自定义Topic发布消息,且Topic携带解析标记(?_sn=default)时,物联网平台接收消息后,先调用您在物联网平台控制台提交的消息解析脚本,将设备上报的自定义格式数据的Payload解析为JSON结构体,再进行业务处理。

数据解析流程图:

数据解析流程

设备上报自定义Topic的数据(上行数据)全流程图:

custom topic data parse

自定义Topic消息解析脚本编写方法,请参见:

物模型消息解析

数据格式透传/自定义的产品下的设备与云端进行物模型数据通信时,需要物联网平台调用您提交的消息解析脚本,将上、下行物模型消息数据分别解析为物联网平台定义的标准格式(Alink JSON)和设备的自定义数据格式。

物联网平台接收到来自设备的数据时,先运行解析脚本,将透传的消息数据转换成Alink JSON格式的数据,再进行业务处理;物联网平台下发消息给设备前,也会先通过脚本将消息数据转换为设备的自定义格式,再下发给设备。

数据解析流程图:

物模型数据解析

设备上报透传格式的属性或事件(上行数据)全流程图:

设备透传数据

调用设备服务或设置属性(下行数据)全流程图:

Alink 数据传输

若您的设备为LoRaWAN节点设备,请参见LoRaWAN设备消息解析

若提交的脚本不能正常解析消息的数据,请参见问题排查