Mit der ersten Version der Jetpack Telecom-Bibliothek wurde CallsManager eingeführt, die die alte ConnectionService API ersetzt, um die VoIP-Integration zu vereinfachen. CallsManager optimiert die Verwaltung des Anrufslebenszyklus und das Audio-Routing und ermöglicht gleichzeitig die Interaktion mit Remote-Oberflächen wie Smartwatches, Bluetooth-Geräten und Android Auto. Außerdem werden Anruferweiterungen für umfangreichere Funktionen unterstützt, z. B. die Verarbeitung von Teilnehmern, benutzerdefinierte Symbole, das Stummschalten von Anrufen und die Zusammenfassung von Videokonferenzen auf Remote-Oberflächen. Dabei wird die Abwärtskompatibilität bis zu Android O (API-Level 26) beibehalten.

Jetpack Telecom v1.1.0 baut auf dieser Grundlage auf und bietet VoIP-Apps von Drittanbietern Sichtbarkeit und Komfort auf nativer Ebene. Diese aktuelle Version bietet leistungsstarke neue Funktionen wie einen einheitlichen Anrufverlauf, den Ausschluss von Anruflisten und native Rückruffunktionen, die die Anrufverwaltung für Nutzer so einfach wie nie zuvor machen.

Hier erfahren Sie mehr über die Neuerungen und wie Sie diese Funktionen in Ihre Anwendungen implementieren können.

Die Lücke bei der Telefonie schließen: Einheitliche Anrufliste und Rückrufe

Bisher mussten Nutzer einzelne Drittanbieter-Apps öffnen, um ihren VoIP-Anrufverlauf aufzurufen oder einen verpassten Anruf zurückzurufen. Mit der neuen integrierten Anruflistenfunktion können System-Dialer-Apps jetzt Anruflisten direkt aus VoIP-Apps von Drittanbietern anzeigen.

Noch besser: Nutzer können jetzt direkt über die native Systemwählfunktion einen Rückruf an einen VoIP-Kontakt starten. Das macht die Kommunikation noch einfacher.

So gehts

So aktivieren Sie diese Funktion:

1. Callbacks registrieren:Ihre VoIP-App muss einen neuen systemgeschützten Intent registrieren: TelecomManager.ACTION_CALL_BACK.
2. Anruf protokollieren:Verwenden Sie TelecomManager.addCall (oder zugehörige Jetpack-APIs), damit das System den Anruf automatisch protokolliert.
3. Anruf-IDs verwalten:Wenn ein Anruf registriert wird, stellt CallControlScope.getCallId eine eindeutige UUID bereit. Der System-Dialer verwendet genau diese TelecomManager.EXTRA_UUID, wenn er die Callback-Intent erstellt.
4. Rückruf initiieren:Ihre Anwendung muss die mit dieser UUID verknüpften Anrufdetails speichern und verwalten. Wenn die System-Telefon App den Callback-Intent mit der EXTRA_UUID auslöst, kann Ihre App die ID nahtlos auflösen und den Anruf mit den richtigen Details starten.

Detaillierte Steuerung: Anrufliste ausschließen

Wir wissen, dass nicht jeder VoIP-Anruf im nativen Anrufverlauf des Systems sichtbar sein sollte. Sei es aus Datenschutzgründen, für kurzlebige Kommunikation oder für app-spezifisches Verhalten – Sie müssen die Kontrolle darüber haben, was angezeigt wird.

Um dieses Problem zu beheben, führen wir den Ausschluss von Anruflisten ein. Sie können jetzt verhindern, dass bestimmte Anrufe in den Systemanruflisten protokolliert werden, indem Sie den booleschen Wert isLogExcluded in CallAttributesCompat auf true setzen. Wenn Sie dieses Flag konfigurieren, wird der Anruf vollständig in den Systemlogs ausgeblendet und der native Dialer zeigt ihn nicht an.

Wichtiger Hinweis zur Kompatibilität

Diese integrierten Protokollierungs- und Callback-Funktionen sind für Geräte mit Android 16.1 (SDK 36.1) und höher verfügbar. Hier finden Sie Informationen zum Kompilieren Ihrer App mit Android SDK 36.1.

Jetzt starten

Wir empfehlen Entwicklern, diese Integrationen zu testen und herauszufinden, wie eine einheitliche Anrufliste und Callbacks die tägliche Nutzererfahrung Ihrer VoIP-Anwendungen verbessern können.

Damit Sie die APIs in Aktion sehen und leichter mit der Entwicklung beginnen können, haben wir eine Beispielanwendung mit den neuen Integrationen zusammengestellt.

• Beispiel-App ansehen:https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

In den Versionshinweisen und der Dokumentation finden Sie weitere Informationen zur Implementierung dieser Funktionen.

Hinweis: Obwohl die Jetpack Telecom v1.1.0-APIs für die Integration zugänglich sind, wird die Möglichkeit des System-Dialers, native Anruflisten zu rendern, schrittweise eingeführt, beginnend mit Google Meet. Um Spam zu verhindern, verwenden native Dialer sichere Paket-Zulassungslisten, um die VoIP-Anzeige zu steuern. Für lokale Tests Ihrer Callback- und Logging-Implementierungen empfehlen wir die Verwendung der Open-Source-App Telecom Sample Dialer als Emulatorumgebung.