• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 网络状态
  • tt.getNetworkType
  • tt.onNetworkStatusChange
  • tt.getWifiList
  • tt.onGetWifiList
  • tt.offGetWifiList
  • tt.offNetworkStatusChange
  • tt.onNetworkWeakChange
  • 系统信息
  • Wi-Fi
  • 加速度计
  • 罗盘
  • 拨打电话
  • 扫码
  • 剪贴板
  • 屏幕
  • 陀螺仪
  • 加密
  • 短信
  • 日历
  • 振动
  • 性能
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 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

    系统其他错误

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    119901wifi not turned onU
    未打开 wifi

    请提示用户打开 Wifi

    1.49.0
    119902gps not turned onU
    未打开 gps

    请提示用户打开 gps

    1.49.0
    119903have no location authU
    没有定位权限

    请提示用户打开定位权限

    1.49.0
    119904system not supportF
    小程序框架内部错误,有需要请创建工单咨询
    1.49.0
    119986invoke is too frequentD
    调用过于频繁

    降低调用频率

    1.49.0
    119989system auth denyU
    用户拒绝系统地理位置授权

    用户未授予系统权限,请引导用户按需授权

    1.49.0
    119990auth denyU
    用户拒绝授权

    用户未授予小程序授权,请引导用户按需授权,详情参考 用户授权

    1.49.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

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