鴻蒙系統獲取當前的網絡狀態以及監聽網絡狀態

作者：裴云飛1 2021-04-15 09:18:57

系統

文章由鴻蒙社區產出，想要了解更多內容請前往：51CTO和華為官方戰略合作共建的鴻蒙技術社區https://harmonyos.51cto.com

[[393146]]

想了解更多內容，請訪問：

51CTO和華為官方合作共建的鴻蒙技術社區

https://harmonyos.51cto.com

一、前言

在應用開發過程中，總是需要獲取網絡狀態，當前是否有網絡，當前是使用數據網絡還是使用無線網絡。鴻蒙提供了一系列方法來獲取網絡狀態。

二、添加權限

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