说明:
功能描述
用户可以通过设备身份注册表为设备/客户端配置传播属性。当匹配的客户端发布消息时,会额外添加传播属性包含的 User Property 列表,达到不修改设备代码的情况下,增加元数据的目标。
使用场景
1. 设备无法支持 OTA 升级;
2. 灰度发布,A/B 测试等场景,需要对设备打环境标签。
实现原理
注册设备身份
MQTT 为每个实例提供设备身份注册表,方便用户为具体设备/客户端提供附加配置,从而实现“一机一密”,“传播属性”等特性。设备身份注册表通过 CAPI 开放一组管理接口,实现设备身份的创建、更新、删除等管理。

设备身份(Device Identity)目前包含以下字段:
配置传播属性

如上述序列图所示:
1. 用户通过云 API 创建设备身份,定义传播属性;
2. 设备身份配置信息同步到 MQTT Server 节点;
3. 匹配的客户端发布消息时, MQTT Server 根据设备身份元数据, 为消息添加(Append)传播属性定义的 User Property 列表;
4. MQTT 5.0 订阅者订阅消息时, 投递包含传播属性的 User Properties。
查看传播属性
1. 登录消息队列 MQTT 版控制台。点击 资源管理 > 集群管理 > 客户端名称,查看具体客户端详情。
2. 如图所示,当功能已开启时,可在集群的基本信息中查看传播属性。
