El lanzamiento inicial de la biblioteca de Jetpack Telecom introdujo CallsManager, que reemplazó la API heredada de 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, a la vez 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, silencio de llamadas y resúmenes de reuniones en plataformas remotas, todo ello manteniendo la retrocompatibilidad hasta Android O (nivel de API 26).

Sobre esta base, Jetpack Telecom v1.1.0 brinda visibilidad y comodidad a nivel nativo para las apps de VoIP de terceros. Esta versión más reciente presenta 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.

A continuación, te mostramos con más detalle las novedades y cómo puedes implementar estas funciones en tus aplicaciones.

Bridging the Dialer Gap: Unified call history and Callbacks (Cómo cerrar la brecha del marcador: historial de llamadas unificado y devoluciones de llamadas)

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

Aún mejor, ahora los usuarios pueden iniciar una devolución de llamada a un contacto de VoIP directamente desde el marcador del 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 recibir devoluciones de llamada: Tu app de VoIP debe registrar un nuevo intent 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 llamadas: 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 a 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 VoIP deben aparecer 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 que ejecutan Android 16.1 (SDK 36.1) y versiones posteriores. Consulta aquí para compilar tu app con el SDK de Android 36.1.

Comenzar ahora

Alentamos a los desarrolladores a probar estas integraciones y explorar 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 en fases, comenzando con Google Meet. Para protegerse contra el spam, los marcadores nativos utilizan listas de entidades permitidas de paquetes seguros para controlar la pantalla de VoIP. Para probar de forma local las implementaciones de devolución de llamada y registro, te recomendamos que uses la app de ejemplo de marcador de Telecom de código abierto como entorno de emulador.