消息队列 MQTT 版提供灵活的订阅管理功能,支持对订阅列表进行动态维护:即添加订阅和删除订阅。
订阅添加:无需重新连接即可新增订阅主题。
订阅删除:可随时移除不再需要的主题订阅。
使用场景
物联网设备管理场景
适用于固件难以更新的传统物联网设备。
解决老旧设备无法通过 OTA 升级重新配置订阅的问题。
避免因订阅变更导致的设备重启或重连。
开发测试场景
显著提升开发调试效率,免除频繁烧录 ROM 的操作。
支持快速验证不同主题下的消息处理逻辑。
便于进行多主题并行测试,缩短开发周期。
说明:
添加订阅与删除订阅的云 API 实时生效。
API 详情
添加订阅
MQTT 提供云 API,给指定 Client ID 的会话(Session)增加新的订阅。
参数名称 | 含义 | 示例 |
InstanceId | 实例 ID | mqtt-sample |
ClientId | 客户端 ID | v-xy34213qz |
TopicFilter | Topic Filter | home/# |
QoS | 服务质量,取值:0,1, 2 | 1 |
删除订阅
MQTT 提供云 API,从指定 Client ID 的会话(Session)删除订阅。
参数名称 | 含义 | 示例 |
InstanceId | 实例 ID | mqtt-sample |
ClientId | 客户端 ID | v-xy34213qz |
TopicFilter | Topic Filter | home/# |
自动订阅管理
自动订阅管理是一种基于事件驱动的 MQTT 应用模式,能够显著提升订阅管理的灵活性与自动化水平,适用于设备动态性强、订阅关系复杂的物联网场景。


其完整工作流程如下:
设备连接:某一 IoT 设备上线,成功连接至 MQTT Broker。
事件触发:MQTT Broker 在检测到设备连接后,会立即生成一个“客户端已连接”事件,并将事件详情(包括客户端 ID、连接时间戳等元数据)发布到系统主题 $events/client_connected上。
事件监听与接收:始终订阅 $events/client_connected主题的应用程序,会实时接收到该事件通知。
订阅逻辑执行:应用程序解析事件消息,获取新上线设备的客户端 ID 等信息,随后根据预设的业务逻辑,代表该设备向 MQTT Broker 发起相应的订阅管理操作,例如为其订阅特定的主题或取消某些订阅。
通过将客户端生命周期事件与订阅列表管理能力相结合,可轻松构建灵活的自动订阅机制。该模式实现了在设备连接时根据业务需要,自动添加或者修改订阅,极大提升了系统在动态环境下的自适应能力与运维效率。