鴻蒙系統獲取當前的網絡狀態以及監聽網絡狀態
一、前言
在應用開發過程中,總是需要獲取網絡狀態,當前是否有網絡,當前是使用數據網絡還是使用無線網絡。鴻蒙提供了一系列方法來獲取網絡狀態。
二、添加權限
ohos.permission.GET_NETWORK_INFO 這個權限用于獲取網絡信息。
ohos.permission.INTERNET 這個權限用于訪問網絡1.2。
這兩個權限不需要動態申請,只需要在配置文件中聲明即可。
添加權限的方式查看下圖,如果你沒辦法像下圖一樣的操作,請把編譯器升級到最新版。
三、獲取網絡狀態
3、1 獲取當前的網絡狀態
下面的類可以獲取當前的網絡狀態,并且可以判斷能否上網。有時我們連接了一個網絡,但由于網絡已經到期(該交錢了)或者代理不可用,設備雖然連接了網絡,但是不能上網。
- public class NetworkUtil {
- /**
- * 網絡是否連接
- *
- * @param context 上下文
- * @return true表示網絡已經連接,并且可以上網。false表示網絡沒連接,或者網絡連接了,但是不能上網
- */
- public static boolean isNetworkConnectedInternet(Context context) {
- NetManager netManager = NetManager.getInstance(context);
- NetCapabilities netCapabilities = netManager.getNetCapabilities(netManager.getDefaultNet());
- // NetCapabilities.NET_CAPABILITY_VALIDATED表示連接了網絡,并且可以上網
- return netCapabilities.hasCap(NetCapabilities.NET_CAPABILITY_VALIDATED);
- }
- /**
- * 是否是WiFi連接
- *
- * @param context 上下文
- * @return true表示WiFi連接,并且可以上網。false表示WiFi沒連接,或者WiFi連接了,但是不能上網
- */
- public static boolean isWifiConnectedInternet(Context context) {
- // 獲取網絡管理對象
- NetManager netManager = NetManager.getInstance(context);
- // 獲取NetCapabilities對象
- NetCapabilities netCapabilities = netManager.getNetCapabilities(netManager.getDefaultNet());
- // NetCapabilities.NET_CAPABILITY_VALIDATED表示連接了網絡,并且可以上網
- return netCapabilities.hasCap(NetCapabilities.NET_CAPABILITY_VALIDATED) &&
- netCapabilities.hasBearer(NetCapabilities.BEARER_WIFI) ||
- netCapabilities.hasBearer(NetCapabilities.BEARER_WIFI_AWARE);
- }
- /**
- * 是否是數據網絡連接
- *
- * @param context 上下文
- * @return true表示數據網絡連接,并且可以上網。false表示數據網絡沒連接,或者數據網絡連接了,但是不能上網
- */
- public static boolean isMobileConnectedInternet(Context context) {
- NetManager netManager = NetManager.getInstance(context);
- NetCapabilities netCapabilities = netManager.getNetCapabilities(netManager.getDefaultNet());
- // NetCapabilities.NET_CAPABILITY_VALIDATED表示連接了網絡,并且可以上網
- return netCapabilities.hasCap(NetCapabilities.NET_CAPABILITY_VALIDATED) &&
- netCapabilities.hasBearer(NetCapabilities.BEARER_CELLULAR);
- }
- /**
- * 這種方式也可以判斷網絡是否連接
- *
- * @param context 上下文
- * @return 只要網絡已經連接,就返回true,不管能不能上網。有時我們連接了一個網絡,但由于網絡已經到期(該交錢了)或者使用的代理不可用,設備雖然連接了網絡,但是不能上網
- */
- public static boolean isNetworkConnected(Context context) {
- NetManager netManager = NetManager.getInstance(context);
- NetHandle[] allNets = netManager.getAllNets();
- return allNets != null && allNets.length > 0;
- }
- /**
- * 是否是WiFi連接
- *
- * @param context 上下文
- * @return 只要是WiFi連接,就返回true,不管能不能上網。有時我們連接了一個網絡,但由于網絡已經到期(該交錢了)或者使用的代理不可用,設備雖然連接了網絡,但是不能上網
- */
- public static boolean isWifiConnected(Context context) {
- // 獲取網絡管理對象
- NetManager netManager = NetManager.getInstance(context);
- // 獲取NetCapabilities對象
- NetCapabilities netCapabilities = netManager.getNetCapabilities(netManager.getDefaultNet());
- return netCapabilities.hasBearer(NetCapabilities.BEARER_WIFI) ||
- netCapabilities.hasBearer(NetCapabilities.BEARER_WIFI_AWARE);
- }
- /**
- * 是否是數據網絡連接
- *
- * @param context 上下文
- * @return 只要是數據網絡連接,就返回true,不管能不能上網。有時我們連接了一個網絡,但由于網絡已經到期(該交錢了),設備雖然連接了網絡,但是不能上網
- */
- public static boolean isMobileConnected(Context context) {
- NetManager netManager = NetManager.getInstance(context);
- NetCapabilities netCapabilities = netManager.getNetCapabilities(netManager.getDefaultNet());
- return netCapabilities.hasBearer(NetCapabilities.BEARER_CELLULAR);
- }
- }
3、2 獲取實時的網絡狀態,監聽網絡狀態
上面的方式只能獲取到當前的網絡狀態,并不能獲取到實時的網絡狀態。用戶可以隨時打開或者關閉網絡,當用戶打開或者關閉網絡的時候,我們希望可以實時的獲取到網絡狀態。要想獲取到實時的網絡狀態,就需要對網絡進行監聽。
NetStatusCallback用于監聽網絡的狀態,可以繼承該類來監聽網絡的狀態。它有以下幾個方法:
其中最為常用的方法為onAvailable,onLost,onCapabilitiesChanged方法。
自定義一個類,繼承NetStatusCallback。
- /**
- * @author 裴云飛
- * @date 2021/4/11
- */
- public class DefaultNetStatusCallback extends NetStatusCallback {
- @Override
- public void onAvailable(NetHandle handle) {
- super.onAvailable(handle);
- LogUtils.d("yunfei", "網絡連接成功");
- }
- @Override
- public void onBlockedStatusChanged(NetHandle handle, boolean blocked) {
- super.onBlockedStatusChanged(handle, blocked);
- LogUtils.d("yunfei", "訪問的網絡阻塞狀態發生變化");
- }
- @Override
- public void onLosing(NetHandle handle, long maxMsToLive) {
- super.onLosing(handle, maxMsToLive);
- LogUtils.d("yunfei", "網絡正在丟失連接");
- }
- @Override
- public void onLost(NetHandle handle) {
- super.onLost(handle);
- LogUtils.d("yunfei", "網絡已斷開連接");
- }
- @Override
- public void onUnavailable() {
- super.onUnavailable();
- LogUtils.d("yunfei", "網絡連接超時或網絡不可達");
- }
- @Override
- public void onCapabilitiesChanged(NetHandle handle, NetCapabilities networkCapabilities) {
- super.onCapabilitiesChanged(handle, networkCapabilities);
- LogUtils.d("yunfei", "網絡狀態變化但仍舊是可用狀態");
- }
- @Override
- public void onConnectionPropertiesChanged(NetHandle handle, ConnectionProperties connectionProperties) {
- super.onConnectionPropertiesChanged(handle, connectionProperties);
- LogUtils.d("yunfei", "網絡連接的屬性被修改");
- }
- }
onCapabilitiesChanged(NetHandle handle, NetCapabilities networkCapabilities)是較為常用的網絡狀態發生變化時的監聽,其中的參數networkCapabilities有兩個常用的方法。
hasCap判斷網絡是否連接,有多個參數(具體的參數可查看NetCapabilities),其中常用參數如下:
hasBearer可以判斷網絡的類型,同樣有多個參數(具體的參數可查看NetCapabilities),其中常用參數如下:
onCapabilitiesChanged(NetHandle handle, NetCapabilities networkCapabilities)的具體使用如下:
- @Override
- public void onCapabilitiesChanged(NetHandle handle, NetCapabilities networkCapabilities) {
- super.onCapabilitiesChanged(handle, networkCapabilities);
- LogUtils.d("yunfei", "網絡狀態變化但仍舊是可用狀態");
- if (networkCapabilities.hasCap(NetCapabilities.NET_CAPABILITY_VALIDATED)) {
- // 網絡連接成功,并且可以上網
- if (networkCapabilities.hasBearer(NetCapabilities.BEARER_WIFI)||
- networkCapabilities.hasBearer(NetCapabilities.BEARER_WIFI_AWARE)) {
- LogUtils.d("yunfei", "使用WiFi");
- } else if (networkCapabilities.hasBearer(NetCapabilities.BEARER_CELLULAR) ||
- networkCapabilities.hasBearer(NetCapabilities.BEARER_ETHERNET)) {
- LogUtils.d("yunfei", "使用數據網絡");
- } else {
- // 其它網絡,包括藍牙、VPN、LoWPAN等
- LogUtils.d("yunfei", "其它網絡");
- }
- }
- }
定義好監聽網絡的類后,就可以使用了。要想獲取當前的網絡狀態,直接調用NetworkUtil類中的方法即可。要想獲取實時的網絡狀態,就需要添加監聽,首先獲取網絡管理對象,然后添加監聽,這樣就能實時的監聽到網絡的狀態了。最后別忘了在onStop方法里面移除監聽。
- public class MainAbilitySlice extends AbilitySlice {
- private NetManager netManager;
- private DefaultNetStatusCallback mDefaultNetStatusCallback = new DefaultNetStatusCallback();
- @Override
- public void onStart(Intent intent) {
- super.onStart(intent);
- super.setUIContent(ResourceTable.Layout_ability_main);
- /*
- * 網絡是否連接,true表示網絡已經連接,但未必可以上網,
- * 有時我們連接了一個網絡,但由于網絡已經到期(該交錢了)或者使用的代理不可用,
- * 設備雖然連接了網絡,但是不能上網
- */
- boolean networkConnect = NetworkUtil.isNetworkConnected(this);
- // 是否是WiFi連接,只要是WiFi連接,就返回true,不管能不能上網。
- boolean wifiConnected = NetworkUtil.isWifiConnected(this);
- // 否是數據網絡連接,只要是數據網絡連接,就返回true,不管能不能上網
- boolean mobileConnected = NetworkUtil.isMobileConnected(this);
- // 網絡是否連接,true表示網絡已經連接,并且可以上網
- boolean networkConnectedInternet = NetworkUtil.isNetworkConnectedInternet(this);
- // 是否是WiFi連接,true表示WiFi連接,并且可以上網
- boolean wifiConnectedInternet = NetworkUtil.isWifiConnectedInternet(this);
- // 是否是數據網絡連接,true表示數據網絡連接,并且可以上網
- boolean mobileConnectedInternet = NetworkUtil.isMobileConnectedInternet(this);
- /*
- * 下面的代碼用于獲取實時的網絡狀態。用戶可以隨時打開或者關閉網絡,當用戶打開或者關閉網絡時,
- * 我們可以獲取實時的網絡狀態
- */
- // 獲取網絡管理對象
- netManager = NetManager.getInstance(this);
- // 添加監聽,監聽實時的網絡狀態
- netManager.addDefaultNetStatusCallback(mDefaultNetStatusCallback);
- }
- @Override
- public void onActive() {
- super.onActive();
- }
- @Override
- public void onForeground(Intent intent) {
- super.onForeground(intent);
- }
- @Override
- protected void onStop() {
- super.onStop();
- if (netManager != null) {
- // 移除監聽
- netManager.removeNetStatusCallback(mDefaultNetStatusCallback);
- }
- }
- }
四、總結
本文主要是對獲取當前網絡狀態以及監聽網絡狀態進行講解,需要注意當前的網絡狀態和實時的網絡狀態的區別。
最后奉上源碼,代碼運行起來后,大家可以隨時打開或者關閉網絡,以獲取實時的網絡狀態。