物聯網平台定義裝置訊息的標準資料格式為Alink JSON。對於低配置且資源受限或者對網路流量有要求的裝置,不適合直接構造JSON資料與物聯網平台通訊,可將原資料透傳到物聯網平台。物聯網平台提供訊息解析功能,可以根據您提交的指令碼,將訊息資料在裝置自訂格式和JSON格式之間轉換。
背景資訊
目前支援解析兩類訊息:
自訂Topic上行訊息:將裝置通過自訂Topic上報給物聯網平台雲端的自訂格式資料Payload解析為JSON格式。
上、下行物模型Topic的訊息:將裝置上報給物聯網平台雲端的自訂格式物模型資料解析為Alink JSON格式;將雲端下發的Alink JSON格式資料解析為裝置自訂的格式。
自訂Topic訊息解析
裝置通過自訂Topic發布訊息,且Topic攜帶解析標記(?_sn=default
)時,物聯網平台接收訊息後,先調用您在物聯網平台控制台提交的訊息解析指令碼,將裝置上報的自訂格式資料的Payload解析為JSON結構體,再進行業務處理。
資料解析流程圖:
裝置上報自訂Topic的資料(上行資料)全流程圖:
自訂Topic訊息解析指令碼編寫方法,請參見:
物模型訊息解析
資料格式為透傳/自訂的產品下的裝置與雲端進行物模型資料通訊時,需要物聯網平台叫用您提交的訊息解析指令碼,將上、下行物模型訊息資料分別解析為物聯網平台定義的標準格式(Alink JSON)和裝置的自訂資料格式。
物聯網平台接收到來自裝置的資料時,先運行解析指令碼,將透傳的訊息資料轉換成Alink JSON格式的資料,再進行業務處理;物聯網平台下發訊息給裝置前,也會先通過指令碼將訊息資料轉換為裝置的自訂格式,再下發給裝置。
資料解析流程圖:
裝置上報透傳格式的屬性或事件(上行資料)全流程圖:
調用裝置服務或設定屬性(下行資料)全流程圖:
物模型資料解析指令碼編寫樣本,請參見: