设备出厂后如何自动注册、获取二维码并交付给用户？

设备厂商基于 ThingsCloud 完成从设备出厂到用户扫码使用的快速交付

设备卖出去以后，交付工作往往才刚刚开始：实施人员要在平台创建设备、复制证书、制作二维码、开通用户账号，再指导客户下载 App 和添加设备。设备数量从几十台增长到几千台后，这套依赖人工的流程很容易成为交付瓶颈。

对于具备联网能力的设备，可以把这些动作串成一条更短的链路：设备首次上电后自动获得证书并在 ThingsCloud 创建设备，平台自动生成设备码；二维码由厂商下载交付，或由带屏设备现场生成；用户最后通过 ThingsX 登录并扫码添加设备。

这套方案不要求厂商从头开发设备管理后台和用户 App，适合智能硬件、工业控制器、网关、仪器仪表以及带屏终端等产品。

先看完整交付链路

从设备出厂到用户开始使用，可以拆成 5 个连续动作：

厂商为同一设备类型准备统一固件，并为每台设备确定永久且唯一的 DeviceKey。
设备首次上电，通过 HTTP API 动态获取 AccessToken；如果平台中还没有这台设备，则同步自动创建。
设备使用 ProjectKey 和新获得的 AccessToken 建立 MQTT 连接。
ThingsCloud 在创建设备时自动生成设备码，厂商选择下载二维码，或把设备码下发给设备端生成二维码。
用户登录 ThingsX，通过扫描二维码或输入设备码添加设备并开始使用。

设备从首次上电、自动注册到用户扫码使用的端到端交付链路

这条链路的关键，不是单独把某一步自动化，而是让设备身份、平台记录、二维码和用户账号彼此衔接。这样才能减少生产、交付和售后之间的重复录入。

第一步：量产前准备设备身份与自动创建能力

为每台设备确定稳定的 DeviceKey

DeviceKey 是设备自行提供的唯一标识，平台用它识别设备。它需要满足两个条件：

在同一个 ThingsCloud 项目内保持唯一
设备全生命周期内保持不变

蜂窝网络设备通常可以使用 IMEI，WiFi 或以太网设备可以使用芯片 ID、MAC 地址，其他设备也可以使用厂商自己的 SN。选择标识时，应先确认它可以被固件稳定读取，并在生产测试阶段检查重复值。

开启允许设备自动创建

在 ThingsCloud 控制台中进入对应的设备类型，在 设置 > 自动创建设备 中复制 TypeKey，并开启 允许设备自动创建。

如果设备始终部署到厂商自己的固定项目，固件可以在动态获取证书时提交 type_key。如果设备将交付给不同客户，并需要部署到客户自己的项目，可进一步使用产品识别码 Product Key，让平台在目标项目中识别对应产品。跨项目交付还涉及连接地址与 ProjectKey 的分发方式，应结合设备厂商开放平台能力按项目设计。

第二步：设备上电后自动获取证书并创建设备

量产设备不适合逐台烧录不同的 AccessToken。更适合的方式是“一型一密”：同一型号使用统一固件，设备启动后使用自己的 DeviceKey 调用动态获取证书 API。在固定设备类型中自动创建设备时，还需要提交对应的 TypeKey。

如果 DeviceKey 已存在，平台返回对应设备的信息和 AccessToken；如果不存在且设备类型已允许自动创建，平台先创建设备，再返回证书。设备随后使用 ProjectKey 与平台返回的 AccessToken 连接 MQTT。

实现时要注意以下几点：

设备每次启动时可重新向平台获取并以返回的 AccessToken 为准，避免因本地保存丢失或错误导致连接失败。
生产环境应使用 HTTPS，并避免在日志、屏幕或调试接口中输出完整证书。
项目需要保留足够的设备数量配额；达到上限后，新设备无法自动创建。
API 返回失败时应采用有限次数重试和退避机制，不能高频无限请求。

接口地址、请求参数、返回格式和错误码统一以设备证书与动态获取证书文档为准。

第三步：选择适合产品形态的二维码交付方式

设备在 ThingsCloud 中创建后，平台会自动生成唯一设备码，并可据此生成设备二维码。设备码仅在当前项目内有效，用户扫描二维码或输入设备码后，才能把已接入平台的设备添加到自己的账号。

方案 A：从控制台下载二维码

这种方式适合没有显示屏的传感器、控制器、DTU 和小型智能硬件。

在控制台进入设备列表，打开目标设备的详情页。
在页面顶部基本信息区域点击二维码图标。
在对话框中查看设备码和二维码，并下载所需尺寸的高清图片。
将电子版二维码发送给客户，或打印后贴在设备外壳、包装盒、质保卡和说明书上。

设备数量较多时，还可以从设备列表导出设备码，并结合 ThingsCloud API 工具集完成批量二维码生产。厂商应在生产工单中保存 DeviceKey、设备记录与二维码之间的对应关系，避免贴错标签。

方案 B：带屏设备现场生成二维码

如果设备带 LCD、OLED、墨水屏或 HMI，可以不在生产环节粘贴二维码，而是在首次联网后动态显示。

先在设备类型的功能定义中准备两个属性：

start_ts：设备开机时间戳，由设备在启动后上报一次
device_code：设备码，由平台下发给设备

然后在该设备类型的属性上报消息规则中，添加向当前设备下发属性的操作，并使用云函数读取当前设备信息：

module.exports = function (report_attributes) {
    var push_attributes = {};

    if (report_attributes.start_ts !== undefined) {
        var device_info = Cloud.getDeviceInfo();
        push_attributes.device_code = device_info.device_code;
    }

    return push_attributes;
}