微信小程序API WIFI

wx.stopWifi(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

關(guān)閉 Wi-Fi 模塊。

參數(shù)

Object object

錯誤

示例代碼

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

wx.startWifi(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

初始化 Wi-Fi 模塊。

參數(shù)

Object object

錯誤

示例代碼

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

wx.setWifiList(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

設(shè)置 wifiList 中 AP 的相關(guān)信息。在 onGetWifiList 回調(diào)后調(diào)用，iOS特有接口。

參數(shù)

Object object

object.wifiList 的結(jié)構(gòu)

錯誤

注意

• 該接口只能在 onGetWifiList 回調(diào)之后才能調(diào)用。
• 此時客戶端會掛起，等待小程序設(shè)置 Wi-Fi 信息，請務(wù)必盡快調(diào)用該接口，若無數(shù)據(jù)請傳入一個空數(shù)組。
• 有可能隨著周邊 Wi-Fi 列表的刷新，單個流程內(nèi)收到多次帶有存在重復(fù)的 Wi-Fi 列表的回調(diào)。

示例代碼

wx.onGetWifiList(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(function callback)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

監(jiān)聽連接上 Wi-Fi 的事件

參數(shù)

function callback

連接上 Wi-Fi 的事件的回調(diào)函數(shù)

參數(shù)

Object res

wx.onGetWifiList(function callback)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

監(jiān)聽獲取到 Wi-Fi 列表數(shù)據(jù)事件

參數(shù)

function callback

獲取到 Wi-Fi 列表數(shù)據(jù)事件的回調(diào)函數(shù)

參數(shù)

Object res

wx.offWifiConnected(function callback)

基礎(chǔ)庫 2.9.0 開始支持，低版本需做兼容處理。

取消監(jiān)聽連接上 Wi-Fi 的事件。

參數(shù)

function callback

連接上 Wi-Fi 的事件的回調(diào)函數(shù)

wx.offGetWifiList(function callback)

基礎(chǔ)庫 2.9.0 開始支持，低版本需做兼容處理。

取消監(jiān)聽獲取到 Wi-Fi 列表數(shù)據(jù)事件。

參數(shù)

function callback

獲取到 Wi-Fi 列表數(shù)據(jù)事件的回調(diào)函數(shù)

wx.getWifiList(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

請求獲取 Wi-Fi 列表。在 onGetWifiList 注冊的回調(diào)中返回 wifiList 數(shù)據(jù)。 Android 調(diào)用前需要 用戶授權(quán) scope.userLocation。

iOS 將跳轉(zhuǎn)到系統(tǒng)的 Wi-Fi 界面，Android 不會跳轉(zhuǎn)。 iOS 11.0 及 iOS 11.1 兩個版本因系統(tǒng)問題，該方法失效。但在 iOS 11.2 中已修復(fù)。

參數(shù)

Object object

錯誤

wx.getConnectedWifi(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

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

參數(shù)

Object object

object.success 回調(diào)函數(shù)

參數(shù)

Object res

錯誤

wx.connectWifi(Object object)

基礎(chǔ)庫 1.6.0 開始支持，低版本需做兼容處理。

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

參數(shù)

Object object

錯誤

示例代碼

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

WifiInfo

Wifi 信息

屬性

string SSID

Wi-Fi 的 SSID

string BSSID

Wi-Fi 的 BSSID

boolean secure

Wi-Fi 是否安全

number signalStrength

Wi-Fi 信號強度

number frequency

基礎(chǔ)庫 2.12.0 開始支持，低版本需做兼容處理。

Wi-Fi 頻段單位 MHz