这篇不介绍产品创建、动态注册协议及设备接入流程;设备端如何发起注册并解析返回的 DeviceSecret。
一、模式与实例限制
产品支持以下两种动态注册模式:
| 注册模式 | 支持的实例类型 | 是否提前创建设备 | DeviceName 来源 |
| 预创建设备 | 消费实例、企业实例 | 是 | 控制台中已创建设备的名称。 |
| 自动创建设备 | 仅企业实例 | 否 | 由设备或生产系统定义,注册时自动创建对应设备。 |
消费实例仅支持动态获取已预创建设备的 DeviceSecret,不能通过动态注册自动创建设备。企业实例可以选择预创建设备或自动创建设备模式。
二、参数说明
进入产品与设备详情页后,可以查看或配置以下动态注册参数:
| 页面参数 | 说明 |
| 产品 ID | 产品的唯一标识,对应动态注册参数 ProductID。 |
| 产品密钥 | 产品级动态注册凭证,对应 ProductSecret。 |
| 动态注册 | 控制产品是否允许设备发起动态注册。 |
| 自动创建设备 | 开启后,平台可以根据注册请求中的 DeviceName 自动创建设备,仅企业实例支持。 |
| 设备名称 | 仅预创建需要,设备在当前产品下的唯一标识,对应 DeviceName。 |
ProductSecret 是产品级敏感凭证,同一产品下的多台设备可能共同使用。请勿将其写入公开代码、日志或截图。
三、使用预创建设备模式
预创建设备模式适用于消费实例和企业实例。本节以消费实例为例。
使用该模式前,目标设备必须已经在控制台创建,并且当前处于未激活状态。
四、开启动态注册
1. 登录 物联网开发平台控制台,进入目标实例。
2. 在左侧导航栏选择产品,选择目标产品,进入产品详情页。
3. 在产品信息区域打开动态注册开关。
五、获取产品参数
在产品详情页获取以下参数:
| 参数 | 获取位置 |
| ProductID | 产品详情页的产品 ID。 |
| ProductSecret | 产品详情页的产品密钥。 |
查看或复制 ProductSecret 时,应避免通过截图、日志或公开渠道传播。
六、获取设备名称
1. 在左侧导航栏选择设备。
2. 创建新设备。
3. 找到目标预创建设备并进入设备详情页。
4. 记录页面中的设备名称,作为动态注册请求中的 DeviceName。
5. 确认设备状态为未激活。
注意:说明:
注意:DeviceName 必须与控制台中的设备名称完全一致。预创建设备模式不能使用尚未在控制台创建的 DeviceName。
6. 注册成功后 DeviceSecret 会自动刷新。
7. 完成以上操作后,应已获得:
| 参数 | 参数来源 |
| 注册模式 | 预创建设备。 |
| ProductID | 产品详情页。 |
| ProductSecret | 产品详情页。 |
| DeviceName | 预创建设备详情页。 |
七、使用自动创建设备模式
自动创建设备模式仅企业实例支持。本节以企业实例为例。
该模式不需要提前在控制台逐台创建设备。平台收到有效的动态注册请求后,将根据请求中的 DeviceName 自动创建对应设备。
八、开启动态注册和自动创建设备
1. 登录 物联网开发平台控制台,进入目标企业实例。
2. 在左侧导航栏选择产品,选择目标产品,进入产品详情页。
3. 打开动态注册开关。
4. 打开自动创建设备开关。
九、获取产品参数
在产品详情页获取以下参数:
| 参数 | 获取位置 |
| ProductID | 产品详情页的产品 ID。 |
| ProductSecret | 产品详情页的产品密钥。 |