Monitorar o status da conectividade e a limitação de conexão

O ConnectivityManager fornece uma API que permite solicitar que o dispositivo se conecte a uma rede com base em várias condições, incluindo recursos do dispositivo e opções de transporte de dados.

A implementação do callback fornece informações ao app sobre o status da conexão do dispositivo, bem como os recursos da rede conectada no momento. A API permite determinar se o dispositivo está conectado a uma rede que atende aos requisitos do app.

Configurar uma solicitação de rede

Para especificar o tipo de transporte da rede, como Wi-Fi ou celular, e os recursos da rede conectada no momento, como conexão de Internet, é necessário configurar uma solicitação de rede.

Declare um NetworkRequest que descreva as necessidades de conexão de rede do app. O código a seguir cria uma solicitação para uma rede conectada à Internet e usa uma conexão Wi-Fi ou celular para o tipo de transporte.

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

Algumas conexões podem ser significativamente mais caras do que outras. Por exemplo, uma conexão móvel costuma ser cara. Use NetworkCapabilities#NET_CAPABILITY_NOT_METERED para determinar se a conexão é cara. Quando estiver em uma conexão limitada, tente reduzir o consumo de dados do app ou atrase-o até que o dispositivo tenha uma conexão ilimitada.

Configurar um callback de rede

Ao registrar o NetworkRequest com o ConnectivityManager, você precisa implementar um NetworkCallback para receber notificações sobre mudanças no status da conexão e nos recursos da rede.

As funções mais comumente implementadas no NetworkCallback incluem:

  • onAvailable() indica que o dispositivo está conectado a uma nova rede que atende aos requisitos de recursos e tipo de transporte especificados no NetworkRequest.
  • onLost() indica que o dispositivo perdeu a conexão com a rede.
  • onCapabilitiesChanged() indica que os recursos da rede mudaram. O objeto NetworkCapabilities fornece informações sobre os recursos atuais da rede.

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

Receber atualizações de rede

Depois de declarar o NetworkRequest e o NetworkCallback, use as funções requestNetwork() ou registerNetworkCallback() para pesquisar uma rede a ser conectada ao dispositivo que atenda ao NetworkRequest. O status é então informado ao 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);