教程 其他 框架 组件 接口

Wi-Fi 1020+

接口声明

{ "name": "system.wifi" }

导入模块

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

接口定义

方法

wifi.connect(OBJECT)

连接 Wi-Fi。若已知 Wi-Fi 信息,可以直接利用该接口连接。

权限要求

粗略设备定位

参数:
参数名类型必填说明
SSIDStringWi-Fi 设备的 SSID
BSSIDStringWi-Fi 设备的 BSSID
passwordStringWi-Fi 设备密码
successFunction成功回调,此时 Wi-Fi 已经成功连接上
failFunction失败回调
completeFunction执行结束后的回调
fail 返回错误代码:
错误码说明
500应用在后台无法进行操作
1000Wi-Fi 密码错误
1001连接超时
1002重复连接 Wi-Fi
1003未打开 Wi-Fi 开关
1005无效 SSID
示例:
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 列表数据。

权限要求

粗略设备定位

参数:
参数名类型必填说明
successFunction扫描请求发起成功
failFunction扫描请求发起失败
completeFunction执行结束后的回调
fail 返回错误代码:
错误码说明
500应用在后台无法进行操作
1003未打开 Wi-Fi 开关
1004未打开位置服务开关。Android 6.0 及以上版本,没有打开位置服务开关会导致无法正常扫描周边的 Wi-Fi 信息
示例:
wifi.scan({
  success: function() {
    console.log('scan success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

wifi.getConnectedWifi(OBJECT)

获取已连接中的 Wi-Fi 信息

权限要求

粗略设备定位

参数:
参数名类型必填说明
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:
参数类型说明
SSIDStringWi-Fi 的 SSID
BSSIDStringWi-Fi 的 BSSID
secureBooleanWi-Fi 是否安全
signalStrengthNumberWi-Fi 信号强度
fail 返回错误代码:
错误码说明
200当前没有 Wi-Fi 连接
500应用在后台无法进行操作
1003未打开 Wi-Fi 开关
示例:
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)

监听在获取到 Wi-Fi 列表数据时的事件,在回调中将返回 wifiList。

权限要求

粗略设备定位

返回参数说明:
参数类型说明
wifiListArrayWi-Fi 列表数据
Wi-Fi 列表项说明:
参数类型说明
SSIDStringWi-Fi 的 SSID
BSSIDStringWi-Fi 的 BSSID
secureBooleanWi-Fi 是否安全
signalStrengthNumberWi-Fi 信号强度
示例:
wifi.onscanned = function(data) {
  for (const i in data.wifiList) {
    console.log(`wifi: ${data.wifiList[i].SSID}`)
  }
}

wifi.onstatechanged = function(data)

监听连接和断开 Wi-Fi 的事件。

权限要求

粗略设备定位

返回参数说明:
参数类型说明
stateNumberWi-Fi 是否连接的状态标识。连接断开:0;连接成功:1
SSIDStringWi-Fi 的 SSID。连接成功时有效
BSSIDStringWi-Fi 的 BSSID。连接成功时有效
secureBooleanWi-Fi 是否安全。连接成功时有效
signalStrengthNumberWi-Fi 信号强度。连接成功时有效
示例:
wifi.onstatechanged = function(data) {
  console.log(`handling wifi state changed: ${data.state}`)
}

后台运行限制

禁止使用。
后台运行详细用法参见后台运行 脚本

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容