uni.startWifi(option)

初始化Wi-Fi模块

本 API 是 uni ext api，需下载插件：uni-wifi

startWifi 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
option	WifiOption	是	-	-
名称 类型 必备 默认值 兼容性 描述 success (res: UniWifiResult) => void 否 - - - fail (res: UniError) => void 否 - - - complete (res: any) => void 否 - - -

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.stopWifi(option)

关闭 Wi-Fi 模块

本 API 是 uni ext api，需下载插件：uni-wifi

stopWifi 兼容性

Web	Android	iOS
-	x	4.11

参数

名称	类型	必填	默认值	兼容性	描述
option	WifiOption	是	-	-
名称 类型 必备 默认值 兼容性 描述 success (res: UniWifiResult) => void 否 - - - fail (res: UniError) => void 否 - - - complete (res: any) => void 否 - - -

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.connectWifi(option)

connectWifi 兼容性

Web	Android 系统版本	Android	iOS
-	>=4.4 && <10.0	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
option	WifiConnectOption	是	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 否 - - - BSSID string 否 - - - password string 否 - - - maunal boolean 否 - - - partialInfo boolean 否 - - - success (res: UniWifiResult) => void 否 - - - fail (res: UniError) => void 否 - - - complete (res: any) => void 否 - - -

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.getWifiList(option)

请求获取 Wi-Fi 列表。wifiList 数据会在 onGetWifiList 注册的回调中返回。

本 API 是 uni ext api，需下载插件：uni-wifi

getWifiList 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
option	WifiOption	是	-	-
名称 类型 必备 默认值 兼容性 描述 success (res: UniWifiResult) => void 否 - - - fail (res: UniError) => void 否 - - - complete (res: any) => void 否 - - -

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.onGetWifiList(UniWifiCallback)

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

本 API 是 uni ext api，需下载插件：uni-wifi

onGetWifiList 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
callback	(wifiInfo: Record<string, any>) => void	是	-	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.offGetWifiList(UniWifiCallback)

移除获取到 Wi-Fi 列表数据事件的监听函数。

本 API 是 uni ext api，需下载插件：uni-wifi

offGetWifiList 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
callback	() => void	是	-	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.getConnectedWifi(option)

获取已连接的 Wi-Fi 信息

本 API 是 uni ext api，需下载插件：uni-wifi

getConnectedWifi 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
option	GetConnectedWifiOptions	是	-	-
名称 类型 必备 默认值 兼容性 描述 partialInfo boolean 否 - - - success (res: UniWifiResult) => void 否 - - - fail (res: UniError) => void 否 - - - complete (res: any) => void 否 - - -

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.onWifiConnected(UniWifiCallback)

监听连接上 Wi-Fi 的事件

本 API 是 uni ext api，需下载插件：uni-wifi

onWifiConnected 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
callback	(wifiInfo: UniWifiResult) => void	是	-	-

UniWifiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	-
errSubject	string	是	-	-	-
errMsg	string	是	-	-	-
wifi	UniWifiInfo	否	-	-
名称 类型 必备 默认值 兼容性 描述 SSID string 是 - - - BSSID string 否 - - - secure boolean 否 - - - signalStrength number 否 - - - frequency number 否 - - -

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.onWifiConnectedWithPartialInfo(UniWifiCallback)

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

本 API 是 uni ext api，需下载插件：uni-wifi

onWifiConnectedWithPartialInfo 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
callback	(wifiInfo: UniWifiInfoWithPartialInfo) => void	是	-	-

UniWifiInfoWithPartialInfo 的属性值

名称	类型	必备	默认值	兼容性	描述
SSID	string	是	-	-	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.offWifiConnected(callback?)

移除连接上 Wi-Fi 的事件的监听函数。

本 API 是 uni ext api，需下载插件：uni-wifi

offWifiConnected 兼容性

Web	Android	iOS
-	3.9.0	4.11

参数

名称	类型	必填	默认值	兼容性	描述
callback	() => void	否	-	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	-	错误信息