Monitorowanie stanu połączeń i pomiaru wykorzystania połączenia

ConnectivityManager udostępnia interfejs API, który umożliwia wysyłanie żądań połączenia urządzenia z siecią na podstawie różnych warunków, takich jak możliwości urządzenia i opcje transportu danych.

Implementacja wywołania zwrotnego dostarcza aplikacji informacje o stanie połączenia urządzenia oraz o możliwościach aktualnie połączonej sieci. Interfejs API umożliwia określenie, czy urządzenie jest obecnie połączone z siecią, która spełnia wymagania aplikacji.

Konfigurowanie żądania sieciowego

Aby określić typ transportu sieci, np. Wi-Fi lub połączenie komórkowe, oraz możliwości aktualnie połączonej sieci, np. połączenie z internetem, musisz skonfigurować żądanie sieciowe.

Zadeklaruj element NetworkRequest, który opisuje wymagania aplikacji dotyczące połączenia sieciowego. Poniższy kod tworzy żądanie dotyczące sieci, która jest połączona z internetem i używa Wi-Fi, Ethernetu lub połączenia komórkowego jako typu transportu.

Kotlin

val networkRequest = NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_ETHERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build()

Java

NetworkRequest networkRequest = new NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_ETHERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build();

Pamiętaj, że niektóre połączenia mogą być znacznie droższe od innych (na przykład połączenie komórkowe jest zwykle drogie). Użyj NetworkCapabilities#NET_CAPABILITY_NOT_METERED, aby określić, czy połączenie jest kosztowne. Jeśli korzystasz z połączenia z pomiarem użycia danych, spróbuj zmniejszyć zużycie danych przez aplikację lub opóźnić je do czasu, aż urządzenie będzie miało połączenie bez pomiaru użycia danych.

Konfigurowanie wywołania zwrotnego sieci

Gdy rejestrujesz NetworkRequest w ConnectivityManager, musisz zaimplementować NetworkCallback, aby otrzymywać powiadomienia o zmianach stanu połączenia i możliwościach sieci.

Najczęściej implementowane funkcje w NetworkCallback to:

• onAvailable() wskazuje, że urządzenie jest połączone z nową siecią, która spełnia wymagania dotyczące możliwości i typu transportu określone w NetworkRequest.
• onLost() oznacza, że urządzenie utraciło połączenie z siecią.
• onCapabilitiesChanged() wskazuje, że możliwości sieci uległy zmianie. Obiekt NetworkCapabilities dostarcza informacji o bieżących możliwościach sieci.

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

Rejestrowanie się w celu otrzymywania aktualizacji sieci

Po zadeklarowaniu NetworkRequest i NetworkCallback użyj funkcji requestNetwork() lub registerNetworkCallback(), aby wyszukać sieć, z którą można połączyć urządzenie, spełniającą kryteria NetworkRequest. Stan jest następnie zgłaszany do 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);