Cómo supervisar el estado de conectividad y la medición de la conexión

ConnectivityManager proporciona una API que te permite solicitar que el dispositivo se conecte a una red en función de varias condiciones, como las capacidades del dispositivo y las opciones de transporte de datos.

La implementación de la devolución de llamada proporciona información a tu app sobre el estado de conexión del dispositivo, así como las capacidades de la red a la que está conectada actualmente. La API te permite determinar si el dispositivo está conectado a una red que satisface los requisitos de tu app.

Cómo configurar una solicitud de red

Para especificar el tipo de transporte de la red, como la conexión Wi-Fi o móvil, y las capacidades de la red conectada actualmente, como la conexión a Internet, debes configurar una solicitud de red.

Declara un NetworkRequest que describa las necesidades de conexión de red de tu app. El siguiente código crea una solicitud para una red que está conectada a Internet y usa una conexión Wi-Fi o celular para el tipo de transporte.

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

Ten en cuenta que algunas conexiones pueden ser mucho más costosas que otras (por ejemplo, una conexión móvil suele ser costosa). Usa NetworkCapabilities#NET_CAPABILITY_NOT_METERED para determinar si la conexión es costosa. En una conexión de uso medido, intenta reducir el consumo de datos de tu app o retrasarlo hasta que el dispositivo tenga una conexión de uso no medido.

Cómo configurar una devolución de llamada de red

Cuando registras el NetworkRequest con el ConnectivityManager, debes implementar un NetworkCallback para recibir notificaciones sobre los cambios en el estado de la conexión y las capacidades de la red.

Entre las funciones más implementadas en NetworkCallback, se incluyen las siguientes:

• onAvailable() indica que el dispositivo está conectado a una red nueva que satisface las capacidades y los requisitos de tipo de transporte especificados en NetworkRequest.
• onLost() indica que el dispositivo perdió la conexión a la red.
• onCapabilitiesChanged() indica que cambiaron las capacidades de la red. El objeto NetworkCapabilities proporciona información sobre las capacidades actuales de la red.

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

Regístrate para recibir actualizaciones de red

Después de declarar NetworkRequest y NetworkCallback, usa las funciones requestNetwork() o registerNetworkCallback() para buscar una red a la que conectarse desde el dispositivo que satisfaga NetworkRequest. Luego, el estado se informa a NetworkCallback.

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

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