Connectivity Diagnostics API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mit der Connectivity Diagnostics API können Apps, die Netzwerke besitzen oder verwalten, z. B. Apps von Mobilfunkanbietern, VPN-Apps und Apps mit WLAN-Vorschlägen, Diagnoseinformationen zur Netzwerkverbindung vom Framework erhalten. Diese Apps können sich registrieren und Benachrichtigungen mit Verbindungsinformationen für die Netzwerken, die ihnen gehören oder die sie verwalten. Apps erhalten keine Benachrichtigungen für Netzwerke, die nicht der App gehören oder von ihr verwaltet werden.

Im Folgenden finden Sie Beispiele für Apps, die Netzwerke verwalten oder besitzen:

• Mobilfunkanbieter-Apps:Hier können Sie die Mobilfunknetze verwalten, für die Ihr subId hat Mobilfunkanbieter-Berechtigungen für
• Apps mit WLAN-Vorschlägen: Eigene WLANs, die dem System vorgeschlagen werden
• VPN-Apps:Alle vom VPN genutzten Netzwerke verwalten, aber nur, wenn Das ist das aktive VPN

In den folgenden Fällen werden Rückrufe aufgerufen:

• Netzwerkvalidierung:Das System hat die Bewertung eines bestimmten Netzwerks abgeschlossen. Die ConnectivityReport -Klasse Informationen zum aktuellen Status des Netzwerks und Ergebnisse aller Tests oder Verfahren, die im Rahmen der Validierung durchgeführt werden.

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

• Verdachte Datenverzögerung: Eine Datenverzögerung, also eine Bedingung, bei der IP-Pakete nicht richtig durch das Netzwerk fließen, wird vermutet. Die DataStallReport -Klasse Informationen über verdächtige Datenstände bereitstellt.

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

• Konnektivität gemeldet:Eine App hat eine Verbindung gemeldet über ConnectivityManager#reportNetworkConnectivity an das System gesendet werden. Das Netzwerk und die gemeldete Verbindung (ob die App der Meinung ist, dass das Netzwerk eine Verbindung herstellt oder nicht) werden weitergegeben.

Implementierung

Zur Verwendung der Connectivity diagnostic API muss eine App eine ConnectivityDiagnosticsManager von der Plattform aus. Diese Instanz sollte zum Registrieren und abmelden ConnectivityDiagnosticsCallback Implementierungen. Nicht überschriebene Callback-Methoden sind keine Vorgänge.

Unten sehen Sie ein Beispiel für eine ConnectivityDiagnosticsCallback Implementierung:

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
        ... 
    }
}

Wenn Sie Rückrufe registrieren und Benachrichtigungen erhalten möchten, rufen Sie registerConnectivityDiagnosticsCallback auf. Um die Registrierung von Rückrufen aufzuheben und keine Benachrichtigungen mehr zu erhalten, rufe unregisterConnectivityDiagnosticsCallback

Im folgenden Beispiel wird ConnectivityDiagnosticsCallback registriert und wieder abgemeldet:

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

Zertifizierungsstufe

Die Connectivity Diagnose-API ist CTS-geprüft von ConnectivityDiagnosticsManagerTest