Die Connectivity diagnostic API ermöglicht Apps, die Netzwerke besitzen oder verwalten, wie z. B. wie Apps von Mobilfunkanbietern, VPN-Apps und Apps mit WLAN-Vorschlägen, um Diagnoseergebnisse zu erhalten. Informationen 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 für WLAN-Vorschläge:Sie sind Inhaber von WLAN-Vorschlägen, die dem Nutzer vorgeschlagen werden. System
- VPN-Apps:Alle vom VPN genutzten Netzwerke verwalten, aber nur, wenn Das ist das aktive VPN
Callbacks werden in den folgenden Fällen 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 ob das Netzwerk eine Verbindung herstellt oder nicht, freigegeben ist.
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
...
}
}
Um Rückrufe zu registrieren und Benachrichtigungen zu erhalten, rufen Sie
registerConnectivityDiagnosticsCallback
Um die Registrierung von Rückrufen aufzuheben und keine Benachrichtigungen mehr zu erhalten, rufe
unregisterConnectivityDiagnosticsCallback
Im Folgenden finden Sie ein Beispiel für das Registrieren und Abmelden
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);
Zertifizierungsstufe
Die Connectivity Diagnose-API ist CTS-geprüft von
ConnectivityDiagnosticsManagerTest