您的位置：鳄鱼CMS > 微信小程序api文档微信小程序API WIFI

微信小程序api文档微信小程序API WIFI

2023-04-10 18:31

微信小程序api文档

wx.stopWifi(Object object)

关闭 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)

初始化 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)

设置 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)

监听连接上 Wi-Fi 的事件

参数

function callback

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

参数

Object res

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

wx.onGetWifiList(function callback)

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

参数

function callback

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

参数

Object res

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

wx.offWifiConnected(function callback)

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

参数

function callback

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

wx.offGetWifiList(function callback)

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

参数

function callback

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

wx.getWifiList(Object object)

请求获取 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)

获取已连接中的 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)

连接 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

Wi-Fi 频段单位 MHz

阅读全文

以上是鳄鱼CMS为你收集整理的微信小程序api文档微信小程序API WIFI全部内容。

声明：本站所有文章资源内容，如无特殊说明或标注，均为采集网络资源。如若本站内容侵犯了原著者的合法权益，可联系本站删除。

微信小程序ocr识别接口微信小程序 OCR·businessLicense

2023-05-18

ocr.businessLicense本接口应在服务器端调用，详细说明参见服务端API。本接口支持云调用。需开发者工具版本 =1.02.1904090（最新...
微信小程序服务微信小程序服务市场·invokeService

2023-04-04

serviceMarket.invokeService本接口应在服务器端调用，详细说明参见服务端API。本接口支持云调用。需开发者工具版本 =1.02.19040...
微信小程序云开发多端支持什么微信小程序云开发多端支持

2023-03-31

多端支持云开发除了支持小程序端 SDK、云函数端 SDK 访问外，从06/04起支持 Web 端 SDK 访问。Web SDKWeb SDK 在 Web 中使用，可...
vscode 合并代码 vscode 合并代码行

2023-05-15

有的时候你可能会为了避免代码看起来过于冗余，就会把比较短小的几行代码合并到一行里面去。这时，你只需要按下 “ Ctrl + j ” ...
vscode快速预览在浏览器 vscode 快速预览

2023-05-24

有的时候，当我们看到一个建议列表里的某个函数名，我们可能并不能够立刻想起它的作用是什么，它的参数定义是什么样的。这时候我...

猜您喜欢

标签TAG

本月热门

文章详情

微信小程序api文档 微信小程序API WIFI

微信小程序api文档 微信小程序API WIFI

微信小程序api文档

wx.stopWifi(Object object)

参数

Object object

错误

示例代码

wx.startWifi(Object object)

参数

Object object

错误

示例代码

wx.setWifiList(Object object)

参数

Object object

错误

注意

示例代码

wx.onWifiConnected(function callback)

参数

function callback

参数

Object res

wx.onGetWifiList(function callback)

参数

function callback

参数

Object res

wx.offWifiConnected(function callback)

参数

function callback

wx.offGetWifiList(function callback)

参数

function callback

wx.getWifiList(Object object)

参数

Object object

错误

wx.getConnectedWifi(Object object)

参数

Object object

object.success 回调函数

参数

Object res

错误

wx.connectWifi(Object object)

参数

Object object

错误

示例代码

WifiInfo

属性

string SSID

string BSSID

boolean secure

number signalStrength

number frequency

微信小程序ocr识别接口 微信小程序 OCR·businessLicense

微信小程序 服务 微信小程序 服务市场·invokeService

微信小程序云开发多端支持什么 微信小程序云开发 多端支持

vscode 合并代码 vscode 合并代码行

vscode快速预览在浏览器 vscode 快速预览

微信小程序api文档微信小程序API WIFI

微信小程序api文档微信小程序API WIFI

微信小程序ocr识别接口微信小程序 OCR·businessLicense

微信小程序服务微信小程序服务市场·invokeService

微信小程序云开发多端支持什么微信小程序云开发多端支持