鸿蒙开发5.0【原生能力的网络状态感知】

爱桥代码的程序媛

于 2024-09-05 18:31:48 发布

阅读量1.1k

点赞数 8

分类专栏：鸿蒙开发学习笔录文章标签： harmonyos 网络 php 鸿蒙开发鸿蒙 openharmony 服务器

本文链接：https://blog.csdn.net/2301_76813281/article/details/141937005

版权

鸿蒙开发学习笔录专栏收录该内容

182 篇文章 7 订阅

订阅专栏

场景一：APP获取当前连接网络信息

方案

以下属性基于netConn对象的getNetCapabilities函数，获取到的netCapabilities对象获取。

网络类型上行带宽下行带宽网络能力
属性 bearerTypes linkUpBandwidthKbps linkDownBandwidthKbps networkCap
类型 Array number number Array
单位 \ kb/s kb/s \
以下属性基于netConn的getConnectionProperties获取到的ConnectionProperties对象中获取。

网卡名称所属域最大传输单元链路信息路由信息网络地址
属性 interfaceName domains mtu linkAddresses routes dnses
类型 string string number Array Array Array
单位 \ \ bytes \ \ \
基于@ohos.net.statistics (流量管理)能力提供的getUidTxBytes接口，获取应用实时网速（bytes）。

	网络类型	上行带宽	下行带宽	网络能力
属性	bearerTypes	linkUpBandwidthKbps	linkDownBandwidthKbps	networkCap
类型	Array	number	number	Array
单位	\	kb/s	kb/s	\

	网卡名称	所属域	最大传输单元	链路信息	路由信息	网络地址
属性	interfaceName	domains	mtu	linkAddresses	routes	dnses
类型	string	string	number	Array	Array	Array
单位	\	\	bytes	\	\	\

核心代码

基于netConn对象的getNetCapabilities函数，获取netCapabilities对象。

let netHandle = await connection.getDefaultNet();
let netCapabilities: connection.NetCapabilities = await connection.getNetCapabilities(netHandle);

基于netCapabilities对象获取上下行带宽（单位kb/s，0为无法评估当前网络带宽）。

// 获取上行带宽
let upKbps = netCapabilities.linkUpBandwidthKbps;
// 获取下行带宽
let downKbps = netCapabilities.linkDownBandwidthKbps ;

基于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网络

名称	值	说明
BEARER_CELLULAR	0	蜂窝网络
BEARER_WIFI	1	Wi-Fi网络
BEARER_ETHERNET	3	以太网网络
BEARER_VPN	4	VPN网络

基于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	表示系统发现该网络存在强制网络门户,需要用户登陆认证,该能力由网络管理模块设置

基于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;

基于@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的调用关闭监听。

各种场景切换说明：

当Wi-Fi以及蜂窝都断开的情况下，设备从无网络到有网络会触发netAvailable事件，netCapabilitiesChange事件和netConnectionPropertiesChange事件。
当Wi-Fi或蜂窝某一个正常连接的情况下，设备从有网络到无网络状态会触发netLost事件。
当Wi-Fi和蜂窝都正常连接的情况下，设备从Wi-Fi到蜂窝会触发netLost事件（Wi-Fi丢失）之后触发 netAvaliable事件（蜂窝可用）。

核心代码

回调参数解析

下列监听回调中connection.NetHandle类型参数data为数据网络句柄，主要关注其netid属性，此属性可以对网络进行唯一标识。

例如：通过监听on(‘netAvailable’)，保存当前网络的netId，当切换网络时回调该接口，通过比对netId判断是否同一网络。

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));
});
}

常见问题

如何实现弱网自动切换？

应用中实时感知当前网络速度，在网络可用且网速低于某一阈值（由用户根据自己的实际场景定义）的情况下由应用进行切换。
网络管理部分的系统原生能力是否支持应用主动进行网络切换？

不支持，仅支持通过回调感知系统网络切换。

netConn均代表connection.NetConnection对象，该对象在创建时，根据关注的网络类型不同有所区别。当关注蜂窝网络时，需要传入相关的网络特征，Wi-Fi则不需要。 Wi-Fi：
let netConn = connection.createNetConnection();
蜂窝：
let netConn= netConn.createNetConnection({
 netCapabilities: {
   bearerTypes: [connection.NetBearType.BEARER_CELLULAR]
 }
});

以上就是本篇文章所带来的鸿蒙开发中一小部分技术讲解；想要学习完整的鸿蒙全栈技术。可以在结尾找我可全部拿到！
下面是鸿蒙的完整学习路线，展示如下：