扫码激活绑定

App 可通过扫码设备二维码的方式让设备被激活绑定。

名词解释

• 二维码

  是用某种特定的几何图形按一定规律在平面（二维方向上）分布的、黑白相间的、记录数据符号信息的图形。

• 短链接

  将长的 URL 网址，通过程序计算等方式，转换为简短的网址字符串。短链接具有长度短，易记录，易转发等优点，同时又可以隐藏真实地址。

功能描述

扫码绑定的大致流程如下：

1. 设备通过 MQTT 与云端建立连接。
2. App 扫描设备的二维码，拿到信息后发送给云端。
3. App 向云端申请配网 Token。
4. 云端将 Token 发送给设备。
5. 设备断开 MQTT。
6. 设备通过 Token 获取域名，时区等相关信息，激活绑定。

扫码主要适用以下几类设备：

• GPRS / 3G / 4G 等蜂窝网络设备
• 可在屏幕上输入 Wi-Fi 密码的带屏类无线设备，如云相框
• 有线设备

流程图

开发指导

运行环境

由于每个模组上的资源不一样，并不会打开所有功能，您需要检查 tuya_iot_config.h 确认如下宏定义是否定义：

#define ENABLE_QRCODE_ACTIVE 1

使用方法

• 您如果想要启用这个功能，请先前往 涂鸦 IoT 开发平台创建产品，进入产品开发界面。在 功能定义 > 高级功能 处为产品开启 设备直连云 的高级能力。之后您再用该 PID 购买授权码对设备进行授权。

• 在调用完设备初始化接口后，配置好网络信息（Wi-Fi 类设备需要开发者调用接口配置SSID 和 Password），待设备连上网后会主动连接 MQTT，走后续流程。
• 如果开发者需要拿到短链信息生成图片并显示，可在设备初始化时注册 IoT 设备功能回调函数时注册 active_shorturl 回调函数。该回调函数会在设备连上网络后返回短链信息。