API диагностики подключения

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

API диагностики подключений позволяет приложениям, которые владеют или управляют сетями, например, приложениям операторов, приложениям VPN и приложениям предложений Wi-Fi, получать диагностическую информацию о подключении к сети из фреймворка. Эти приложения могут регистрировать обратные вызовы и получать уведомления с информацией о подключении для сетей, которыми они владеют или управляют. Приложения не будут получать уведомления для сетей, которые не принадлежат или не управляются приложением.

Ниже приведены примеры приложений, которые управляют сетями или владеют ими:

• Приложения оператора: управляйте сотовыми сетями, для которых их subId имеет привилегии оператора
• Приложения для предложения сетей Wi-Fi: собственные сети Wi-Fi, которые они предлагают системе
• Приложения VPN: управляйте всеми сетями, которые использует их VPN, но только когда они являются активными VPN

Обратные вызовы вызываются в следующих случаях:

• Проверка сети: система завершила оценку определенной сети. Класс ConnectivityReport предоставляет информацию о текущем состоянии сети и результатах любых тестов или процедур, выполненных в рамках проверки.

  public class ConnectivityReport {
      Network network;
      long reportTimestamp;
      LinkProperties linkProperties;
      NetworkCapabilities networkCapabilities;
      PersistableBundle additionalInfo;
  }
  

• Подозрение на задержку данных: Подозрение на задержку данных, состояние, при котором IP-пакеты не проходят через сеть должным образом. Класс DataStallReport предоставляет информацию о предполагаемых задержках данных.

  public class DataStallReport {
      Network network;
      long reportTimestamp;
      int detectionMethod;
      LinkProperties linkProperties;
      NetworkCapabilities networkCapabilities;
      PersistableBundle stallDetails;
  }
  

• Сообщено о подключении: приложение сообщило о подключении через ConnectivityManager#reportNetworkConnectivity к системе. Сеть и сообщенное подключение (считает ли приложение, что сеть обеспечивает подключение или нет) являются общими.

Выполнение

Для использования API диагностики подключений приложение должно получить экземпляр ConnectivityDiagnosticsManager с платформы. Этот экземпляр следует использовать для регистрации и отмены регистрации реализаций ConnectivityDiagnosticsCallback . Методы обратного вызова, которые не переопределяются, являются пустыми операциями.

Ниже приведен пример реализации ConnectivityDiagnosticsCallback :

public class ExampleCallback extends ConnectivityDiagnosticsCallback {
    @Override
    public void onConnectivityReportAvailable(@NonNull ConnectivityReport report) {
        ... 
        // Log data, take action based on report result, etc
        ... 
    }

    @Override
    public void onDataStallSuspected(@NonNull DataStallReport report) {
        ... 
        // Log data, take action based on report result, etc
        ... 
    }

    @Override
    public void onNetworkConnectivityReported(
               @NonNull Network network, boolean hasConnectivity) {
        ... 
        // Log data, take action based on report result, etc
        ... 
    }
}

Чтобы зарегистрировать обратные вызовы и получать уведомления, вызовите registerConnectivityDiagnosticsCallback . Чтобы отменить регистрацию обратных вызовов и прекратить получать уведомления, вызовите unregisterConnectivityDiagnosticsCallback .

Ниже приведен пример регистрации и отмены регистрации ConnectivityDiagnosticsCallback :

NetworkRequest request =
        new NetworkRequest.Builder()
                .addTransportType(TRANSPORT_CELLULAR)
                .build();
// Use an Executor that is appropriate for your use case
Executor executor = Executors.newSingleThreadExecutor();

ConnectivityDiagnosticsManager cdm =
        context.getSystemService(ConnectivityDiagnosticsManager.class);

ExampleCallback callback = new ExampleCallback();
cdm.registerConnectivityDiagnosticsCallback(
        request, executor, callback);

... 
// Collect connectivity information on networks that match with request
... 

cdm.unregisterConnectivityDiagnosticsCallback(callback);

Проверка

API диагностики подключения протестировано CTS компанией ConnectivityDiagnosticsManagerTest .