Отслеживание состояния подключения и измерения количества подключений

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

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

Настроить сетевой запрос

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

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

Котлин

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

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

Настройте сетевой обратный вызов

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

Наиболее часто реализуемые функции в NetworkCallback включают в себя следующее:

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

Котлин

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

Зарегистрируйтесь для получения сетевых обновлений

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

Котлин

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

Ява

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