产品的自定义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进行通信。