連wifi之前wi-fi開發(fā)faq Wi Fi常見問題匯總

1、連 Wi-Fi 常見問題匯總連Wi-Fi 出現(xiàn)異常的可能性312獲取Wi-Fi時(shí)，出現(xiàn)GetQrcode Additional information:Assert.AreEqual 失敗。應(yīng)為: ，實(shí)際為: 。生成服務(wù)發(fā)生錯(cuò)誤，生成失敗 的提示。43.一個(gè)是否綁定一個(gè)，只能添加 1 個(gè) AP 設(shè)備而不能添加 2 個(gè)以上進(jìn)行調(diào)試？44.獲取白時(shí)出現(xiàn)token的提示45.IOS 的白. 56.設(shè)置 AP 時(shí)，出現(xiàn)vendor not found的提示。57.AP 信息到系統(tǒng)是以什么信息進(jìn)行識別？58 有無獲取 AP 信息的接口,如何確認(rèn) AP 是否設(shè)置成功的？59 設(shè)置 AP 信息是否支持分批設(shè)

2、置？510.設(shè)置 AD 時(shí)出現(xiàn)API 系統(tǒng)錯(cuò)誤的提示611.當(dāng)掃完成連接Wi-Fi 但沒有顯示相應(yīng)的 AD 頁面612.portal 上號如何綁定？613.回調(diào)請求server 請求參數(shù)說明614.回調(diào)請求客戶端返回參數(shù)說明715.設(shè)置Wi-Fi 開發(fā)者配置信息參數(shù)說明（callbackUrl、token）716. IOS 自動彈portal（認(rèn)證頁）的解決方法717. 使用 PC 掃碼之后，出現(xiàn)”網(wǎng)絡(luò)連接已過期，店員 ”的提示818. 使用同一個(gè)acs_token 調(diào)用不同的API,但是有的能調(diào)用成功，有的提示”token”？ . 819.bar 什么時(shí)候出現(xiàn)？820. 外部JSAPI 無法

3、調(diào)起？ . 821.掃碼后無法拉取到自定義BAR？922.P6，掃碼AP 成功后，會調(diào)起瀏覽器打開騰訊介紹頁？923.OPPO 等部分機(jī)型， 從wifi1 掃碼連接wifi2 時(shí)，無法成功？924. 1 AP 多b如何進(jìn)行上報(bào)？925. 關(guān)于通知action 狀態(tài)上報(bào)91連Wi-Fi 出現(xiàn)異常的可能性答：根據(jù)連 Wi-Fi 的流程，出現(xiàn)異常有以下幾種可能：1） 當(dāng)正常掃碼后，發(fā)起請求（步驟 6），AP 未進(jìn)行 302 跳轉(zhuǎn)并回傳正確的 auth 信息。2） 當(dāng)發(fā)起白請求時(shí)（步驟 8），未設(shè)置白到 AP 中、未設(shè)置Wi-Fi 開發(fā)者配置信息（設(shè)置 callbackUrl 和 token）、客戶端

4、未收到回調(diào)請求（步驟 10）、客戶端針對回調(diào)請求返回給server 參數(shù)錯(cuò)誤（步驟 11，參數(shù)錯(cuò)誤如：某些參數(shù)必填 store_name、store_id、device_no 等，login_allow 未設(shè)置等）這四種情況都將導(dǎo)致白返回錯(cuò)誤。3） 當(dāng)發(fā)起 login 請求時(shí)（步驟 13），AP 未進(jìn)行 302 跳轉(zhuǎn)攜帶 res 參數(shù)。4） 當(dāng)走完了步驟 13，并且 AP 返回了 302 跳轉(zhuǎn)并攜帶 res 參數(shù)，但還是顯示連接中，此時(shí)應(yīng)檢查接口回調(diào)請求返給server 的參數(shù)，當(dāng)返回參數(shù)異常時(shí)（如將英文的” ”寫成中文的“ ”，參數(shù)類型為字符串但未帶” ”等），將導(dǎo)致微信連 Wi-Fi 一直

5、處在連接中。2 獲取 Wi-Fi時(shí)， 出現(xiàn)GetQrcode Additional information:Assert.AreEqual 失敗。應(yīng)為: ，實(shí)際為: 。生成服務(wù)發(fā)生錯(cuò)誤，生成失敗 的提示。答：針對連 wifi 1.0 之前版本，客戶端(開發(fā)者)是否提供物料底圖，未提供則會出現(xiàn)上述提示；連wifi 1.0 之后版本，不需要提供物料底圖，需要設(shè)置templateId=1。檢查T 的參數(shù)的拼寫、類型及取值（如將 lgnId 寫成 lgnid，bgurl的不能），注意和 PC 獲取 Wi-Fi的參數(shù)不一致等等（如當(dāng) PC 設(shè)備獲取時(shí)需傳lgnId,獲取時(shí)則不需傳此參數(shù)；當(dāng) PC 設(shè)備獲

6、取時(shí)需傳入 templateId 為 100）。3.一個(gè)是否綁定一個(gè)，只能添加 1 個(gè)AP 設(shè)備而不能添加 2 個(gè)以上進(jìn)行調(diào)試？答：目前可帶門店 id 信息，但還不是必填，建議一個(gè)只對應(yīng)到一個(gè)門店，多個(gè)門店不建議使用同一個(gè)；一個(gè)門店下可以有多個(gè) AP。4.獲取白時(shí)出現(xiàn)token的提示答：由于獲取白信息參數(shù)只有 acs_token 和 format（值固定為 json）兩個(gè)參數(shù),所以可從 acs_token 入手，通過客戶端(開發(fā)者)的 ap和 secret 重新生成一個(gè)acs_token 并調(diào)用獲取白信息看看是否能成功返回白信息，若成功則說明舊的 acs_token 已被刷新掉。5.IOS 的

7、白答：6.設(shè)置 AP 時(shí)，出現(xiàn)vendor not found的提示。答：客戶端(開發(fā)者)未提供 callbackurl、token,未添加vendor。7.AP 信息到系統(tǒng)是以什么信息進(jìn)行識別？答：以 deviceno 作為唯一標(biāo)識。8 有無獲取 AP 信息的接口,如何確認(rèn) AP 是否設(shè)置成功的？答：設(shè)置 AP 失敗會有 errorcode 和 errormsg,當(dāng) AP 設(shè)置失敗時(shí)設(shè)置 AD 會提示不存在。9 設(shè)置 AP 信息是否支持分批設(shè)置？答：設(shè)置 AP 是批量接口，支持傳 aplist，并且 AP 是可以覆蓋更新的，根據(jù) deviceno 來更新。10. 設(shè)置AD 時(shí)出現(xiàn)API 系統(tǒng)

8、錯(cuò)誤的提示答：檢查T 參數(shù)的拼寫、類型及取值（ 如 deviceNos 是 json 串， 取值應(yīng)為deviceNos:deviceno1,deviceno2;請求參數(shù)為字符串時(shí)，必須加）。11. 當(dāng)掃完成連接Wi-Fi 但沒有顯示相應(yīng)的 AD 頁面答：可以考慮以下兩個(gè)可能性：1） 未調(diào)用設(shè)置AD 接口。2）server 調(diào)用客戶端的服務(wù)器做的時(shí)候，設(shè)備正確返回device_no（回調(diào)請求設(shè)備商返回給server 的AP 序列號必須與接口設(shè)置AP 信息中的一致）。12.portal 上號如何綁定？答：設(shè)置 AD 信息中有一參數(shù) mpAccount-公眾賬號的，如果設(shè)置且為真實(shí)的號則顯示“關(guān)注”

9、按鈕。13. 回調(diào)請求server 請求參數(shù)說明答：lgnid 是 pc 認(rèn)證才會有的，當(dāng)調(diào)用接口 2 獲取 Wi-Fi時(shí)傳入(接口 2 獲取 WIFI中，當(dāng) PC 設(shè)備獲取動態(tài)時(shí)傳入的 lgnId)。wxuid 是全局唯一，目前是用戶的 openId,和的 openId 無關(guān)系。14. 回調(diào)請求客戶端返回參數(shù)說明答：login 是最后登錄認(rèn)證用的，可以是設(shè)備商服務(wù)器地址，也可以是設(shè)備商的 ap 的內(nèi)網(wǎng)認(rèn)證地址，不同設(shè)備商實(shí)現(xiàn)方式都不一樣，只是原樣請求，目的是讓 ap 放行并通知。key 的規(guī)則也是由客戶端定,不做任何處理(返回 login 時(shí)，不需要對整個(gè) url 作編碼，一般只需要對所帶的

10、參數(shù)的值作編碼即可，server 會自動)。logout 參數(shù)目前未做控制。login_allow 為允許上網(wǎng)時(shí)間，默認(rèn)為 0,必須重新設(shè)置 login_allow（客戶端Android 版已做，IOS 版未做，若不重新設(shè)置，則可能導(dǎo)致 IOS 設(shè)備能完成連 Wi-Fi 上網(wǎng)流程，而 Android 設(shè)備則不能完成連 Wi-Fi 上網(wǎng)）。15. 設(shè)置Wi-Fi 開發(fā)者配置信息參數(shù)說明（callbackUrl、token）答：callbackUrl 即回調(diào)URL,token 即SERVER 在回調(diào)請求時(shí)會帶上此token，這樣 Wi-Fi 開發(fā)者可以檢驗(yàn)調(diào)用是否來自，而不是其他不的調(diào)用。16.

11、IOS 自動彈portal（認(rèn)證頁）的解決方法答：目前有兩個(gè)解決辦法，如下所示：1）把 IOS 服務(wù)器設(shè)置到白；2） AP 上判斷 http 的請求的 useragent 帶有 captive network support， 直接放行，或者直接返回 sucs 給這個(gè) http 請求。17. 使用PC 掃碼之后，出現(xiàn)”網(wǎng)絡(luò)連接已過期，店員 ”的提示答：查看接口 2 獲取 Wi-Fi傳的 expiretime 參數(shù)，expiretime 為過期時(shí)間，是為秒的 UNIX 時(shí)間戳。某些開發(fā)者給到的是毫秒級的數(shù)據(jù)，導(dǎo)致時(shí)間較短，二維碼失效，從而出現(xiàn)此提示，建議開發(fā)者調(diào)整 expiretime 為秒級

12、UNIX 時(shí)間戳。18. 使用同一個(gè) acs_token 調(diào)用不同的 API,但是有的能調(diào)用成功，有的提示”token”？答： 接口的調(diào)用頻率限制不一樣，即每天調(diào)用次數(shù)不同。超出限制，則會提示”token 非法 ”。19.bar 什么時(shí)候出現(xiàn)？答： 可以分為以下幾種情況1）客戶端（android、IOS 設(shè)備）經(jīng)過掃碼后，會出現(xiàn)bar。2） 當(dāng)客戶端（android、IOS 設(shè)備）之前已進(jìn)行過掃碼連接，現(xiàn)在離開 AP再次進(jìn)入的話，客戶端會自動連接AP 出現(xiàn)bar。20. 外部JSAPI 無法調(diào)起？答： 商家 setAP 時(shí)，未將b（無線 MAC）入。21.掃碼后無法拉取到自定義BAR？答：獲取

13、自定義 BAR 內(nèi)容，必須滿足 2 個(gè)條件，第一，客戶端為 6.0.2 及以上（以下的APAUTH 未上傳無線 MAC 地址），第二，商家 b（無線 MAC）已經(jīng)否則無法獲取到自定義 BAR。22.P6，掃碼AP 成功后，會調(diào)起瀏覽器打開騰訊介紹頁？答：P6 系統(tǒng)發(fā)起了 HTTP 請求，因?yàn)闆]在白里，因此彈出上面這個(gè) 302 頁面,開發(fā)者應(yīng)加入白并升級固件。23.OPPO 等部分機(jī)型， 從wifi1 掃碼連接wifi2 時(shí)，無法成功？答：安卓系統(tǒng)。導(dǎo)致調(diào)取系統(tǒng)切換網(wǎng)絡(luò)的接口出錯(cuò)，OPPOX909 android4.2.2 手機(jī)在其他WIFI 下掃碼連接時(shí)，LOG 提示當(dāng)前網(wǎng)絡(luò)沒有切換到要連的 WIFI，鎖屏再解鎖后才連上了該 WIFI。C8816D 在其他 WIFI 下掃碼連接時(shí)，l