Topic 简介
在发布/订阅消息的 MQTT 协议中,Topic 用于定义消息传输的通道和路径。设备通过 MQTT 连接腾讯云物联网开发平台后,设备通过 Topic 将消息发布到物联网开发平台,物联网开发平台将消息发送给订阅 Topic 的设备。
Topic 类型 | 说明 |
物模型 Topic | 用于设备按产品定义的物模型进行上报数据和下发控制。物模型是对设备实际功能的抽象,从属性、事件、行为三个维度配置产品功能。例如智能风扇的开关状态是属性,开关的操作是行为,报警是事件。物模型的概念和配置,请参见 配置物模型。 |
系统级 Topic | 设备使用 OTA 升级和 NTP 服务功能,必须使用的 Topic。 |
透传 Topic | 设备的业务数据是非 JSON 格式,可通过平台定义的透传 Topic 进行上报和控制。 |
自定义 Topic | 如果物模型不能满足您的业务需求,可以使用自定义 Topic。自定义 Topic 的前两个类目已固定为${ProductID}/${deviceName}。 |
添加自定义 Topic
前提条件
操作步骤
1. 登录 物联网开发平台,在实例管理页面,找到对应的实例,单击实例卡片。
2. 在左侧导航栏,选择设备管理 > 产品。
3. 单击产品名称进入产品详情页后,选择Topic列表。
4. 选择自定义Topic,然后单击添加自定义Topic。

5. 输入 Topic 名称,设置该 Topic 的权限,单击确定即可创建 Topic。

操作权限包括“发布”、“订阅”以及“订阅和发布”。
操作权限 | 说明 |
发布 | 指该 Topic 设备端只能发布,无权限订阅。发布权限的 Topic 是设备端将数据发送到平台。设备如果订阅了只有“发布”权限的 Topic,会订阅失败,云端诊断日志也会提示“Subscribe no 权限"。 |
订阅 | 指该 Topic 设备端可订阅,物联网平台将通过该 Topic 下发消息至设备。设备如果使用只有“订阅”权限的 Topic,进行数据发布,云端诊断日志会提示“Publish no 权限"。 |
发布和订阅 | 指该 Topic 同时具备发布与订阅权限。 |