微信小程序之Wi-Fi-小程序打通接口文檔，微信小程序用戶連Wi-Fi后長期逗留在場所內，可以在連接Wi-Fi后進入微信點擊微信聊首頁歡迎語，即可進入預先設置的小程序中獲得資訊或服務，查詢門店WiFi信息接口和連Wi-Fi完成頁跳轉小程序。

目錄：

1、連Wi-Fi完成頁跳小程序
2、商戶主頁跳轉小程序
3、查詢門店Wi-Fi信息接口

1、連Wi-Fi完成頁跳轉小程序

設置聯網完成頁接口

場景介紹：
設置需要跳轉的小程序，連網完成點擊“完成”按鈕，即可進入設置的小程序。

注：只能跳轉與公眾號關聯的小程序。

接口調用
接口調用說明

協議：https
請求方式: POST  
請求URL： https://api.weixin.qq.com/bizwifi/finishpage/set?access_token=ACCESS_TOKEN  
POST數據格式：JSON

請求參數說明

POST數據

數據示例：

{
  "shop_id": 429620,
  "finishpage_url": "",  
  "wxa_user_name": "gh_966b66e00888",  
  "wxa_path": "pages/index/index",  
  "finishpage_type": 1  
}

字段說明

##2、設置頂部banner跳轉小程序接口

場景介紹：

用戶連Wi-Fi后長期逗留在場所內，可以在連接Wi-Fi后進入微信點擊微信聊首頁歡迎語，即可進入預先設置的小程序中獲得資訊或服務。

注：只能跳轉與公眾號關聯的小程序。

接口調用

接口調用說明

協議：https
請求方式: POST  
請求URL：https://api.weixin.qq.com/bizwifi/homepage/set?access_token=ACCESS_TOKEN  
POST數據格式：JSON

請求參數說明

POST數據

數據示例：

{
    "shop_id": 2200766,  
    "template_id": 2,  
    "struct": {  
        "wxa_user_name": "gh_5cb1b4334f3a",  
        "wxa_path": "index.html?query=abc"  
    }
}

字段說明

3、查詢門店WiFi信息接口

場景介紹

接口調用說明

協議：https  
http請求方式: POST  
請求URL：https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN  
POST數據格式：JSON

請求參數說明

POST數據

數據示例：

{  
  "errcode": 0,  
  "data": {  
    "shop_name": "南山店",  
    "ssid": " WX123",  
    "ssid_list": [  
      "WX123",  
      "WX456"  
    ],  
    "ssid_password_list": [  
      {  
        "ssid": "WX123",  
        "password": "123456789"  
      },  
      {  
        "ssid": "WX456",  
        "password": "21332465dge"  
      }  
    ],  
    "password": "123456789",  
    "protocol_type": 4,  
    "ap_count": 2,  
    "template_id": 1,  
    "homepage_url": "http://www.weixin.qq.com/",  
    "bar_type": 1,  
    "sid":"",  
    "poi_id":"285633617",  
    "homepage_wxa_user_name":"",  
    "homepage_wxa_path":"",  
    "finishpage_url":"",  
    "finishpage_wxa_user_name":"gh_966b66e00888",  
    "finishpage_wxa_path":"pages/index/index",  
    "finishpage_type":1,  
  }  
}

字段說明

在小程序中支持搜索周邊的 Wi-Fi，同時可以針對指定 Wi-Fi，傳入密碼發起連接。

該系列接口為系統原生能力，如需查看“微信連Wi-Fi”能力及配置跳轉小程序，請參考文檔。

連接指定 Wi-Fi 接口調用時序：

• Android： startWifi —> connectWifi —> onWifiConnected

• iOS（僅iOS 11及以上版本支持）：
  startWifi —> connectWifi —> onWifiConnected

連周邊 Wi-Fi 接口調用時序：

• Android startWifi —> getWifiList —> onGetWifiList —> connectWifi —> onWifiConnected

• iOS（iOS 11.0及11.1版本因系統原因暫不支持）：
  startWifi —> getWifiList —> onGetWifiList —> setWifiList —> onWifiConnected

注意：

• Wi-Fi 相關接口暫不可用 wx.canIUse 接口判斷。

• Android 6.0 以上版本，在沒有打開定位開關的時候會導致設備不能正常獲取周邊的 Wi-Fi 信息。

wx.startWifi(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

初始化 Wi-Fi 模塊。

OBJECT參數說明：

示例代碼：

wx.startWifi({
  success: function(res) { console.log(res.errMsg)
  }
})

wx.stopWifi(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

關閉 Wi-Fi 模塊。

OBJECT參數說明：

示例代碼：

wx.stopWifi({
  success: function(res) { console.log(res.errMsg)
  }
})

wx.connectWifi(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

連接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用該接口連接。僅 Android 與 iOS 11 以上版本支持。

OBJECT參數說明：

示例代碼：

wx.connectWifi({
  SSID: '',
  BSSID: '',
  success: function(res) { console.log(res.errMsg)
  }
})

wx.getWifiList(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

請求獲取 Wi-Fi 列表，在 onGetWifiList 注冊的回調中返回 wifiList 數據。iOS 將跳轉到系統的 Wi-Fi 界面，Android 不會跳轉。 iOS 11.0 及 iOS 11.1 兩個版本因系統問題，該方法失效。但在 iOS 11.2 中已修復。

OBJECT參數說明：

wx.onGetWifiList(CALLBACK)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

監聽在獲取到 Wi-Fi 列表數據時的事件，在回調中將返回 wifiList。

CALLBACK 返回參數說明：

Wi-Fi 列表項說明：

wx.setWifiList(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

iOS特有接口 在 onGetWifiList 回調后，利用接口設置 wifiList 中 AP 的相關信息。

注意：

1. 該接口只能在 onGetWifiList 回調之后才能調用。

2. 此時客戶端會掛起，等待小程序設置 Wi-Fi 信息，請務必盡快調用該接口，若無數據請傳入一個空數組。

3. 有可能隨著周邊 Wi-Fi 列表的刷新，單個流程內收到多次帶有存在重復的 Wi-Fi 列表的回調。

OBJECT參數說明：

Wi-Fi 信息列表項說明：

示例代碼：

wx.onGetWifiList({
  success: function(res) { if (res.wifiList.length) {
      wx.setWifiList({
        wifiList: [{
          SSID: res.wifiList[0].SSID,
          BSSID: res.wifiList[0].BSSID,
          password: '123456' }]
      })
    } else {
      wx.setWifiList({
        wifiList: []
      })
    }
  }
})
wx.getWifiList()

wx.onWifiConnected(CALLBACK)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

監聽連接上 Wi-Fi 的事件。

CALLBACK 返回參數說明：

wifi對象說明：

wx.getConnectedWifi(OBJECT)

基礎庫 1.6.0 開始支持，低版本需做兼容處理

獲取已連接中的 Wi-Fi 信息

OBJECT參數說明：

success返回參數說明：

wifi對象說明：

errCode列表

每個接口調用的時候，都會返回 errCode 字段。