快應用 Wifi

接口聲明

{ "name": "system.wifi" }

導入模塊

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

接口定義

方法

wifi.connect(OBJECT)

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

權限要求

粗略設備定位

參數(shù)：

fail 返回錯誤代碼：

示例：

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

wifi.scan(OBJECT)

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

權限要求

粗略設備定位

參數(shù)：

fail 返回錯誤代碼：

示例：

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

wifi.getConnectedWifi(OBJECT)

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

權限要求

粗略設備定位

參數(shù)：

success 返回值：

fail 返回錯誤代碼：

示例：

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)聽在獲取到 Wi-Fi 列表數(shù)據(jù)時的事件，在回調(diào)中將返回 wifiList。

權限要求

粗略設備定位

返回參數(shù)說明：

Wi-Fi 列表項說明：

示例：

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

wifi.onstatechanged = function(data)

監(jiān)聽連接和斷開 Wi-Fi 的事件。

權限要求

粗略設備定位

返回參數(shù)說明：

示例：

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

后臺運行限制

禁止使用。后臺運行詳細用法參見 后臺運行腳本。