This page is translated by Google Cloud Translation API

Switch to Chinese

uni.getNetworkType(OBJECT)

获取网络类型。

getNetworkType 兼容性

HarmonyOS
HBuilderX 4.24

OBJECT 参数说明

参数名	类型	必填	说明
success	Function	是	接口调用成功，返回网络类型 networkType
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数	说明
networkType	网络类型

networkType 有效值

值	说明	平台差异说明
wifi	wifi 网络
2g	2g 网络
3g	3g 网络
4g	4g 网络
5g	5g 网络
ethernet	有线网络	App
unknown	Android 下不常见的网络类型
none	无网络

注意

• HarmonyOS Next 平台使用时需要添加权限 ohos.permission.GET_NETWORK_INFO

示例

uni.getNetworkType({
	success: function (res) {
		console.log(res.networkType);
	}
});

• 注意：本API在小程序平台是同步接口，在其它平台是异步接口

uni.onNetworkStatusChange(CALLBACK)

监听网络状态变化。可使用uni.offNetworkStatusChange取消监听。

元服务
1.0.4+

onNetworkStatusChange 兼容性

HarmonyOS
HBuilderX 4.24

CALLBACK 返回参数

参数	类型	说明	平台差异说明
isConnected	Boolean	当前是否有网络连接	抖音小程序不支持
networkType	String	网络类型

注意

• HarmonyOS Next 平台使用时需要添加权限 ohos.permission.GET_NETWORK_INFO

示例

uni.onNetworkStatusChange(function (res) {
	console.log(res.isConnected);
	console.log(res.networkType);
});

uni.offNetworkStatusChange(CALLBACK)

取消监听网络状态变化。

元服务
1.0.4+

offNetworkStatusChange 兼容性

HarmonyOS
HBuilderX 4.24

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	QQ小程序	快手小程序	京东小程序	小红书小程序
HBuilderX 3.0.1+	HBuilderX 3.0.1+	基础库 2.9.3+	x	x	x	x	√	x	x

注意

• CALLBACK必须为调用uni.onNetworkStatusChange时传入的CALLBACK
• HarmonyOS Next 平台使用时需要添加权限 ohos.permission.GET_NETWORK_INFO
• 支付宝小程序等平台支持此 API, 但是需要注意监听和取消监听的时候，都使用 my. 方法操作

例如：

var CALLBACK = function(res) {
    // ...这里写你的业务逻辑
}
uni.offNetworkStatusChange(CALLBACK)
uni.onNetworkStatusChange(CALLBACK);