手机端WiFi配网开发过程

更新时间：2019-04-03 13:50:02

WiFi配网过程

配网主要分为以下四个过程：发现待配网的设备；开始配网；配网中间状态；配网结果。

设备发现

设备发现用于指定需要配网的设备的型号（ProductKey）和标识（DeviceName），其中ProductKey必须指定，而设备标识可选。

手机APP开发时有多种方案可以确定用户的型号和标识，开发者可以根据实际情况选择：

（1）扫描二维码获取设备信息(扫码实现可使用开源库zxing或者阿里demoapp里的方案)

本方案指设备上具有一个二维码，手机APP扫码设备的二维码获取设备的信息，二维码的格式类似:" http://www.taobao.com?pk=a17Gp9Vyqpx&dn=GPRS002 "。手机APP扫描获得该String之后从中解析设备的ProductKey（示例中的"pk"），设备的标识（dn，DeviceName）在二维码中是可选的。

注：蜂窝网设备粘贴的二维码中一定需要包含DeviceName。

（2）手机APP列出产品列表供用户选择

即在APP中将支持的产品列表显示出来，让用户选择待配网设备的产品，从而确定ProductKey

（3）调用 SDK 本地发现接口发现

SDK提供本地发现接口用于发现待配网设备，注意只有设备支持某些配网方案时SDK才可以在设备尚未连接WiFi热点时就可以发现待配网设备。

配网前置步骤

手机热点配网有一些前置的步骤，需要实现以下功能：

（1）开启手机热点；
（2）发现连接到手机热点的设备；
（3）发送 WiFi 连接信息到设备端；

启动配网

开始配网后，SDK会将配网的中间过程回调到上层。比如参数校验是否通过、是否需要用户传入额外的参数、配网进行中、配网结果的回调。

配网结果

配网成功或者配网失败，SDK 都会回调配网结果。配网失败会返回具体的配网错误码和错误信息，配网成功则返回 ProductKey 和 DeviceName 信息。用户可以使用配网成功的信息去做绑定操作。

Android配网开发

在安卓系统上进行配网开发请参见“安卓配网开发”

iOS配网开发

在iOS系统上进行配网开发请参见“iOS配网开发”。