Brinda visibilidad nativa a la experiencia en la app de VoIP con la versión alfa más reciente de Telecom

El lanzamiento inicial de la biblioteca de Jetpack Telecom introdujo CallsManager, que reemplaza 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 habilita las interacciones con plataformas remotas, como relojes inteligentes, dispositivos Bluetooth y Android Auto. Además, admite extensiones de llamadas para funciones más enriquecidas, como el manejo de participantes, los íconos personalizados, el silenciamiento de llamadas y el resumen de reuniones en plataformas remotas, todo mientras se mantiene la retrocompatibilidad con 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 presenta nuevas funciones potentes, como el historial de llamadas unificado, la exclusión del registro de llamadas y la función 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 las novedades y cómo puedes implementar estas funciones en tus aplicaciones.

Bridging the Dialer Gap: Unified call history and Callbacks

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

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

Cómo funciona:

Para habilitar esta función, haz lo siguiente:

1. Registrarse 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 la llamada automáticamente.
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 con este UUID. Cuando el marcador del sistema activa el intent de devolución de llamada con el EXTRA_UUID, tu app puede resolver el ID sin problemas y, luego, 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 de registros de llamadas. Ahora puedes evitar que se registren llamadas específicas en los registros de llamadas del sistema configurando el booleano isLogExcluded como 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 llamadas pueden mejorar la experiencia diaria de los usuarios de tus 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: Aunque 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 por Google Meet. Para protegerse contra el spam, los agentes de llamadas nativos usan listas de paquetes permitidos seguras 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 muestra de Telecom de código abierto como entorno de emulador.