Aggiungi la visibilità nativa all'esperienza della tua app VoIP con l'ultima versione alpha di Telecom

Il lancio iniziale della libreria Jetpack Telecom ha introdotto CallsManager, sostituendo la precedente API ConnectionService per semplificare l'integrazione VoIP. CallsManager semplifica la gestione del ciclo di vita delle chiamate e il routing audio, consentendo al contempo le interazioni con piattaforme remote come smartwatch, dispositivi Bluetooth e Android Auto. Inoltre, supporta le estensioni di chiamata per funzionalità più avanzate, come la gestione dei partecipanti, le icone personalizzate, la disattivazione dell'audio delle chiamate e il riepilogo delle riunioni su piattaforme remote, il tutto mantenendo la compatibilità con le versioni precedenti fino ad Android O (livello API 26).

Basandosi su questa base, Jetpack Telecom v1.1.0 offre visibilità e praticità a livello nativo alle app VoIP di terze parti. Questa ultima release introduce nuove e potenti funzionalità, tra cui la cronologia chiamate unificata, l'esclusione dei registri chiamate e la funzionalità di richiamata nativa, che rendono la gestione delle chiamate più semplice che mai per gli utenti.

Ecco uno sguardo più da vicino alle novità e a come puoi implementare queste funzionalità nelle tue applicazioni.

Colmare il divario del dialer: cronologia chiamate unificata e callback

In passato, gli utenti dovevano aprire singole app di terze parti per visualizzare la cronologia delle chiamate VoIP o richiamare un numero senza risposta. Con la nuova funzionalità di registrazione delle chiamate integrata, le app di composizione del sistema ora possono mostrare i registri delle chiamate direttamente dalle app VoIP di terze parti.

Ancora meglio, gli utenti ora possono avviare un richiamo a un contatto VoIP direttamente dal dialer di sistema nativo, semplificando l'esperienza di comunicazione.

Come funziona:

Per attivare questa funzionalità:

1. Registrati per i callback:la tua app VoIP deve registrare un nuovo intent protetto dal sistema: TelecomManager.ACTION_CALL_BACK.
2. Registra la chiamata:utilizza TelecomManager.addCall (o le API Jetpack correlate) per assicurarti che il sistema registri automaticamente la chiamata.
3. Gestisci ID chiamate:quando una chiamata viene registrata, CallControlScope.getCallId fornisce un UUID univoco. Il dialer di sistema utilizza questo TelecomManager.EXTRA_UUID esatto quando crea l'intent di callback.
4. Avvia la richiamata:la tua applicazione deve archiviare e gestire i dettagli della chiamata associati a questo UUID. Quando il dialer di sistema attiva l'intent di callback con EXTRA_UUID, la tua app può risolvere facilmente l'ID e avviare la chiamata con i dettagli corretti.

Controllo granulare: esclusione del registro chiamate

Siamo consapevoli che non tutte le chiamate VoIP devono essere visibili nella cronologia del dialer nativo del sistema. Per motivi di privacy, comunicazione effimera o comportamento specifico dell'app, devi controllare cosa viene visualizzato.

Per risolvere questo problema, stiamo introducendo l'esclusione del registro chiamate. Ora puoi impedire la registrazione di chiamate specifiche nei registri chiamate di sistema impostando il valore booleano isLogExcluded su true all'interno di CallAttributesCompat. Se configuri questo flag, la chiamata rimane completamente nascosta dai log di sistema e il dialer nativo non la visualizzerà.

Nota importante sulla compatibilità

Queste funzionalità integrate di logging e callback sono disponibili per i dispositivi con Android 16.1 (SDK 36.1) e versioni successive. Consulta questa pagina per compilare la tua app con l'SDK Android 36.1.

Inizia

Invitiamo gli sviluppatori a testare queste integrazioni ed esplorare in che modo la cronologia chiamate unificata e i callback possono migliorare l'esperienza utente quotidiana delle applicazioni VoIP.

Per aiutarti a iniziare e a vedere queste API in azione, abbiamo creato un'applicazione di esempio che mostra le nuove integrazioni.

• Visualizza l'app di esempio qui: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Consulta le note di rilascio e la documentazione per iniziare a implementare queste funzionalità oggi stesso.

Nota: sebbene le API Jetpack Telecom v1.1.0 siano accessibili per l'integrazione, la possibilità del dialer di sistema di eseguire il rendering dei log delle chiamate nativi viene introdotta per fasi, a partire da Google Meet. Per proteggersi dallo spam, i dialer nativi utilizzano liste consentite di pacchetti sicuri per controllare la visualizzazione del VoIP. Per il test locale delle implementazioni di callback e logging, ti consigliamo di utilizzare l'app di esempio Telecom Sample Dialer open source come ambiente di emulazione.