Offri visibilità nativa all'esperienza con l'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 chiamate e la funzionalità di callback 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 chiamate VoIP o rispondere a una chiamata senza risposta. Con la nuova funzionalità di registrazione delle chiamate integrata, le app Telefono di sistema possono ora mostrare i registri 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 esattamente TelecomManager.EXTRA_UUID 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 chiamate

Sappiamo 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 la registrazione di chiamate specifiche nei registri chiamate di sistema impostando il valore booleano isLogExcluded su true all'interno di CallAttributesCompat. Configurando 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 Android SDK 36.1.

Inizia

Invitiamo gli sviluppatori a testare queste integrazioni ed esplorare come 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 chiamate native viene introdotta in fasi, a partire da Google Meet. Per proteggersi dallo spam, i dialer nativi utilizzano liste consentite di pacchetti sicuri per controllare la visualizzazione VoIP. Per i test locali delle implementazioni di callback e registrazione, ti consigliamo di utilizzare l'app open source Telecom Sample Dialer come ambiente di emulazione.