一、配網(wǎng)流程圖
圖1：IRIS配網(wǎng)完整流程圖
二、流程說明與對接
App讀取Device Profile中的 pairing mode 數(shù)組如下：
App按以下Json格式生成QRCode：
{"r":"","s":"","ss":"","p":"","re":""}
| 參數(shù) | 類型 | 是否必須 | 說明 |
|---|---|---|---|
r | string | 是 | realm，設(shè)備上傳信息時(shí)需填入此參數(shù) |
s | string | 是 | sessionId，設(shè)備上傳信息時(shí)需填入此參數(shù) |
ss | string | 是 | wifi ssid，設(shè)備需配置的wifi網(wǎng)絡(luò) |
p | string | 是 | wifi password，設(shè)備配置wifi網(wǎng)絡(luò)的密碼 |
re | string | 是 | region，根據(jù)設(shè)備出貨的區(qū)域訪問對應(yīng)的iris服務(wù)器 |
注：App端對以上定義的參數(shù)的內(nèi)容（例如：特殊字符、中文等）未做任何轉(zhuǎn)換處理。
設(shè)備端解碼出QRCode內(nèi)容后，參考以下步驟完成對接流程：
1. 設(shè)備端讀取QRCode中的 ss 和 p 參數(shù)，將設(shè)備配置到該WiFi網(wǎng)絡(luò)下。
2. 設(shè)備端讀取QRCode中的 r、s 和 re 參數(shù)，將參數(shù)帶入HTTP請求中，上傳給IRIS服務(wù)器。
請求URL：
- https://{iris_domain}/iris/api/v1/prevali/session/{sessionId}?realm={realm}
請求方式：post
Request Headers：
- Content-Type：application/json
| 參數(shù) | 類型 | 是否必須 | 說明 |
|---|---|---|---|
| realm | string | 是 | 此處為取QRCode中的 r 參數(shù)。 |
| sessionId | string | 是 | 此處為取QRCode中的 s 參數(shù)。 |
| 參數(shù) | 類型 | 是否必須 | 說明 |
|---|---|---|---|
| secretData | object | 是 | 建議帶入credential 和 udid |
| credential | string | 是 | 設(shè)備的credential |
| udid | string | 是 | 設(shè)備的udid |
例如設(shè)備的信息如下：
使用JSON格式組裝信息：
進(jìn)行base64編碼生成credential：
ewoJ4oCcYXbigJ06IOKAnDg4ODg4ODg44oCdLAoJ4oCcYWvigJ06IOKAnDAwMDAwMDAw4oCdLAoJ4oCcaWRlbnRpdHnigJ06IOKAnGFkbWlu4oCdCn0=
關(guān)于設(shè)備端如何啟用P2P模塊，請參考：基于AVAPIs模塊開發(fā)網(wǎng)絡(luò)攝像機(jī)-設(shè)備端
三、示例
- App按以下Json格式生成QRCode：
{"r":"kalayapp-cn","s":"579vca7h8wcj3g2wg1a9","ss":"TUTK-GUEST","p":"hshhs","re":"cn"}
- 最終設(shè)備上傳給IRIS服務(wù)器的信息為：
請求URL：
- post：https://cn-iris-tutk.kalay.net.cn/iris/api/v1/prevali/session/579vca7h8wcj3g2wg1a9?realm=kalayapp-cn
Request Headers：
- Content-Type：application/json
Body：
