Руководство AEP: Media3

Интеграция библиотеки Jetpack Media3 в качестве стандарта для воспроизведения мультимедиа, сессий, редактирования, метаданных и извлечения кадров гарантирует, что приложения будут использовать рекомендуемые API для обработки сложных задач с мультимедиа на всех форм-факторах Android. Модернизация архитектуры мультимедиа путем перехода от устаревших API фреймворков (таких как MediaPlayer, MediaMuxer и MediaExtractor) к надежной библиотеке Jetpack Media3 обеспечивает единый, многофункциональный инструментарий, гарантирующий согласованный пользовательский опыт с мультимедиа.

Необходимая реализация

Для участия в программе AEP ваше приложение должно соответствовать следующим требованиям:

ИДЕНТИФИКАТОР Руководство
AEP-M3-GAA Не следует использовать устаревшие API фреймворка Android, включая MediaPlayer, MediaExtractor, MediaMuxer и MediaMetadataRetriever.
AEP-M3-GAB Если воспроизведение является ключевым элементом пользовательского процесса, приложение должно интегрировать медиасессии для обеспечения совместимости с операционной системой и интеграции между устройствами.
AEP-M3-GAC Если приложение содержит библиотеку аудиоконтента, оно должно предоставлять доступ к контенту через MediaLibraryService и реализовывать поддержку возобновления воспроизведения.

Применимость рекомендаций

Данное руководство относится к:

  • Приложения, поддерживающие воспроизведение мультимедиа (видео или аудио) или редактирование видео.
  • Приложение доступно для всех форм-факторов.

Исключения

Приложения могут использовать эквивалентную альтернативную платформу, обеспечивающую аналогичное качество, возможности для пользователей, стабильность и совместимость в рамках всей экосистемы. Обратитесь в службу поддержки, если у вас есть подходящая платформа для рассмотрения. Для соответствия требованиям альтернативная реализация должна отвечать следующим критериям:

ИДЕНТИФИКАТОР Освобождение от налогов
AEP-M3-EAA В высокоскоростной сети первый видеокадр должен быть отображен в течение 500 мс с момента инициации пользователем.
AEP-M3-EAB Воспроизведение должно быть плавным, без видимых пропусков кадров или слышимых провалов звука в течение 30-секундного интервала.
AEP-M3-EAC Приложение должно корректно управлять фокусировкой звука .
AEP-M3-EAD Приложение должно реагировать на аппаратные мультимедийные клавиши, даже при работе в фоновом режиме.
AEP-M3-EAE Если поддерживается фоновое воспроизведение, приложение должно отправлять уведомление в формате медиафайла и использовать службу переднего плана.
AEP-M3-EAF Если приложение поддерживает возобновление воспроизведения, оно должно реализовывать эту функцию .
AEP-M3-EAG При отключении наушников необходимо корректно обрабатывать ситуацию. Например, приостанавливать воспроизведение вместо переключения на колонки.
AEP-M3-EAH Воспроизведение должно продолжаться без выпадения кадров при переключении между ориентациями устройства.

Документация и ресурсы по функциональным функциям

Приведенные ниже ресурсы содержат рекомендации по внедрению и технические подробности о функции Media3 . Эти ресурсы предназначены только для ознакомления и не содержат дополнительных требований к программному обеспечению.