Network

基础信息说明

功能概述：提供网络类型查询与网络状态变化监听，支持注册/取消状态监听与回调结果处理

项目	说明
版本要求	无
前提条件	设备具备系统网络能力与必要权限
使用限制	无
相关教程	无

方法说明

方法名	签名	同步/异步	说明
onNetworkStatusChange	qg.onNetworkStatusChange(callback): void	异步回调	注册网络状态变化回调
offNetworkStatusChange	qg.offNetworkStatusChange(): any	同步	取消网络状态变化回调
getNetworkType	qg.getNetworkType(object): void	异步回调	获取当前网络类型，结果通过 success 回调返回

参数说明

qg.onNetworkStatusChange(callback)

属性名	类型	必填	说明
callback	Function	是	网络状态变化回调，入参为 { isConnected: Boolean, networkType: String }

qg.offNetworkStatusChange()

属性名	类型	必填	说明
-	-	-	无参数；返回值为 native 接口的原始返回值

qg.getNetworkType(object)

属性名	类型	必填	说明
success	Function	否	成功回调，入参 { networkType: String }
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

返回值说明

onNetworkStatusChange 与 getNetworkType：无直接返回，通过回调获取结果

回调结果说明

回调成功
onNetworkStatusChange 回调参数

属性名	类型	说明
isConnected	Boolean	当前是否有网络连接
networkType	String	当前网络类型，示例：wifi、4g、3g、2g、none（以设备实现为准）

getNetworkType 回调参数

属性名	类型	说明
networkType	String	当前网络类型，示例：wifi、4g、3g、2g、none（以设备实现为准）

示例代码

// 监听网络状态变化
qg.onNetworkStatusChange(function (res) {
  // res: { isConnected: Boolean, networkType: String }
  console.log('connected:', res.isConnected, 'type:', res.networkType)
})

// 查询当前网络类型
qg.getNetworkType({
  success(res) {
    console.log('current network type:', res.networkType)
  },
  fail(err) {
    console.log('getNetworkType fail', err)
  }
})

// 取消网络状态监听（返回 native 原始值）
const ret = qg.offNetworkStatusChange()
console.log('offNetworkStatusChange return:', ret)

注意事项

监听网络状态可能需要系统权限，权限不足时会失败。
offNetworkStatusChange 的返回值由 native 层定义，不保证统一含义与类型。
networkType 的取值范围以设备实现为准，建议作为展示与简单判断使用。

上一篇:剪贴板

下一篇:屏幕

文档内容是否有帮助？

有帮助

无帮助