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

ConnectivityManager 提供 用于根据情况请求设备连接到网络的 API 包括设备功能和数据传输选项等各种条件。

回调实现会向您的应用提供有关设备 以及当前已连接设备的功能 。借助该 API，您可以确定设备 符合应用要求的网络。

配置网络请求

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

声明一个 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);