配置 Topic

最近更新时间:2025-12-29 15:26:14

我的收藏

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 同时具备发布与订阅权限。