codecamp

微信小程序API WIFI

wx.stopWifi(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

关闭 Wi-Fi 模块。

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

示例代码

wx.stopWifi({
  success (res) {
    console.log(res.errMsg)
  }
})

wx.startWifi(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

初始化 Wi-Fi 模块。

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

示例代码

wx.startWifi({
  success (res) {
    console.log(res.errMsg)
  }
})

wx.setWifiList(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

设置 wifiList 中 AP 的相关信息。在 onGetWifiList 回调后调用，iOS特有接口。

参数

Object object

属性 类型 默认值 必填 说明
wifiList Array.<Object> 是 提供预设的 Wi-Fi 信息列表
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.wifiList 的结构

属性 类型 默认值 必填 说明
SSID string 否 Wi-Fi 的 SSID
BSSID string 否 Wi-Fi 的 BSSID
password string 否 Wi-Fi 设备密码

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

注意

  • 该接口只能在 onGetWifiList 回调之后才能调用。
  • 此时客户端会挂起，等待小程序设置 Wi-Fi 信息，请务必尽快调用该接口，若无数据请传入一个空数组。
  • 有可能随着周边 Wi-Fi 列表的刷新，单个流程内收到多次带有存在重复的 Wi-Fi 列表的回调。

示例代码

wx.onGetWifiList(function(res) {
  if (res.wifiList.length) {
    wx.setWifiList({
      wifiList: [{
        SSID: res.wifiList[0].SSID,
        BSSID: res.wifiList[0].BSSID,
        password: '123456'
      }]
    })
  } else {
    wx.setWifiList({
      wifiList: []
    })
  }
})
wx.getWifiList()

wx.onWifiConnected(function callback)

基础库 1.6.0 开始支持，低版本需做兼容处理。

监听连接上 Wi-Fi 的事件

参数

function callback

连接上 Wi-Fi 的事件的回调函数

参数

Object res
属性 类型 说明
wifi WifiInfo Wi-Fi 信息

wx.onGetWifiList(function callback)

基础库 1.6.0 开始支持，低版本需做兼容处理。

监听获取到 Wi-Fi 列表数据事件

参数

function callback

获取到 Wi-Fi 列表数据事件的回调函数

参数

Object res
属性 类型 说明
wifiList Array.<WifiInfo> Wi-Fi 列表数据

wx.offWifiConnected(function callback)

基础库 2.9.0 开始支持，低版本需做兼容处理。

取消监听连接上 Wi-Fi 的事件。

参数

function callback

连接上 Wi-Fi 的事件的回调函数

wx.offGetWifiList(function callback)

基础库 2.9.0 开始支持，低版本需做兼容处理。

取消监听获取到 Wi-Fi 列表数据事件。

参数

function callback

获取到 Wi-Fi 列表数据事件的回调函数

wx.getWifiList(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

请求获取 Wi-Fi 列表。在 onGetWifiList 注册的回调中返回 wifiList 数据。 Android 调用前需要 用户授权 scope.userLocation。

iOS 将跳转到系统的 Wi-Fi 界面，Android 不会跳转。 iOS 11.0 及 iOS 11.1 两个版本因系统问题，该方法失效。但在 iOS 11.2 中已修复。

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

wx.getConnectedWifi(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

获取已连接中的 Wi-Fi 信息。

参数

Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数
Object res
属性 类型 说明
wifi WifiInfo Wi-Fi 信息

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

wx.connectWifi(Object object)

基础库 1.6.0 开始支持，低版本需做兼容处理。

连接 Wi-Fi。若已知 Wi-Fi 信息，可以直接利用该接口连接。仅 Android 与 iOS 11 以上版本支持。

参数

Object object

属性 类型 默认值 必填 说明 最低版本
SSID string 是 Wi-Fi 设备 SSID
BSSID string 否 Wi-Fi 设备 BSSID
password string 是 Wi-Fi 设备密码
maunal boolean false 否 跳转到系统设置页进行连接，仅安卓生效 2.12.0
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码 错误信息 说明
0 ok 正常
12000 not init 未先调用 startWifi 接口
12001 system not support 当前系统不支持相关能力
12002 password error Wi-Fi 密码错误
12003 connection timeout 连接超时
12004 duplicate request 重复连接 Wi-Fi
12005 wifi not turned on Android 特有，未打开 Wi-Fi 开关
12006 gps not turned on Android 特有，未打开 GPS 定位开关
12007 user denied 用户拒绝授权链接 Wi-Fi
12008 invalid SSID 无效 SSID
12009 system config err 系统运营商配置拒绝连接 Wi-Fi
12010 system internal error 系统其他错误，需要在 errmsg 打印具体的错误原因
12011 weapp in background 应用在后台无法配置 Wi-Fi
12013 wifi config may be expired 系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试

示例代码

wx.connectWifi({
  SSID: '',
  password: '',
  success (res) {
    console.log(res.errMsg)
  }
})

WifiInfo

Wifi 信息

属性

string SSID

Wi-Fi 的 SSID

string BSSID

Wi-Fi 的 BSSID

boolean secure

Wi-Fi 是否安全

number signalStrength

Wi-Fi 信号强度

number frequency

基础库 2.12.0 开始支持，低版本需做兼容处理。

Wi-Fi 频段单位 MHz


微信小程序API 电量
微信小程序API NFC·关闭NFC模块
温馨提示
下载编程狮App，免费阅读超1000+编程语言教程
取消
确定
目录
微信小程序开发教程手册文档
体验微信小程序

微信小程序 指南

起步

目录结构

配置小程序

小程序框架

小程序运行时

自定义组件

插件

基础能力

硬件能力

开放能力

微信小程序 用户信息

微信小程序 消息

微信小程序 微信物流助手接口文档

微信小程序 快递接口(商家查看)

微信小程序 即时配送接口(商家查看)

微信小程序 广告

微信小程序 安全指引

微信小程序 调试

微信小程序 性能与体验

基础库

微信小程序 实时日志

微信小程序 小程序测速

微信小程序 小程序搜索

微信小程序 小程序直播

微信小程序 行业能力

微信小程序 城市服务

微信小程序 框架（MINA）

小程序配置

框架接口

微信小程序框架逻辑层(App Service)

微信小程序框架视图层(View)

性能

微信小程序 基础组件

视图容器

基础内容

微信小程序表单组件

导航

媒体组件

地图

画布

开放数据

客服会话

无标题文章

原生组件说明

无障碍访问

微信小程序 API

微信小程序API 网络

媒体

微信小程序API 地图

微信小程序API 图片

微信小程序API 视频

微信小程序API 音频

微信小程序API 背景音频

微信小程序API 实时音视频

微信小程序API 录音

微信小程序API 相机

微信小程序API 富文本

微信小程序API 音视频合成

微信小程序API 实时语音

微信小程序API 画面录制器

微信小程序API 视频解码器

文件

数据

微信小程序API 位置

微信小程序 设备

微信小程序API NFC

界面

微信小程序API 绘图

WXML节点信息

第三方平台

开放接口

微信小程序API 登录

微信小程序API 客服消息

微信小程序API 性能

数据

更新

拓展接口

多线程

调试接口

广告

路由

微信小程序 服务端

登录

用户信息

接口调用凭证

数据分析

客服消息

统一服务消息

动态消息

插件管理

附近的小程序

小程序码

内容安全

物流助手

微信小程序 小程序使用

微信小程序 运力方使用

广告

图像处理

即时配送

微信小程序 小程序使用

微信小程序 运力方使用

微信小程序 OCR

微信小程序 运维中心

微信小程序 小程序搜索

微信小程序 服务市场

微信小程序 生物认证

微信小程序 订阅消息

微信小程序 工具

微信小程序 云开发

基础

开发指引

小程序端

微信小程序云开发 数据库API

服务端

微信小程序云开发服务端API 数据库

微信小程序云开发服务端API 存储

计费相关

无标题文章

SDK文档

微信小程序云开发SDK文档 文件存储

微信小程序云开发SDK文档 微信支付

微信小程序云开发SDK文档 SDK数据库

SDK数据库 Collection

SDK数据库 Aggregate

SDK数据库 Command

SDK数据库 聚合操作符$

微信小程序云开发 SDK文档·HTTP API文档

微信小程序 扩展能力

WeUI组件库

扩展组件

框架扩展

工具库类

插件服务

服务平台

微信小程序开发文档-腾讯云支持
微信小程序 联系我们
微信小程序 Q&A

微信小程序设计规范

微信小程序源码分享
微信小游戏开发文档

关闭

 MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }