Offri 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, in sostituzione dell'API ConnectionService legacy 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 le superfici remote come smartwatch, dispositivi Bluetooth e Android Auto. Inoltre, supporta le estensioni delle chiamate per funzionalità più avanzate, come la gestione dei partecipanti, le icone personalizzate, la disattivazione dell'audio delle chiamate e il riepilogo delle riunioni sulle superfici 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 per le app VoIP di terze parti. Questa ultima release introduce nuove funzionalità avanzate, tra cui la cronologia chiamate unificata, l'esclusione dei registri delle chiamate e la funzionalità di callback nativa, che semplificano la gestione delle chiamate 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 chiamate VoIP o rispondere a una chiamata senza risposta. Con la nuova funzionalità di registrazione delle chiamate integrata, le app di dialer di sistema possono ora mostrare i registri delle chiamate direttamente dalle app VoIP di terze parti.

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

Come funziona:

Per attivare questa funzionalità:

1. Registra 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 gli ID chiamata: 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 il callback: 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 dei registri delle 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 avere il controllo su ciò che viene visualizzato.

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

Nota importante sulla compatibilità

Queste funzionalità di registrazione e callback integrate sono disponibili per i dispositivi con Android 16.1 (SDK 36.1) e versioni successive. Fai riferimento qui per compilare l'app con SDK Android 36.1.

Inizia

Invitiamo gli sviluppatori a testare queste integrazioni e a scoprire in che modo la cronologia chiamate unificata e i callback possono migliorare l'esperienza utente quotidiana delle loro 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 registri delle chiamate native viene introdotta in fasi, a partire da Google Meet. Per proteggersi dallo spam, i dialer nativi utilizzano elenchi consentiti di pacchetti sicuri per controllare la visualizzazione VoIP. Per i test locali delle implementazioni di callback e registrazione, ti consigliamo di utilizzare l'open source app Telecom Sample Dialer come ambiente di emulazione.