Lineamiento del AEP: Framework de Telecom de Android

Realiza la integración con el framework de Telecom de Android usando la biblioteca Core-Telecom Jetpack para garantizar que el sistema operativo trate las llamadas de voz sobre IP (VoIP) como una función principal, al mismo nivel que las llamadas tradicionales basadas en SIM. Esta integración unifica la administración de llamadas, mejora el manejo de audio y permite la compatibilidad con dispositivos remotos, como auriculares y relojes.

Implementación obligatoria

Para calificar para el AEP, tu app debe cumplir con los siguientes requisitos:

ID Lineamiento
AEP-TC-GAA Registro de llamadas: Todas las llamadas de VoIP entrantes y salientes deben registrarse en el framework de Telecom con la API de CallsManager#addCall.
AEP-TC-GAB Administración de estados: Usa CallControlScope y otras construcciones de biblioteca para reflejar y administrar con precisión el ciclo de vida del estado de la llamada, incluidos los estados de marcación, llamada, activa, retenida y desconectada.
AEP-TC-GAC Manejo de audio: No uses directamente las APIs de audio o Bluetooth para administrar el foco de audio y el enrutamiento. En su lugar, confía en el framework de Telecom para manejar situaciones de llamadas simultáneas y cambios en los dispositivos de audio.
AEP-TC-GAD Notificaciones: Usa la API de callStyle para mostrar notificaciones de estilo de llamada que sean coherentes con el sistema Android.
AEP-TC-GAE Ciclo de vida del servicio en primer plano: Administra el ciclo de vida de cualquier servicio en primer plano necesario para la llamada de acuerdo con las prácticas recomendadas y las limitaciones de Android.
AEP-TC-GAF Integración de plataformas remotas: Sincroniza el estado de la llamada y los controles con plataformas remotas conectadas, como auriculares Bluetooth, dispositivos Wear OS y Android Auto.
AEP-TC-GAG Situaciones de varias llamadas: Administra correctamente las interacciones con otras llamadas, como las llamadas SIM entrantes o las llamadas de otras aplicaciones de VoIP, lo que garantiza un comportamiento de audio y una experiencia del usuario predecibles.

Aplicabilidad de los lineamientos

Este lineamiento se aplica a lo siguiente:

  • Las apps proporcionan capacidades de llamadas de voz sobre IP (VoIP).
  • Todos los factores de forma en los que está disponible la app.

Exenciones

Se aplican las siguientes exenciones para este lineamiento:

ID Exención
Apps que no pueden tomar dependencias de AndroidX debido a barreras técnicas, como las siguientes:
AEP-TC-EAA Conflictos de dependencias del SDK
AEP-TC-EAB Restricciones del Proyecto de código abierto de Android (AOSP)
AEP-TC-EAC Restricciones del sistema de compilación del fabricante de equipos originales (OEM)
AEP-TC-EAD Se pueden otorgar exenciones temporales para las apps que tengan problemas importantes con la plataforma o la biblioteca que impidan una migración estable, siempre que haya un cronograma claro para la resolución y Google haya aceptado el problema.
AEP-TC-EAE Las apps pueden usar un framework alternativo equivalente que proporcione calidad, capacidades del usuario, estabilidad y compatibilidad similares en todo el ecosistema. Comunícate con el equipo de asistencia si tienes un framework adecuado para su consideración.

Documentación y recursos de funciones

Los siguientes recursos proporcionan orientación para la implementación y detalles técnicos sobre el framework de Telecom de Android. Estos recursos son solo para tu referencia y no contienen requisitos adicionales del programa.