
基于原生能力的网络状态感知
场景一: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对象。
2. 基于netCapabilities对象获取上下行带宽(单位kb/s,0为无法评估当前网络带宽)。
3. 基于netCapabilities获取网络类型。
tips:当Wi-Fi和蜂窝同时连接的时候,通过网络能力获取bearType实际只返回Wi-Fi的状态信息,此为现象为系统规格。
获取到的返回值和如下枚举对应:
名称 | 值 | 说明 |
BEARER_CELLULAR | 0 | 蜂窝网络 |
BEARER_WIFI | 1 | Wi-Fi网络 |
BEARER_ETHERNET | 3 | 以太网网络 |
BEARER_VPN | 4 | VPN网络 |
4. 基于netCapabilities获取网络具体能力。
获取到的返回值和如下枚举对应:
名称 | 值 | 说明 |
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函数获取网络连接信息。
6. 基于@ohos.net.statistics能力,获取当前应用的网络传输速度。
获取应用的网络传输速度依赖于getUidTxBytes/getUidRxBytes函数,其中函数入参uid为应用唯一标识,和应用一一对应。
Tips: 注意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(网络类型)两个属性,用来观察当前网络的能力和类型变化。
常见问题
1. 如何实现弱网自动切换?
应用中实时感知当前网络速度,在网络可用且网速低于某一阈值(由用户根据自己的实际场景定义)的情况下由应用进行切换。
2. 网络管理部分的系统原生能力是否支持应用主动进行网络切换?
不支持,仅支持通过回调感知系统网络切换。
netConn均代表connection.NetConnection对象,该对象在创建时,根据关注的网络类型不同有所区别。当关注蜂窝网络时,需要传入相关的网络特征,Wi-Fi则不需要。
Wi-Fi:
let netConn = connection.createNetConnection();
蜂窝:
let netConn= netConn.createNetConnection({ netCapabilities: { bearerTypes: [connection.NetBearType.BEARER_CELLULAR] } });
