监控网络连接状态和网络连接计量

ConnectivityManager 提供了一个 API，可让您根据各种条件（包括设备功能和数据传输选项）请求设备连接到网络。

回调实现会向您的应用提供有关设备连接状态以及当前所连接网络的功能的信息。该 API 可让您确定设备当前是否已连接到满足应用要求的网络。

配置网络请求

如需指定网络的传输类型（例如 Wi-Fi 或移动网络连接）以及当前连接的网络的功能（例如互联网连接），您必须配置网络请求。

声明一个 NetworkRequest，用于描述应用的网络连接需求。以下代码会创建一个请求，用于请求连接到互联网且使用 WLAN、以太网或移动网络连接作为传输类型的网络。

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

请注意，某些连接可能比其他连接贵得多（例如，移动连接通常很贵）。使用 NetworkCapabilities#NET_CAPABILITY_NOT_METERED 确定连接是否会产生高额费用。使用按流量计费的网络时，请尝试减少应用的数据消耗，或延迟到设备连接到不按流量计费的网络时再消耗。

配置网络回调

向 ConnectivityManager 注册 NetworkRequest 时，您必须实现 NetworkCallback，以便接收有关连接状态和网络功能变化的通知。

NetworkCallback 中最常实现的函数包括：

• onAvailable() 表示设备已连接到满足 NetworkRequest 中指定的功能和传输类型要求的新网络。
• onLost() 表示设备已断开与网络的连接。
• onCapabilitiesChanged() 表示网络的功能已发生变化。NetworkCapabilities 对象提供有关网络当前功能的信息。

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.
    }
}
ConnectivityStatusType.kt

注册以接收网络更新

声明 NetworkRequest 和 NetworkCallback 后，使用 requestNetwork() 或 registerNetworkCallback() 函数从满足 NetworkRequest 的设备中搜索要连接的网络。然后，系统会将此状态报告给 NetworkCallback。

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