El lanzamiento inicial de la biblioteca de Jetpack Telecom introdujo CallsManager, que reemplaza la API heredada ConnectionService para simplificar la integración de VoIP. CallsManager optimiza la administración del ciclo de vida de las llamadas y el enrutamiento de audio, al mismo tiempo que permite interacciones con superficies remotas, como relojes inteligentes, dispositivos Bluetooth y Android Auto. Además, admite extensiones de llamadas para funciones más completas, como el manejo de participantes, íconos personalizados, silenciamiento de llamadas y resumen de reuniones en superficies remotas, todo ello manteniendo la retrocompatibilidad hasta Android O (nivel de API 26).

Sobre esta base, Jetpack Telecom v1.1.0 ofrece visibilidad y comodidad a nivel nativo para las apps de VoIP de terceros. Esta versión más reciente introduce nuevas y potentes capacidades, como el historial de llamadas unificado, la exclusión del registro de llamadas y la funcionalidad de devolución de llamada nativa, lo que hace que la administración de llamadas sea más fluida que nunca para los usuarios.

Aquí encontrarás más detalles sobre las novedades y cómo puedes implementar estas funciones en tus aplicaciones.

Cerrar la brecha del marcador: Historial de llamadas unificado y devoluciones de llamada

Históricamente, los usuarios debían abrir apps individuales de terceros para ver su historial de llamadas de VoIP o devolver una llamada perdida. Con la nueva función de registro de llamadas integrada, las apps de marcador del sistema ahora pueden mostrar registros de llamadas directamente desde apps de VoIP de terceros.

Aún mejor, los usuarios ahora pueden iniciar una devolución de llamada a un contacto de VoIP directamente desde su marcador de sistema nativo, lo que optimiza la experiencia de comunicación.

Cómo funciona:

Para habilitar esta función, haz lo siguiente:

1. Regístrate para las devoluciones de llamada: Tu app de VoIP debe registrar un intent nuevo protegido por el sistema: TelecomManager.ACTION_CALL_BACK.
2. Registra la llamada: Usa TelecomManager.addCall (o las APIs de Jetpack relacionadas) para asegurarte de que el sistema registre automáticamente la llamada.
3. Administra los IDs de llamada: Cuando se registra una llamada, CallControlScope.getCallId proporciona un UUID único. El marcador del sistema usa este TelecomManager.EXTRA_UUID exacto cuando crea el intent de devolución de llamada.
4. Inicia la devolución de llamada: Tu aplicación debe almacenar y administrar los detalles de la llamada asociados con este UUID. Cuando el marcador del sistema activa el intent de devolución de llamada con EXTRA_UUID, tu app puede resolver el ID sin problemas e iniciar la llamada con los detalles correctos.

Control detallado: Exclusión del registro de llamadas

Reconocemos que no todas las llamadas de VoIP deben ser visibles en el historial del marcador nativo del sistema. Ya sea por motivos de privacidad, comunicación efímera o comportamiento específico de la app, necesitas controlar lo que se muestra.

Para abordar este problema, presentamos la exclusión del registro de llamadas. Ahora puedes evitar que se registren llamadas específicas en los registros de llamadas del sistema configurando el valor booleano isLogExcluded en true dentro de CallAttributesCompat. Si configuras esta marca, la llamada permanecerá completamente oculta en los registros del sistema y el marcador nativo no la mostrará.

Nota importante sobre la compatibilidad

Estas funciones integradas de registro y devolución de llamada están disponibles para dispositivos con Android 16.1 (SDK 36.1) y versiones posteriores. Consulta aquí para compilar tu app con el SDK de Android 36.1.

Comenzar ahora

Recomendamos a los desarrolladores que prueben estas integraciones y exploren cómo el historial de llamadas unificado y las devoluciones de llamada pueden mejorar la experiencia diaria del usuario de sus aplicaciones de VoIP.

Para ayudarte a comenzar y ver estas APIs en acción, creamos una aplicación de ejemplo que muestra las nuevas integraciones.

• Consulta la app de ejemplo aquí: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Consulta las notas de la versión y la documentación para comenzar a implementar estas funciones hoy mismo.

Nota:: Si bien se puede acceder a las APIs de Jetpack Telecom v1.1.0 para la integración, la capacidad del marcador del sistema para renderizar registros de llamadas nativos se está introduciendo por fases, comenzando con Google Meet. Para protegerse contra el spam, los marcadores nativos utilizan listas de entidades permitidas de paquetes seguros para controlar la visualización de VoIP. Para probar de forma local tus implementaciones de devolución de llamada y registro, te recomendamos que uses la app de marcador de ejemplo de Telecom de código abierto como tu entorno de emulador.