Как отслеживать статус подключения и передачу данных

ConnectivityManager предоставляет API, который позволяет запрашивать подключение устройства к сети на основе различных условий, включая возможности устройства и варианты передачи данных.

Реализация обратного вызова предоставляет вашему приложению информацию о статусе подключения устройства, а также о возможностях текущей подключенной сети. API позволяет определить, подключено ли устройство к сети, которая соответствует требованиям приложения.

Как настроить сетевой запрос

Чтобы указать тип передачи данных по сети, например Wi-Fi или мобильное подключение, и возможности текущего подключения, например доступ к интернету, необходимо настроить сетевой запрос.

Объявите элемент NetworkRequest, описывающий требования приложения к сетевому подключению. Следующий код создает запрос для сети, которая подключена к интернету и использует Wi-Fi, Ethernet или передачу данных по мобильной сети в качестве типа транспорта.

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

Учтите, что некоторые подключения могут быть значительно дороже других (например, мобильное подключение обычно дорогое). Используйте NetworkCapabilities#NET_CAPABILITY_NOT_METERED, чтобы определить, является ли подключение дорогим. При использовании тарифицируемого подключения постарайтесь уменьшить объем передаваемых данных или отложить их передачу до тех пор, пока устройство не будет подключено к сети без тарификации.

Как настроить обратный вызов в сети

При регистрации NetworkRequest с помощью ConnectivityManager необходимо реализовать NetworkCallback, чтобы получать уведомления об изменениях статуса подключения и возможностей сети.

Наиболее часто используемые функции NetworkCallback:

• onAvailable() указывает, что устройство подключено к новой сети, которая соответствует требованиям к возможностям и типу передачи, указанным в NetworkRequest.
• onLost() указывает, что устройство потеряло подключение к сети.
• onCapabilitiesChanged() указывает, что возможности сети изменились. Объект NetworkCapabilities предоставляет информацию о текущих возможностях сети.

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

Регистрация для получения новостей о сети

После объявления NetworkRequest и NetworkCallback используйте функции requestNetwork() или registerNetworkCallback(), чтобы найти сеть, к которой можно подключиться с устройства, соответствующего NetworkRequest. Затем статус передается в 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);