Lineamiento de AEP: Media3

Integra la biblioteca de Jetpack Media3 como 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 multimedia complejas en los distintos factores de forma de Android. La modernización de la arquitectura de medios a través de 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 rico en funciones que garantiza experiencias de medios coherentes.

Implementación obligatoria

Para cumplir con los requisitos del AEP, tu app debe cumplir con los siguientes requisitos:

ID Lineamiento
AEP-M3-GAA No se deben usar las APIs heredadas del framework de Android, incluidas MediaPlayer, MediaExtractor, MediaMuxer y MediaMetadataRetriever.
AEP-M3-GAB 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.
AEP-M3-GAC Si la app tiene una biblioteca de contenido de audio, debe exponer el contenido a través de MediaLibraryService y admitir 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 (audio o video) o la edición de video
  • Para todos los factores de forma en los que está disponible la app.

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 marco de trabajo adecuado para su consideración. Para cumplir con los requisitos, la implementación alternativa debe satisfacer los siguientes parámetros de referencia:

ID Exención
AEP-M3-EAA En una red rápida, el primer fotograma del video debe mostrarse en un plazo de 500 ms después de que el usuario inicie la reproducción.
La reproducción debe ser fluida, sin interrupciones visibles de fotogramas ni interrupciones de audio audibles durante un período de 30 segundos.
La app debe administrar correctamente el foco de audio.
La app debe responder a las teclas 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 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 de forma correcta. Por ejemplo, pausar la reproducción en lugar de cambiar al altavoz.
La reproducción debe continuar sin pérdida de fotogramas cuando se cambia la orientación del dispositivo.

Documentación y recursos de las funciones

En los siguientes recursos, se 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.