Lineamiento de AEP: Media3

Integra la biblioteca de Jetpack Media3 como el estándar para la reproducción, las sesiones, la edición, los metadatos y la extracción de fotogramas de contenido multimedia para garantizar que las apps utilicen las APIs recomendadas para controlar tareas complejas de contenido multimedia en todos los factores de forma de Android. La modernización de la arquitectura de contenido multimedia mediante la migración de las APIs del framework heredado (como MediaPlayer, MediaMuxer y MediaExtractor) a la sólida biblioteca de Jetpack Media3 proporciona un kit de herramientas unificado y repleto de funciones que garantiza experiencias de contenido multimedia coherentes.

Implementación obligatoria

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

  • No debe usar las APIs del framework de Android heredado, incluidas MediaPlayer, MediaExtractor, MediaMuxer y MediaMetadataRetriever.
  • Si la reproducción es un recorrido del usuario principal, la app debe integrar sesiones de contenido multimedia para el reconocimiento del SO y la integración multidispositivo.
  • Si la app tiene una biblioteca de contenido de audio, debe exponer el contenido a través de MediaLibraryService y, además, implementar la compatibilidad con la reanudación de contenido multimedia.

Aplicabilidad de los lineamientos

Este lineamiento se aplica a lo siguiente:

  • Apps que admiten la reproducción de contenido multimedia (video o audio) o la edición de video
  • A todos los factores de forma en los que la app está disponible

Exenciones

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. Para calificar, la implementación alternativa debe cumplir con los siguientes parámetros de referencia:

  • En una red rápida, el primer fotograma de video debe mostrarse dentro de los 500 ms de la iniciación del usuario.
  • La reproducción debe seguir siendo fluida, sin pérdidas de fotogramas visibles ni subejecuciones de audio audibles durante un período de 30 segundos.
  • La app debe administrar correctamente el enfoque de audio.
  • La app debe responder a las teclas de contenido multimedia de hardware, incluso cuando se ejecuta en segundo plano.
  • Si se admite la reproducción en segundo plano, la app debe publicar una notificación de estilo de contenido multimedia y usar un servicio en primer plano.
  • Si la app admite la reanudación de la reproducción, debe implementar la reanudación de contenido multimedia.
  • Las desconexiones de auriculares deben controlarse correctamente. Por ejemplo, pausar la reproducción en lugar de cambiar al altavoz.
  • La reproducción debe continuar sin pérdidas de fotogramas cuando se cambia entre las orientaciones del dispositivo.

Documentación y recursos de funciones

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