監控連線狀態和連線計量功能

您可以利用 ConnectivityManager 提供的 API，根據包括裝置功能和資料傳輸選項的各種條件，要求裝置連線至網路。

回呼實作可為應用程式提供裝置連線狀態，以及目前連線網路的功能資訊。這個 API 可讓您判斷裝置目前是否已連線至符合應用程式需求的網路。

設定網路要求

如要指定網路的傳輸類型 (例如 Wi-Fi 或行動網路連線)，以及目前連線的網路功能 (例如網際網路連線)，您必須設定網路要求。

宣告 NetworkRequest 以說明應用程式的網路連線需求。下列程式碼會針對連線到網際網路的網路建立要求，並使用 Wi-Fi 或行動網路連線做為傳輸類型。

Kotlin

val networkRequest = NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build()

Java

NetworkRequest networkRequest = new NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build();

請注意，有些連線的費用可能遠高於其他連線費用 (例如使用行動網路連線通常十分昂貴)。使用 NetworkCapabilities#NET_CAPABILITY_NOT_METERED 來判斷連線是否昂貴。使用計量付費連線時，請減少應用程式的數據傳輸量，或延遲裝置使用非計量付費連線為止。

設定網路回呼

使用 ConnectivityManager 註冊 NetworkRequest 時，您必須實作 NetworkCallback，才能接收連線狀態和網路功能變更的通知。

NetworkCallback 中最常實作的函式包括：

• onAvailable() 表示裝置已連線至新網路，且符合 NetworkRequest 中指定的功能與傳輸類型要求。
• onLost() 表示裝置與網路已中斷連線。
• onCapabilitiesChanged() 表示網路功能已變更。NetworkCapabilities 物件可提供網路目前功能的相關資訊。

Kotlin

private val networkCallback = object : ConnectivityManager.NetworkCallback() {
    // network is available for use
    override fun onAvailable(network: Network) {
        super.onAvailable(network)
    }

    // Network capabilities have changed for the network
    override fun onCapabilitiesChanged(
            network: Network,
            networkCapabilities: NetworkCapabilities
    ) {
        super.onCapabilitiesChanged(network, networkCapabilities)
        val unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
    }

    // lost network connection
    override fun onLost(network: Network) {
        super.onLost(network)
    }
}

Java

private ConnectivityManager.NetworkCallback networkCallback = new ConnectivityManager.NetworkCallback() {
    @Override
    public void onAvailable(@NonNull Network network) {
        super.onAvailable(network);
    }

    @Override
    public void onLost(@NonNull Network network) {
        super.onLost(network);
    }

    @Override
    public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities networkCapabilities) {
        super.onCapabilitiesChanged(network, networkCapabilities);
        final boolean unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED);
    }
};

註冊網路更新

宣告 NetworkRequest 和 NetworkCallback 後，使用 requestNetwork() 或 registerNetworkCallback() 函式搜尋要從符合 NetworkRequest 的裝置連線的網路。接著，系統會將狀態回報給 NetworkCallback。

Kotlin

val connectivityManager = getSystemService(ConnectivityManager::class.java) as ConnectivityManager
connectivityManager.requestNetwork(networkRequest, networkCallback)

Java

ConnectivityManager connectivityManager =
        (ConnectivityManager) getSystemService(ConnectivityManager.class);
connectivityManager.requestNetwork(networkRequest, networkCallback);