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

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

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

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

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

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

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

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

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

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

Чаще всего в NetworkCallback используются следующие функции:

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

private val networkCallback = object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        // Network is available for use.
    }

    // Network capabilities have changed for the network.
    override fun onCapabilitiesChanged(
        network: Network,
        networkCapabilities: NetworkCapabilities
    ) {
        val unmetered =
            networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
        if (!unmetered) {
            // Reduce data usage, or delay it until the network is unmetered.
        }
    }

    override fun onLost(network: Network) {
        // Lost network connection.
    }
}
ConnectivityStatusType.kt

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

После объявления NetworkRequest и NetworkCallback используйте функции requestNetwork() или registerNetworkCallback(), чтобы найти сеть, которая соответствует NetworkRequest и к которой можно подключиться с устройства. Затем статус передается в NetworkCallback.

val connectivityManager = getSystemService(ConnectivityManager::class.java)
connectivityManager.registerNetworkCallback(networkRequest, networkCallback)
ConnectivityStatusType.kt