本文将介绍如何在控制台为产品开启动态注册,选择预创建设备或自动创建设备模式,并获取设备发起动态注册所需的 ProductID、ProductSecret 和 DeviceName。
本文不介绍产品创建、动态注册协议及设备接入流程;设备端如何发起注册并解析返回的 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 | 产品详情页的产品密钥。 |
