Monitorare lo stato della connettività e la misurazione delle connessioni

ConnectivityManager fornisce un'API che consente di richiedere che il dispositivo si connetta a una rete in base a varie condizioni, tra cui le funzionalità del dispositivo e le opzioni di trasporto dei dati.

L'implementazione del callback fornisce all'app informazioni sullo stato della connessione del dispositivo, nonché sulle funzionalità della rete attualmente connessa. L'API ti consente di determinare se il dispositivo è attualmente connesso a una rete che soddisfa i requisiti della tua app.

Configura una richiesta di rete

Per specificare il tipo di trasporto della rete, ad esempio la connessione Wi-Fi o cellulare, e le funzionalità della rete attualmente connessa, ad esempio la connessione a internet, devi configurare una richiesta di rete.

Dichiara un NetworkRequest che descrive le esigenze di connessione di rete della tua app. Il codice seguente crea una richiesta per una rete connessa a internet e utilizza una connessione Wi-Fi o cellulare per il tipo di trasporto.

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

Tieni presente che alcune connessioni possono essere molto più costose di altre (ad esempio, una connessione mobile è in genere costosa). Utilizza NetworkCapabilities#NET_CAPABILITY_NOT_METERED per determinare se la connessione è costosa. Quando utilizzi una connessione con misuratore, prova a ridurre il consumo di dati dell'app o a ritardarlo finché il dispositivo non ha una connessione senza misuratore.

Configura un callback di rete

Quando registri il NetworkRequest con il ConnectivityManager, devi implementare un NetworkCallback per ricevere notifiche relative alle modifiche dello stato della connessione e delle funzionalità di rete.

Le funzioni più comunemente implementate nel NetworkCallback includono:

• onAvailable() indica che il dispositivo è connesso a una nuova rete che soddisfa le funzionalità e i requisiti del tipo di trasporto specificati nel NetworkRequest.
• onLost() indica che il dispositivo ha perso la connessione alla rete.
• onCapabilitiesChanged() indica che le funzionalità della rete sono cambiate. L'oggetto NetworkCapabilities fornisce informazioni sulle funzionalità correnti della rete.

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

Registrati per ricevere aggiornamenti sulla rete

Dopo aver dichiarato NetworkRequest e NetworkCallback, utilizza le funzioni requestNetwork() o registerNetworkCallback() per cercare una rete da connettere dal dispositivo che soddisfa i NetworkRequest. Lo stato viene quindi segnalato al NetworkCallback.

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

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