一、配网流程图
图 1：AP模式设备配网整体流程示意图
二、功能概述
AP模式配网是通过“设备开启热点→手机连接热点→局域网交互配置”的方式实现设备入网，核心逻辑为：设备进入AP模式开启热点→手机连接设备热点→局域网查询设备/WiFi列表→手机下发WiFi配置→设备切换Station模式入网→手机绑定设备。该模式无需依赖外部WiFi，配网稳定性高，适配无屏幕/简易交互设备。
三、APP端主要流程
APP端通过与设备AP热点建立局域网连接，完成设备发现、WiFi查询、配置下发及最终绑定，步骤如下：
3.1 手机连接至设备的AP热点
设备进入AP模式后会自动开启专属热点（SSID通常为设备型号+UID后几位，如“XXX-IPC-01-1234”），APP引导用户手动连接该热点；支持自动连接功能的APP，可通过系统WiFi接口检测并自动切换连接（需获取手机WiFi权限）。
3.2 手机进行局域网搜索，获取设备UID
手机连接设备热点后，通过局域网广播（如UDP广播）或SDK内置搜索接口，扫描同一局域网内的设备，获取设备唯一标识（UID），用于后续指令交互的目标设备识别。
搜索方式示例：查看示例。
3.3 查询设备周围的WiFi列表
APP向设备发起P2P连线，连线成功后调用 avSendIOCtrl 发送 IOTYPE_USER_IPCAM_LISTWIFIAP_REQ 指令，向设备请求周围可连接的WiFi网络列表，便于用户选择目标WiFi。
3.4 设定用户选定的WiFi配置
用户在APP展示的WiFi列表中选择目标网络并输入密码后，APP将WiFi的SSID、密码、加密模式等参数封装，通过 IOTYPE_USER_IPCAM_SETWIFI_REQ 指令下发给设备。
3.5 接收响应并断开热点连接
APP 接收设备返回的 IOTYPE_USER_IPCAM_SETWIFI_RESP 响应（表示设备已成功接收WiFi配置）后，自动断开与设备AP热点的连接，切换回用户的目标WiFi网络。
3.6 连接设备并完成绑定
手机重新连接目标WiFi后，通过设备UID向TUTK服务器查询设备在线状态，确认设备已成功入网后，发起绑定请求（调用 AVIOTC_DevBind 接口），绑定成功后将设备信息（UID、型号、名称等）存储至手机本地或云端服务器，配网流程完成。
四、设备端主要流程
设备端通过进入AP模式、监听局域网指令、处理WiFi配置并切换工作模式，完成配网，步骤如下：
4.1 进入AP模式，开启P2P模块
设备通过长按物理按键或上电触发，进入AP模式：开启自身WiFi热点（SSID固定格式），同时启动P2P模块并监听局域网连接（默认端口可参考SDK配置）。详细AP模式启动P2P流程可参考：基于AVAPIs的家用摄像头开发-设备端。
4.2 响应WiFi列表查询请求
设备通过 avRecvIOCtrl 接收到 IOTYPE_USER_IPCAM_LISTWIFIAP_REQ 指令后，启动WiFi扫描功能，搜索周围可用的WiFi网络，将SSID、信号强度、加密模式等信息通过 IOTYPE_USER_IPCAM_LISTWIFIAP_RESP 指令返回给APP。
4.3 响应WiFi配置设定请求
设备接收到 IOTYPE_USER_IPCAM_SETWIFI_REQ 指令后，解析SSID、passwd、encrypt_type等参数并校验合法性（如密码长度、加密模式有效性），校验通过后通过 IOTYPE_USER_IPCAM_SETWIFI_RESP 指令向APP返回“接收成功”响应。
4.4 切换至Station模式
设备发送配置响应后，关闭AP热点及所有局域网连接，切换为Station模式，使用收到的WiFi参数尝试连接目标网络。
- 连接成功：自动向TUTK服务器注册设备信息，进入“待绑定”状态；
- 连接失败：可重试3-5次，重试失败后重新进入AP模式，等待用户重新配置。
4.5 进入正常工作模式
设备成功连接目标WiFi并完成服务器注册后，进入正常工作模式，等待APP发起绑定请求，绑定成功后即可提供直播、控制等业务功能。
五、关键备注
核心技术要点：
- AP模式必开P2P模块：设备进入AP模式后必须启动P2P模块，否则无法与APP进行局域网指令交互；
- P2P模块无需重启：设备从AP模式切换到Station模式后，一般无需重启P2P模块，直接复用即可，减少初始化耗时；
- 预扫描WiFi优化：设备启动AP模式后，可后台预先扫描周围WiFi列表并缓存，收到APP查询指令时直接返回，缩短配网等待时间；
- 扩展交互支持：配网过程中如需额外交互（如查询设备型号、固件版本、恢复出厂设置等），可通过自定义IO cmd实现，参考SDK IO控制指令扩展规范。
六、优化建议
配网体验提升方案：
- APP自动切热点：获取手机WiFi权限后，APP可检测设备AP热点并自动连接，配网完成后自动切回原WiFi，无需用户手动操作；
- 密码强度校验：APP端对WiFi密码进行强度校验（如长度≥8字节、包含字母+数字），并提示用户，减少因密码错误导致的配网失败；
- 状态实时反馈：APP通过进度条、文字提示（如“连接设备热点中”“查询WiFi列表”“配置下发中”）展示配网进度，设备通过指示灯闪烁频率区分状态（如快闪=AP模式、慢闪=配网中、常亮=配网成功）；
- 异常重试机制：配网失败时（如WiFi密码错误、信号弱），APP支持一键重试，无需重新进入配网流程，直接重新下发配置。
七、注意事项
配网稳定性约束
1. 热点连接限制：设备AP模式下通常仅支持1-2台设备同时连接，需在APP中提示用户配网时关闭其他设备的WiFi连接；
2. WiFi参数校验：设备端需严格校验APP下发的WiFi参数（如SSID长度≤31字节、密码长度8-63字节），避免非法参数导致配网失败；
3. 信号强度适配：配网时需确保手机与设备距离较近（建议1-3米），避免WiFi信号弱导致指令传输失败；
4. 模式切换超时：设备切换Station模式后，连接WiFi的超时时间建议设置为30秒，超时后自动回退AP模式，提升用户体验。
