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

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

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

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

  • Не следует использовать устаревшие API фреймворка Android, включая MediaPlayer, MediaExtractor, MediaMuxer и MediaMetadataRetriever.
  • Если воспроизведение является ключевым элементом пользовательского процесса, приложение должно интегрировать медиасессии для обеспечения совместимости с операционной системой и интеграции между устройствами.
  • Если приложение содержит библиотеку аудиоконтента, оно должно предоставлять доступ к контенту через MediaLibraryService и реализовывать поддержку возобновления воспроизведения.

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

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

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

Исключения

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

  • В высокоскоростной сети первый видеокадр должен быть отображен в течение 500 мс с момента инициации пользователем.
  • Воспроизведение должно быть плавным, без видимых пропусков кадров или слышимых провалов звука в течение 30-секундного интервала.
  • Приложение должно корректно управлять фокусировкой звука .
  • Приложение должно реагировать на аппаратные мультимедийные клавиши, даже при работе в фоновом режиме.
  • Если поддерживается фоновое воспроизведение, приложение должно отправлять уведомление в формате медиафайла и использовать службу переднего плана.
  • Если приложение поддерживает возобновление воспроизведения, оно должно реализовывать эту функцию .
  • При отключении наушников необходимо корректно обрабатывать ситуацию. Например, приостанавливать воспроизведение вместо переключения на колонки.
  • Воспроизведение должно продолжаться без выпадения кадров при переключении между ориентациями устройства.

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

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