產品的自訂Topic類會自動對應為該產品下所有裝置的自訂Topic。本文介紹如何為產品自訂Topic類及自訂Topic的使用和通訊說明。
背景資訊
物聯網平台Topic定義和使用說明,請參見什麼是Topic。
添加自訂Topic類
登入物聯網平台控制台。
在執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。
在左側導覽列,選擇 。
在產品頁面,找到需要自訂Topic類的產品,並單擊對應操作欄中的查看按鈕。
在產品詳情頁面,單擊 。
配置參數,單擊確認。
參數
描述
裝置操作許可權
裝置對該Topic的操作許可權,可設定為發布、訂閱、發布和訂閱。
Topic類
Topic格式必須以
/
進行分層,區分每個類目。類目命名只能包含字母、數字和底線(_),每級類目不可為空。對於雲網關產品,Topic類完全由使用者自訂輸入。支援使用萬用字元
+
和#
,支援使用${deviceName}
通配DeviceName。對於非雲網關產品:
只有裝置操作許可權為訂閱時,才可以使用萬用字元
+
和#
,以便裝置實現批量訂閱Topic。自訂Topic類前三個類目已固定為
/${productKey}/${deviceName}/user/
,需將Topic類填充完整。
說明萬用字元使用方法,請參見帶萬用字元的自訂Topic。
是否開啟代理訂閱
裝置操作許可權為訂閱或發布和訂閱,可開啟代理訂閱。
開啟代理訂閱後,裝置與物聯網平台建連時,物聯網平台查詢已開啟代理訂閱的Topic,協助裝置完成訂閱。
是否開啟壓縮或解壓縮
尊享型企業版執行個體下,可開啟自訂Topic資料壓縮或解壓縮。資料壓縮功能,請參見資料壓縮。
描述
可輸入文字,描述該Topic類,用於區分不同Topic類的功能。
管理Topic類
您可在自訂Topic的Topic類列表中,找到對應自訂Topic類,執行以下操作。
操作 | 步驟 |
編輯Topic類 |
|
刪除Topic類 | 警告 刪除自訂Topic類後,與該自訂Topic相關的裝置通訊服務不可用、使用者業務中斷。請謹慎操作。
|
設定是否開啟代理訂閱 | 找到操作許可權為訂閱或發布和訂閱的Topic類,單擊是否開啟代理訂閱開關或。 |
帶萬用字元的自訂Topic
物聯網平台支援自訂Topic類時,使用以下萬用字元。
由於帶萬用字元的Topic實質為一組Topic的集合,因此對於具備發布或訂閱許可權的Topic,都不支援直接使用攜帶萬用字元的Topic發送具體訊息。
例如:帶萬用字元的Topic不支援在裝置的Topic列表頁面執行發布訊息操作,將訊息發布到已訂閱該Topic的裝置。
萬用字元 | 描述 |
# | #只能出現在Topic的最後一個類目,代表本級及下級所有類目。 例如:自訂Topic |
+ | 代表本級所有類目。 例如:自訂Topic |
自訂Topic通訊說明
服務端到裝置端
服務端調用Pub,可向指定的自訂Topic發布訊息。裝置通過訂閱該Topic,接收來自服務端的訊息。
裝置端到服務端
裝置端向自訂Topic發布訊息,服務端可通過物聯網平台的AMQP訂閱或雲產品流轉功能,接收來自裝置端的訊息。
使用自訂Topic通訊的樣本,請參見使用自訂Topic進行通訊。