快應(yīng)用 Wifi

接口聲明

{ "name": "system.wifi" }

導(dǎo)入模塊

import wifi from '@system.wifi' 或 const wifi = require('@system.wifi')

接口定義

方法

wifi.connect(OBJECT)

連接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用該接口連接。

權(quán)限要求

粗略設(shè)備定位

參數(shù)：

fail 返回錯(cuò)誤代碼：

示例：

wifi.connect({
  SSID: '',
  BSSID: '',
  success: function() {
    console.log('connect wifi success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

wifi.scan(OBJECT)

請(qǐng)求獲取 Wi-Fi 列表，在 onscanned 事件中返回 Wi-Fi 列表數(shù)據(jù)。

權(quán)限要求

粗略設(shè)備定位

參數(shù)：

fail 返回錯(cuò)誤代碼：

示例：

wifi.scan({
  success: function() {
    console.log('scan success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

wifi.getConnectedWifi(OBJECT)

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

權(quán)限要求

粗略設(shè)備定位

參數(shù)：

success 返回值：

fail 返回錯(cuò)誤代碼：

示例：

wifi.getConnectedWifi({
  success: function(data) {
    console.log(`handling success: ${data.SSID}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

事件

wifi.onscanned = function(data)

監(jiān)聽(tīng)在獲取到 Wi-Fi 列表數(shù)據(jù)時(shí)的事件，在回調(diào)中將返回 wifiList。

權(quán)限要求

粗略設(shè)備定位

返回參數(shù)說(shuō)明：

Wi-Fi 列表項(xiàng)說(shuō)明：

示例：

wifi.onscanned = function(data) {
  for (const i in data.wifiList) {
    console.log(`wifi: ${data.wifiList[i].SSID}`)
  }
}

wifi.onstatechanged = function(data)

監(jiān)聽(tīng)連接和斷開(kāi) Wi-Fi 的事件。

權(quán)限要求

粗略設(shè)備定位

返回參數(shù)說(shuō)明：

示例：

wifi.onstatechanged = function(data) {
  console.log(`handling wifi state changed: ${data.state}`)
}

后臺(tái)運(yùn)行限制

禁止使用。后臺(tái)運(yùn)行詳細(xì)用法參見(jiàn) 后臺(tái)運(yùn)行腳本。