基于原生能力的网络状态感知

elucky
发布于 2024-8-1 16:46
浏览
0收藏

场景一: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]   } });

分类
已于2024-8-1 16:46:52修改
收藏
回复
举报
回复
    相关推荐