my.getwifilist(object object)
基础库 或更高版本; 若版本较低,建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具: 不支持。
主体: 企业支付宝小程序
相关文档: wi-fi 概览
请求获取 wi-fi 列表。
在 android 上,成功获取 wifi 列表以后会触发通过 ongetwifilist 注册的回调函数。
在 ios 上,调用此 api 会跳转到支付宝设置页(用户可手工连接 wifi),不会触发 ongetwifilist 注册的回调。
注意: android 上需要用户已对支付宝授权位置信息,getwifilist 调用才能成功,否则将会报错(错误码 12006)。
object object
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
success | function | - | 否 | 调用成功的回调函数 |
fail | function | - | 否 | 调用失败的回调函数 |
complete | function | - | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
fail 回调的参数为 object,error
属性为错误码,errormessage
属性为错误消息。
错误码的详细信息请查看 wi-fi 概览 - 错误码列表 。
代码示例
// 初始化 wi-fi 模块
my.startwifi({
success: function(res) {
// 请求获取 wi-fi 列表。
my.getwifilist({
success:(res)=>{
console.log('getwifilist success',res);
}
});
}
});
// 请求 wi-fi 列表成功后,获取 wifilist 数据
my.ongetwifilist(res => {
console.log('ongetwifilist',res);
});