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

ConnectivityManager 提供 API,可讓您根據各種條件 (包括裝置功能和資料傳輸選項),要求裝置連線至網路。

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

設定網路要求

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

宣告 NetworkRequest,說明應用程式的網路連線需求。下列程式碼會建立連上網際網路的網路要求,並使用 Wi-Fi、乙太網路或行動網路連線做為傳輸類型。

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

請注意,某些連線的費用可能明顯高於其他連線 (例如行動連線通常較昂貴)。使用 NetworkCapabilities#NET_CAPABILITY_NOT_METERED 判斷連線是否昂貴。使用計量付費連線時,請嘗試減少應用程式的數據用量,或延遲到裝置使用無計量付費連線時再傳輸。

設定聯播網回呼

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

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

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

    // Network capabilities have changed for the network.
    override fun onCapabilitiesChanged(
        network: Network,
        networkCapabilities: NetworkCapabilities
    ) {
        val unmetered =
            networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
        if (!unmetered) {
            // Reduce data usage, or delay it until the network is unmetered.
        }
    }

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

註冊網路更新

宣告 NetworkRequest 和 NetworkCallback 後,請使用 requestNetwork() 或 registerNetworkCallback() 函式,從符合 NetworkRequest 的裝置搜尋要連線的網路。狀態會回報至 NetworkCallback。

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