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

ConnectivityManager 提供 您可以運用這個 API，根據以下條件要求裝置連上網路 包括裝置功能和資料傳輸選項等多種條件。

回呼實作為應用程式可提供裝置 連線狀態，以及目前連線的 更是如此這個 API 可讓您判斷裝置目前是否 會連上符合應用程式需求的網路。

設定網路要求

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

宣告會讓顯示的 NetworkRequest 並描述應用程式的網路連線需求下列程式碼會建立 要求連上網際網路且使用 Wi-Fi 的網路 或行動網路連線

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

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 物件 提供有關網路目前功能的資訊。

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

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。

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

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