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 según diversas condiciones, que incluyen 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 y las capacidades de la red conectada en ese momento. La API te permite determinar si el dispositivo está conectado actualmente a una red que cumple con los requisitos de tu app.

Configura una solicitud de red

Para especificar el tipo de transporte de la red, como Wi-Fi o conexión 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. En el siguiente código, se crea una solicitud para una red que está conectada a Internet y usa una conexión Wi-Fi, Ethernet o móvil para el tipo de transporte.

private val networkRequest = NetworkRequest.Builder()
    .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
    .addTransportType(NetworkCapabilities.TRANSPORT_ETHERNET)
    .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. Cuando uses 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.

Configura 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.

Las funciones que se implementan con mayor frecuencia en NetworkCallback incluyen las siguientes:

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

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

Cómo registrarse 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 el NetworkRequest. Luego, el estado se informa al NetworkCallback.

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