基于原生能力的网络状态感知
场景一:APP获取当前连接网络信息
方案
1. 以下属性基于netConn对象的getNetCapabilities函数,获取到的netCapabilities对象获取。
网络类型 | 上行带宽 | 下行带宽 | 网络能力 | |
属性 | bearerTypes | linkUpBandwidthKbps | linkDownBandwidthKbps | networkCap |
类型 | Array<NetBearType> | number | number | Array<NetCap> |
单位 | \ | kb/s | kb/s | \ |
2. 以下属性基于netConn的getConnectionProperties获取到的ConnectionProperties对象中获取。
网卡名称 | 所属域 | 最大传输单元 | 链路信息 | 路由信息 | 网络地址 | |
属性 | interfaceName | domains | mtu | linkAddresses | routes | dnses |
类型 | string | string | number | Array<LinkAddress> | Array<RouteInfo> | Array<NetAddress> |
单位 | \ | \ | bytes | \ | \ | \ |
3. 基于@ohos.net.statistics (流量管理)能力提供的getUidTxBytes接口,获取应用实时网速(bytes)。
核心代码
1. 基于netConn对象的getNetCapabilities函数,获取netCapabilities对象。
let netHandle = await connection.getDefaultNet();
let netCapabilities: connection.NetCapabilities = await connection.getNetCapabilities(netHandle);
2. 基于netCapabilities对象获取上下行带宽(单位kb/s,0为无法评估当前网络带宽)。
// 获取上行带宽
let upKbps = netCapabilities.linkUpBandwidthKbps;
// 获取下行带宽
let downKbps = netCapabilities.linkDownBandwidthKbps ;
3. 基于netCapabilities获取网络类型。
tips:当Wi-Fi和蜂窝同时连接的时候,通过网络能力获取bearType实际只返回Wi-Fi的状态信息,此为现象为系统规格。
let type:connection.NetBearType = netCapabilities.bearerTypes[0];
获取到的返回值和如下枚举对应:
名称 | 值 | 说明 |
BEARER_CELLULAR | 0 | 蜂窝网络 |
BEARER_WIFI | 1 | Wi-Fi网络 |
BEARER_ETHERNET | 3 | 以太网网络 |
BEARER_VPN | 4 | VPN网络 |
4. 基于netCapabilities获取网络具体能力。
let cap:Array<NetCap> = netCapabilities.networkCap;
获取到的返回值和如下枚举对应:
名称 | 值 | 说明 |
NET_CAPABILITY_MMS | 0 | 表示网络可以访问运营商的MMSC(Multimedia Message Service,多媒体短信服务)发送和接收彩信 |
NET_CAPABILITY_NOT_METERED | 11 | 表示网络流量未被计费 |
NET_CAPABILITY_INTERNET | 12 | 表示该网络应具有访问Internet的能力,该能力由网络提供者设置 |
NET_CAPABILITY_NOT_VPN | 15 | 表示网络不使用VPN(Virtual Private Network,虚拟专用网络) |
NET_CAPABILITY_VALIDATED | 16 | 表示该网络访问Internet的能力被网络管理成功验证,该能力由网络管理模块设置 |
NET_CAPABILITY_PORTAL12+ | 17 | 表示系统发现该网络存在强制网络门户,需要用户登陆认证,该能力由网络管理模块设置 |
5. 基于netConn的getConnectionProperties函数获取网络连接信息。
// 获取网卡名称
let interfaceName: string = properties.interfaceName;
// 获取所属域
let domains: string = properties.domains;
// 获取最大传输单元
let mtu: number= properties.mtu;
// 获取链路信息
let linkAddresses: Array<LinkAddress> = properties.linkAddresses;
// 获取路由信息
let routes: Array<RouteInfo> = properties.routes;
// 获取网络地址
let dnses: Array<NetAddress> = properties.dnses;
6. 基于@ohos.net.statistics能力,获取当前应用的网络传输速度。
获取应用的网络传输速度依赖于getUidTxBytes/getUidRxBytes函数,其中函数入参uid为应用唯一标识,和应用一一对应。
Tips: 注意uid在应用卸载重装后会发生变化。
// 导入模块
import { statistics } from '@kit.NetworkKit';
import bundleManager from '@ohos.bundle.bundleManager';
// 获取应用程序uid(设备上该应用的唯一标识,和应用一一对应,卸载重装后会发生变化)
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION;
let bundleInfo = await bundleManager.getBundleInfoForSelf(bundleFlags);
let uid = bundleInfo.appInfo.uid;
// 通过应用uid获取当前应用的上下行带宽
let txBytes = statistics.getUidTxBytes(uid);
let rxBytes = statistics.getUidRxBytes(uid);
场景二:APP感知当前连接网络的状态
方案
基于@ohos.net.connection模块能力,监听网络可用,网络切换,网络不可用,网络丢失等事件,使用前需要调用register开启监听,监听结束后需要调用unregister关闭当前监听请求。
Tips: 各事件监听没有各自独立的off函数,也就是说所有使用该能力监听的事件,只能一起随着unregister的调用关闭监听。
各种场景切换说明:
1. 当Wi-Fi以及蜂窝都断开的情况下,设备从无网络到有网络会触发netAvailable事件,netCapabilitiesChange事件和netConnectionPropertiesChange事件。
2. 当Wi-Fi或蜂窝某一个正常连接的情况下,设备从有网络到无网络状态会触发netLost事件。
3. 当Wi-Fi和蜂窝都正常连接的情况下,设备从Wi-Fi到蜂窝会触发netLost事件(Wi-Fi丢失)之后触发 netAvaliable事件(蜂窝可用)。
核心代码
回调参数解析
1. 下列监听回调中connection.NetHandle类型参数data为数据网络句柄,主要关注其netid属性,此属性可以对网络进行唯一标识。
例如:通过监听on('netAvailable'),保存当前网络的netId,当切换网络时回调该接口,通过比对netId判断是否同一网络。
2. netCapabilitiesChange回调中的参数data为connection.NetCapabilityInfo类型,包含netHandle和netCap两个属性,其中netHandle属性同其它回调一样,此处不再赘述。netCap属性用来存储数据网络的传输能力和承载类型,主要关注其中networkCap(网络能力)和bearType(网络类型)两个属性,用来观察当前网络的能力和类型变化。
// 无效值常量
private static COMMON_INIT_VAL: number = -1
// 保存上次可用的netId
private lastAvailableNetId: number = Index.COMMON_INIT_VAL;
//监听网络是否可用
this.netConn.on('netAvailable', (data: connection.NetHandle) => {
if (this.lastAvailableNetId === Index.COMMON_INIT_VAL) {
this.lastAvailableNetId = data.netId;
} else if (this.lastAvailableNetId === data.netId) { // 当前再次恢复可用的网络和之前的网络为同一网络
// TODO
} else { // 当前再次恢复可用的网络和之前的网络为不同网络
// TODO
}
})
//网络丢失(比如网络断开)
this.netConn.on("netLost",(data: connection.NetHandle) => {
console.log("net lost" + JSON.stringify(data))
})
//网络不可用(比如已连接Wi-Fi,但是Wi-Fi图标上有感叹号)
this.netConn.on("netUnavailable", () => {
console.log("net unavailable id is " + this.lastAvailableNetId);
})
this.netConn.on('netCapabilitiesChange', (data: connection.NetCapabilityInfo) => {
console.log('net capabilities change: ' + JSON.stringify(data));
let currentNetCap = data.netCap.networkCap
// TODO 对比及对比出现异同的处理逻辑由开发者自定义
// 获取当前网络类型,可与之前保存的网络类型做对比(之前在哪里保存,由开发者自定义)
let currentBearType = data.netCap.bearerTypes;
// TODO 对比及对比出现异同的处理逻辑由开发者自定义
// 获取netid,与之前保存的做对比
let currentNetId = data.netHandle.netId;
// TODO 对比及对比出现异同的处理逻辑由开发者自定义
});
listenNetConnEvent(): void {
//开启监听事件
this.netConn.register((error: BusinessError) => {
console.log('netConn register error: ' + JSON.stringify(error));
});
// 使用unregister接口取消订阅
this.netConn.unregister((error: BusinessError) => {
console.log('netConn unregister error: ' + JSON.stringify(error));
});
}
常见问题
1. 如何实现弱网自动切换?
应用中实时感知当前网络速度,在网络可用且网速低于某一阈值(由用户根据自己的实际场景定义)的情况下由应用进行切换。
2. 网络管理部分的系统原生能力是否支持应用主动进行网络切换?
不支持,仅支持通过回调感知系统网络切换。
netConn均代表connection.NetConnection对象,该对象在创建时,根据关注的网络类型不同有所区别。当关注蜂窝网络时,需要传入相关的网络特征,Wi-Fi则不需要。
Wi-Fi:
let netConn = connection.createNetConnection();
蜂窝:
let netConn= netConn.createNetConnection({ netCapabilities: { bearerTypes: [connection.NetBearType.BEARER_CELLULAR] } });