一、配網(wǎng)流程圖
圖 1:AP模式設(shè)備配網(wǎng)整體流程示意圖
二、功能概述
AP模式配網(wǎng)是通過“設(shè)備開啟熱點→手機連接熱點→局域網(wǎng)交互配置”的方式實現(xiàn)設(shè)備入網(wǎng),核心邏輯為:設(shè)備進入AP模式開啟熱點→手機連接設(shè)備熱點→局域網(wǎng)查詢設(shè)備/WiFi列表→手機下發(fā)WiFi配置→設(shè)備切換Station模式入網(wǎng)→手機綁定設(shè)備。該模式無需依賴外部WiFi,配網(wǎng)穩(wěn)定性高,適配無屏幕/簡易交互設(shè)備。
三、APP端主要流程
APP端通過與設(shè)備AP熱點建立局域網(wǎng)連接,完成設(shè)備發(fā)現(xiàn)、WiFi查詢、配置下發(fā)及最終綁定,步驟如下:
3.1 手機連接至設(shè)備的AP熱點
設(shè)備進入AP模式后會自動開啟專屬熱點(SSID通常為設(shè)備型號+UID后幾位,如“XXX-IPC-01-1234”),APP引導(dǎo)用戶手動連接該熱點;支持自動連接功能的APP,可通過系統(tǒng)WiFi接口檢測并自動切換連接(需獲取手機WiFi權(quán)限)。
3.2 手機進行局域網(wǎng)搜索,獲取設(shè)備UID
手機連接設(shè)備熱點后,通過局域網(wǎng)廣播(如UDP廣播)或SDK內(nèi)置搜索接口,掃描同一局域網(wǎng)內(nèi)的設(shè)備,獲取設(shè)備唯一標(biāo)識(UID),用于后續(xù)指令交互的目標(biāo)設(shè)備識別。
搜索方式示例:查看示例。
3.3 查詢設(shè)備周圍的WiFi列表
APP向設(shè)備發(fā)起P2P連線,連線成功后調(diào)用 avSendIOCtrl 發(fā)送 IOTYPE_USER_IPCAM_LISTWIFIAP_REQ 指令,向設(shè)備請求周圍可連接的WiFi網(wǎng)絡(luò)列表,便于用戶選擇目標(biāo)WiFi。
3.4 設(shè)定用戶選定的WiFi配置
用戶在APP展示的WiFi列表中選擇目標(biāo)網(wǎng)絡(luò)并輸入密碼后,APP將WiFi的SSID、密碼、加密模式等參數(shù)封裝,通過 IOTYPE_USER_IPCAM_SETWIFI_REQ 指令下發(fā)給設(shè)備。
3.5 接收響應(yīng)并斷開熱點連接
APP 接收設(shè)備返回的 IOTYPE_USER_IPCAM_SETWIFI_RESP 響應(yīng)(表示設(shè)備已成功接收WiFi配置)后,自動斷開與設(shè)備AP熱點的連接,切換回用戶的目標(biāo)WiFi網(wǎng)絡(luò)。
3.6 連接設(shè)備并完成綁定
手機重新連接目標(biāo)WiFi后,通過設(shè)備UID向TUTK服務(wù)器查詢設(shè)備在線狀態(tài),確認(rèn)設(shè)備已成功入網(wǎng)后,發(fā)起綁定請求(調(diào)用 AVIOTC_DevBind 接口),綁定成功后將設(shè)備信息(UID、型號、名稱等)存儲至手機本地或云端服務(wù)器,配網(wǎng)流程完成。
四、設(shè)備端主要流程
設(shè)備端通過進入AP模式、監(jiān)聽局域網(wǎng)指令、處理WiFi配置并切換工作模式,完成配網(wǎng),步驟如下:
4.1 進入AP模式,開啟P2P模塊
設(shè)備通過長按物理按鍵或上電觸發(fā),進入AP模式:開啟自身WiFi熱點(SSID固定格式),同時啟動P2P模塊并監(jiān)聽局域網(wǎng)連接(默認(rèn)端口可參考SDK配置)。詳細(xì)AP模式啟動P2P流程可參考:基于AVAPIs的家用攝像頭開發(fā)-設(shè)備端。
4.2 響應(yīng)WiFi列表查詢請求
設(shè)備通過 avRecvIOCtrl 接收到 IOTYPE_USER_IPCAM_LISTWIFIAP_REQ 指令后,啟動WiFi掃描功能,搜索周圍可用的WiFi網(wǎng)絡(luò),將SSID、信號強度、加密模式等信息通過 IOTYPE_USER_IPCAM_LISTWIFIAP_RESP 指令返回給APP。
4.3 響應(yīng)WiFi配置設(shè)定請求
設(shè)備接收到 IOTYPE_USER_IPCAM_SETWIFI_REQ 指令后,解析SSID、passwd、encrypt_type等參數(shù)并校驗合法性(如密碼長度、加密模式有效性),校驗通過后通過 IOTYPE_USER_IPCAM_SETWIFI_RESP 指令向APP返回“接收成功”響應(yīng)。
4.4 切換至Station模式
設(shè)備發(fā)送配置響應(yīng)后,關(guān)閉AP熱點及所有局域網(wǎng)連接,切換為Station模式,使用收到的WiFi參數(shù)嘗試連接目標(biāo)網(wǎng)絡(luò)。
- 連接成功:自動向TUTK服務(wù)器注冊設(shè)備信息,進入“待綁定”狀態(tài);
- 連接失?。嚎芍卦?-5次,重試失敗后重新進入AP模式,等待用戶重新配置。
4.5 進入正常工作模式
設(shè)備成功連接目標(biāo)WiFi并完成服務(wù)器注冊后,進入正常工作模式,等待APP發(fā)起綁定請求,綁定成功后即可提供直播、控制等業(yè)務(wù)功能。
