getConnectedWifi
获取当前已连接 Wi-Fi 信息。
扫码预览
使用限制
WARNING
Android、iOS:豆包 Android 返回 0 到 100 的信号等级,iOS 返回 0 到 1 的归一化值;跨端使用同一阈值判断信号强弱会出错。
支持版本
前端库版本不低于 0.0.25。
支持平台
支持场景
接入准备
权限要求
授权行为
- iOS:首次读取 Wi-Fi 信息前会触发应用位置授权(scope.userLocation)与系统定位权限申请;用户拒绝后调用失败,需引导用户在系统设置及应用设置中开启位置权限
- Android:读取 Wi-Fi 信息依赖已授予的系统定位权限;未授予或被撤销时调用失败,需引导用户在系统设置中开启定位权限
前置条件
- 需先调用 startWifi 完成初始化
使用说明
- signalStrength 量纲双端不一致,Android 为 0 到 100,iOS 为 0 到 1
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:未连接或因缺少定位权限无法读取时统一返回 1401002;未初始化返回 1401001。
- iOS:读取前会发起位置权限授权,可返回 106/107 及授权网络类失败(301/302/303/305/112);读取阶段未连接返回 1401002。