全部產品
Search
文件中心

IoT Platform:訊息通訊說明

更新時間:Jun 30, 2024

MQTT雲網關裝置可通過自訂的訊息Topic與物聯網平台進行通訊,物聯網平台會透傳裝置的上下行通訊資料。本文介紹裝置實現上下行通訊的相關說明。

MQTT雲網關產品和裝置的詳細內容,請參見建立雲網關產品(MQTT)建立雲網關裝置(MQTT)

Topic說明

物聯網平台與雲網關裝置之間通過MQTT協議的Topic實現訊息通訊,您需自訂用於通訊的Topic。通訊Topic必須符合標準MQTT協議的Topic規範,Topic更多詳細說明,請參見什麼是Topic

自訂通訊Topic直接使用裝置上報的原始自訂Topic,裝置下行通訊Topic與上行通訊Topic一致。

物聯網平台支援的通訊Topic與標準MQTT協議通訊Topic的區別如下:

Topic對比項物聯網平台支援的MQTT協議標準MQTT協議
長度支援1~128個字元。不超過65535個字元。
字元集只能包含字母、數字和底線(_)。支援UTF-8字元集,無明確限制。

限制說明

  • 一個雲網關裝置下,支援最多訂閱100個通訊Topic。
  • 只有裝置操作許可權為訂閱時,才可以使用萬用字元+#自訂Topic類,以便裝置實現批量訂閱Topic。萬用字元使用方法,請參見帶萬用字元的自訂Topic說明

上行通訊:裝置端到服務端

裝置端向通訊Topic發布訊息,服務端可通過物聯網平台的AMQP訂閱或雲產品流轉功能,接收來自裝置端的訊息。

配置引擎規則時,您需注意以下事項:

  • 僅支援在新版雲產品流轉功能下,為雲網關裝置配置資料流轉規則。具體操作,請參見配置資料流轉解析器
  • 不支援將雲網關產品和裝置的訊息流程轉到物聯網平台普通產品和裝置,也不支援將物聯網平台普通產品和裝置的訊息流程轉到雲網關產品和裝置。
  • 雲網關裝置流轉資料至另一個Topic時,需攜帶欄位deviceName。詳細使用說明,請參見流轉資料到資料目的函數
  • 配置資料流轉的資料來源Topic時,需您手動輸入訊息Topic。具體操作,請參見添加資料來源
  • 服務端訂閱中僅支援推送裝置上報訊息裝置狀態變化通知裝置生命週期變更的資料。具體操作,請參見配置AMQP服務端訂閱

下行通訊:服務端到裝置端

服務端調用Pub介面,可向指定的自訂Topic發布訊息。裝置通過訂閱該Topic,接收來自服務端的訊息。