tt.getWifiList
收藏
我的收藏

基础库 1.49.0 开始支持本方法,这是一个异步方法。

请求获取 Wi-Fi 列表(对应打开手机 Wi-Fi 配置可以扫描到的 Wi-Fi 列表),需配合 tt.onGetWifiList 使用,在 tt.onGetWifiList 注册的回调中返回 wifiList 数据。

前提条件
业务背景
使用限制
iOS 不支持该 API;
注意事项
支持沙盒
相关教程

语法

tt.getWifiList(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
successfunction
接口调用成功的回调函数
1.49.0
failfunction
接口调用失败的回调函数
1.49.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.49.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"getWifiList:ok"
1.49.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"getWifiList:fail" + 详细错误信息
1.49.0

errMsg 参数说明

错误信息

说明

wifi not turned on

Android 特有,未打开 Wi-Fi 开关

gps not turned on

Android 特有,未打开 GPS 定位开关

privacy permission is not authorized

用户拒绝隐私协议授权,详见小程序隐私协议开发指南

api scope is not declared in the privacy agreement

隐私协议中未定义相关隐私信息类型,详见配置隐私协议

auth deny

用户未授权小程序获取位置的权限(scope.userLocation)

system auth deny

系统未授权 App 获取位置的权限

system not support

当前系统不支持相关能力

invalid SSID

无效 SSID

system internal error

系统其他错误

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.onGetWifiList(function (res) {
  console.log(`SSID: ${res.SSID}`);
  console.log(`BSSID: ${res.BSSID}`);
});
tt.getWifiList();