全部產品
Search
文件中心

IoT Platform:使用自訂Topic通訊

更新時間:Jun 30, 2024

產品的自訂Topic類會自動對應為該產品下所有裝置的自訂Topic。本文介紹如何為產品自訂Topic類及自訂Topic的使用和通訊說明。

背景資訊

物聯網平台Topic定義和使用說明,請參見什麼是Topic

添加自訂Topic類

  1. 登入物聯網平台控制台

  2. 執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。

  3. 在左側導覽列,選擇裝置管理 > 產品

  4. 產品頁面,找到需要自訂Topic類的產品,並單擊對應操作欄中的查看按鈕。

  5. 產品詳情頁面,單擊Topic類列表 > 自訂Topic > 定義Topic類

  6. 配置參數,單擊確認

    參數

    描述

    裝置操作許可權

    裝置對該Topic的操作許可權,可設定為發布訂閱發布和訂閱

    Topic類

    Topic格式必須以/進行分層,區分每個類目。類目命名只能包含字母、數字和底線(_),每級類目不可為空。

    • 對於雲網關產品,Topic類完全由使用者自訂輸入。支援使用萬用字元+#,支援使用${deviceName}通配DeviceName。

    • 對於非雲網關產品:

      • 只有裝置操作許可權為訂閱時,才可以使用萬用字元+#,以便裝置實現批量訂閱Topic。

      • 自訂Topic類前三個類目已固定為/${productKey}/${deviceName}/user/,需將Topic類填充完整。

    說明

    萬用字元使用方法,請參見帶萬用字元的自訂Topic

    是否開啟代理訂閱

    裝置操作許可權為訂閱發布和訂閱,可開啟代理訂閱。

    開啟代理訂閱後,裝置與物聯網平台建連時,物聯網平台查詢已開啟代理訂閱的Topic,協助裝置完成訂閱。

    是否開啟壓縮或解壓縮

    尊享型企業版執行個體下,可開啟自訂Topic資料壓縮或解壓縮。資料壓縮功能,請參見資料壓縮

    描述

    可輸入文字,描述該Topic類,用於區分不同Topic類的功能。

管理Topic類

您可在自訂Topic的Topic類列表中,找到對應自訂Topic類,執行以下操作。

操作

步驟

編輯Topic類

  1. 單擊Topic類對應操作列的編輯

  2. 定義Topic類對話方塊,修改描述裝置操作許可權Topic類

  3. 單擊確認

刪除Topic類

警告

刪除自訂Topic類後,與該自訂Topic相關的裝置通訊服務不可用、使用者業務中斷。請謹慎操作。

  1. 單擊Topic類對應操作列的刪除

  2. 單擊確認

設定是否開啟代理訂閱

找到操作許可權訂閱發布和訂閱的Topic類,單擊是否開啟代理訂閱開關image.pngimage.png

帶萬用字元的自訂Topic

物聯網平台支援自訂Topic類時,使用以下萬用字元。

說明

由於帶萬用字元的Topic實質為一組Topic的集合,因此對於具備發布或訂閱許可權的Topic,都不支援直接使用攜帶萬用字元的Topic發送具體訊息。

例如:帶萬用字元的Topic不支援在裝置的Topic列表頁面執行發布訊息操作,將訊息發布到已訂閱該Topic的裝置。

萬用字元

描述

#

#只能出現在Topic的最後一個類目,代表本級及下級所有類目。

例如:自訂Topic/a1aycMA****/${deviceName}/user/#。裝置device1訂閱/a1aycMA****/device1/user/#,表示訂閱以/a1aycMA****/device1/user/為開頭的全部Topic,包含/a1aycMA****/device1/user/update/a1aycMA****/device1/user/update/error等Topic。

+

代表本級所有類目。

例如:自訂Topic/a1aycMA****/${deviceName}/user/+/error。裝置device1訂閱/a1aycMA****/device1/user/+/error,表示訂閱/a1aycMA****/device1/user/get/error/a1aycMA****/device1/user/update/error等Topic。

自訂Topic通訊說明

  • 服務端到裝置端

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

  • 裝置端到服務端

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

使用自訂Topic通訊的樣本,請參見使用自訂Topic進行通訊