监控连接状态和连接计量

该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);