Lineamiento del AEP: Framework de Telecom de Android

Integra la biblioteca Core-Telecom de Jetpack con el marco de trabajo de Telecomunicaciones de Android para garantizar que el sistema operativo trate las llamadas de voz sobre IP (VoIP) como una función principal, al igual 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:

  • Registro de llamadas: Todas las llamadas VoIP entrantes y salientes deben registrarse con el marco de trabajo de Telecomunicaciones mediante la API de CallsManager#addCall.
  • 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.
  • Manejo de audio: No uses directamente las APIs de Audio o Bluetooth para administrar el enfoque y el enrutamiento de audio. En su lugar, confía en el marco de trabajo de Telecomunicaciones para manejar situaciones de llamadas simultáneas y cambios en los dispositivos de audio.
  • Notificaciones: Usa la API de callStyle para mostrar notificaciones de estilo de llamada que sean coherentes con el sistema Android.
  • 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.
  • Integración de la superficie remota: Sincroniza el estado y los controles de la llamada con las superficies remotas conectadas, como auriculares Bluetooth, dispositivos Wear OS y Android Auto.
  • Situaciones de varias llamadas: Maneja correctamente las interacciones con otras llamadas, como las llamadas SIM entrantes o las llamadas de otras aplicaciones 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:

  • Las apps que no pueden tomar dependencias de AndroidX debido a obstáculos técnicos, como los siguientes:
    • Conflictos de dependencias del SDK
    • Restricciones del Proyecto de código abierto de Android (AOSP)
    • Restricciones del sistema de compilación del fabricante de equipos originales (OEM)
  • Se pueden otorgar exenciones temporales para las apps que tengan problemas importantes de plataforma o biblioteca que impidan una migración estable, siempre que haya un cronograma claro para la resolución y Google haya aceptado el problema.
  • Las apps pueden usar un marco de trabajo 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 marco de trabajo 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 marco de trabajo de Telecomunicaciones de Android. Estos recursos son solo para tu referencia y no contienen requisitos adicionales del programa.