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

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

A implementação de callback fornece informações ao app sobre a propriedade o status da conexão e os recursos da conexão em uma rede VPC. A API permite determinar se o dispositivo está conectada a uma rede que satisfaça os requisitos do seu app.

Configurar uma solicitação de rede

Para especificar o tipo de transporte da rede, como Wi-Fi ou celular conexão e os recursos da rede conectada no momento, como você precisa configurar uma solicitação de rede.

Declare uma NetworkRequest que descreve as necessidades de conexão de rede do seu app. O código a seguir cria uma solicitação de uma rede conectada à Internet e que use uma conexão Wi-Fi ou uma conexão 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();

Observe que algumas conexões podem ser significativamente mais caras do que outras (por exemplo, uma conexão móvel costuma ser cara). Usar NetworkCapabilities#NET_CAPABILITY_NOT_METERED para determinar se a conexão é cara. Em uma conexão limitada, tente reduzir o consumo de dados do app ou atrasá-lo até que o dispositivo conexão ilimitada.

Configurar um callback de rede

Ao registrar o NetworkRequest com o ConnectivityManager, é necessário implementar um NetworkCallback para receber notificações sobre mudanças no status da conexão e recursos.

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

• onAvailable() indica que o dispositivo está conectado a uma nova rede que satisfaça as requisitos de capacidade 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. A 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);
    }
};

Registrar-se para atualizações de rede

Depois de declarar NetworkRequest e NetworkCallback, use as requestNetwork() ou registerNetworkCallback() para procurar uma rede para conexão a partir do dispositivo que satisfaça as 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);