用户如何主动添加设备？设备码派上用场

当您在 ThingsCloud 上管理大量的物联网设备和用户账号时，您不仅可以主动为用户分配不同的设备，还可以允许用户主动添加设备，例如用在以下场景：

• 最终用户购买设备后，通过输入设备码快速添加到自己的 App 账号中，查看设备数据或控制设备行为。
• 集团内部为不同设备维护人员建立用户账号，维护人员扫描设备二维码添加设备到 App 进行管理。

如何获得设备码？

ThingsCloud 为每台接入的设备生成设备码，设备码是 8 位随机数字，在项目内保持唯一。

同时还生成了设备二维码，您可以打印贴在设备包装盒或手册中，ThingsX iOS/Android App 支持扫码快速添加设备。

对于大量设备的设备码获取，我们还支持批量导出等功能。

允许用户添加设备

进入设备类型中，在 应用配置 > 用户添加设备 中。

开启允许用户添加设备，还可以设置允许设备被多个用户添加。

在设备码选项中，支持验证设备有效添加时间，这是用来验证当前操作者的身份，需要设备固件中支持 ThingsCloud 的设备认领协议，例如硬件上有一个 Reset 按键，长按 5 秒钟进入添加模式，这时候用户才可以通过设备码添加设备。

顺便提一下，对于 WiFi 接入方式的设备，这里会显示 WiFi 配网选项，例如 使用 ESP32/8266 模组的 WiFi 智能设备，在用户添加设备时，可将 WiFi 账号密码一起发送给设备，实现设备接入当前 WiFi。

要配合 WiFi 配网选项，需要在设备固件开发中使用 ThingsCloud 配网协议，可使用 ThingsCloud 提供的 ESP32 SDK，或基于协议自行实现。

用户如何在 App 上添加设备

直连设备

对于直连设备，设备本身已经成功连接 ThingsCloud，用户的添加操作只是认领设备到自己的账户中。

当项目中存在允许用户添加的设备类型时，ThingX 首页右上角会显示添加菜单，如下图：

然后可以选择要添加的设备类型。

这里我们选择风速风向传感器为例，接下来提示用户做一些准备工作，这些内容可以根据需要来自定义。

对于直连设备，接下来就需要填写设备码，或者扫描设备二维码。

需要注意的是，扫描设备二维码的功能，仅在 ThingsX iOS/Android App 支持。对于小程序和 Webapp 网页版，请直接输入设备码。

如果设备码无误，添加设备便成功搞定。

WiFi 设备

对于 WiFi 设备，前边已经提到过有专门的设置选项，如果开启了 WiFi 配网，则不能通过设备码这种无接触添加方式，必须通过接触式的 WiFi 配网。

以某海外用户使用英文版 ThingsX 为例，WiFi 配网及添加设备的过程如下图：

物联网设备接入 ThingsCloud ，请参考 设备接入指南。