getWifiList
获取 Wi-Fi 列表。
扫码预览
使用限制
WARNING
iOS:豆包 iOS 无系统扫描能力,仅返回当前已连接的一条 Wi-Fi;iOS 上无法列出周边 Wi-Fi,列表最多一条。
支持版本
前端库版本不低于 0.0.25。
支持平台
支持场景
接入准备
权限要求
授权行为
- iOS:首次获取 Wi-Fi 列表前会触发应用位置授权(scope.userLocation)与系统定位权限申请;用户拒绝后调用失败,需引导用户在系统设置及应用设置中开启位置权限
- Android:获取 Wi-Fi 列表依赖已授予的系统定位权限;未授予或被撤销时调用失败,需引导用户在系统设置中开启定位权限
前置条件
- 需先调用 startWifi 完成初始化
使用说明
通常先调用 startWifi。
- iOS:列表最多返回一条当前已连接的 Wi-Fi,不代表周边可用网络
调用方式
异步 API
入参
无。
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:未初始化返回 1401001;扫描列表为空不视为失败;因定位权限不足导致读取失败时返回 102。
- iOS:仅返回当前已连接 Wi-Fi,未连接返回 1401002;读取前会发起位置权限授权,可返回 106/107 及授权网络类失败(301/302/303/305/112)。