帮你快速理解、总结文档立即下载

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