Эта страница переведена с помощью Cloud Translation API.

Медиа3

Справочник по API
androidx.media3.common

Поддержка библиотек для сценариев использования мультимедиа.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
20 декабря 2024 г.	1.5.1	-	-	1.6.0-альфа01

Объявление зависимостей

Чтобы добавить зависимость от Media3, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

dependencies {
    def media3_version = "1.4.1"

    // For media playback using ExoPlayer
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // For DASH playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // For HLS playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // For SmoothStreaming playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version"
    // For RTSP playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version"
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation "androidx.media3:media3-exoplayer-midi:$media3_version"
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    // For loading data using the Cronet network stack
    implementation "androidx.media3:media3-datasource-cronet:$media3_version"
    // For loading data using the OkHttp network stack
    implementation "androidx.media3:media3-datasource-okhttp:$media3_version"
    // For loading data using librtmp
    implementation "androidx.media3:media3-datasource-rtmp:$media3_version"

    // For building media playback UIs
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

    // For exposing and controlling media sessions
    implementation "androidx.media3:media3-session:$media3_version"

    // For extracting data from media containers
    implementation "androidx.media3:media3-extractor:$media3_version"

    // For integrating with Cast
    implementation "androidx.media3:media3-cast:$media3_version"

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version"

    // For transforming media files
    implementation "androidx.media3:media3-transformer:$media3_version"

    // For applying effects on video frames
    implementation "androidx.media3:media3-effect:$media3_version"

    // For muxing media files
    implementation "androidx.media3:media3-muxer:$media3_version"

    // Utilities for testing media components (including ExoPlayer components)
    implementation "androidx.media3:media3-test-utils:$media3_version"
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation "androidx.media3:media3-test-utils-robolectric:$media3_version"

    // Common functionality for reading and writing media containers
    implementation "androidx.media3:media3-container:$media3_version"
    // Common functionality for media database components
    implementation "androidx.media3:media3-database:$media3_version"
    // Common functionality for media decoders
    implementation "androidx.media3:media3-decoder:$media3_version"
    // Common functionality for loading data
    implementation "androidx.media3:media3-datasource:$media3_version"
    // Common functionality used across multiple media libraries
    implementation "androidx.media3:media3-common:$media3_version"
    // Common Kotlin-specific functionality
    implementation "androidx.media3:media3-common-ktx:$media3_version"
}

Котлин

dependencies {
    val media3_version = "1.4.1"

    // For media playback using ExoPlayer
    implementation("androidx.media3:media3-exoplayer:$media3_version")

    // For DASH playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-dash:$media3_version")
    // For HLS playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-hls:$media3_version")
    // For SmoothStreaming playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version")
    // For RTSP playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version")
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation("androidx.media3:media3-exoplayer-midi:$media3_version")
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-ima:$media3_version")

    // For loading data using the Cronet network stack
    implementation("androidx.media3:media3-datasource-cronet:$media3_version")
    // For loading data using the OkHttp network stack
    implementation("androidx.media3:media3-datasource-okhttp:$media3_version")
    // For loading data using librtmp
    implementation("androidx.media3:media3-datasource-rtmp:$media3_version")

    // For building media playback UIs
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation("androidx.media3:media3-ui-leanback:$media3_version")

    // For exposing and controlling media sessions
    implementation("androidx.media3:media3-session:$media3_version")

    // For extracting data from media containers
    implementation("androidx.media3:media3-extractor:$media3_version")

    // For integrating with Cast
    implementation("androidx.media3:media3-cast:$media3_version")

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version")

    // For transforming media files
    implementation("androidx.media3:media3-transformer:$media3_version")

    // For applying effects on video frames
    implementation("androidx.media3:media3-effect:$media3_version")

    // For muxing media files
    implementation("androidx.media3:media3-muxer:$media3_version")

    // Utilities for testing media components (including ExoPlayer components)
    implementation("androidx.media3:media3-test-utils:$media3_version")
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation("androidx.media3:media3-test-utils-robolectric:$media3_version")

    // Common functionality for reading and writing media containers
    implementation("androidx.media3:media3-container:$media3_version")
    // Common functionality for media database components
    implementation("androidx.media3:media3-database:$media3_version")
    // Common functionality for media decoders
    implementation("androidx.media3:media3-decoder:$media3_version")
    // Common functionality for loading data
    implementation("androidx.media3:media3-datasource:$media3_version")
    // Common functionality used across multiple media libraries
    implementation("androidx.media3:media3-common:$media3_version")
    // Common Kotlin-specific functionality
    implementation("androidx.media3:media3-common-ktx:$media3_version")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

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

Версия 1.6.0

Версия 1.6.0-альфа01

20 декабря 2024 г.

Выпущен androidx.media3:media3-*:1.6.0-alpha01 . Версия 1.6.0-alpha01 содержит эти коммиты .

Общая библиотека:
- Удалите метод Format.toBundle(boolean excludeMetadata) , вместо этого используйте Format.toBundle() .
- Добавьте AudioManagerCompat и AudioFocusRequestCompat , чтобы заменить эквивалентные классы в androidx.media .
Экзоплеер:
- Учитывайте язык при выборе видеодорожки. По умолчанию выберите «основную» видеодорожку, соответствующую языку выбранной звуковой дорожки, если она доступна. Явные настройки языка видео можно выразить с помощью TrackSelectionParameters.Builder.setPreferredVideoLanguage(s) .
- Добавьте параметр selectedAudioLanguage в метод DefaultTrackSelector.selectVideoTrack() .
- Добавьте параметр retryCount в MediaSourceEventListener.onLoadStarted и соответствующие методы MediaSourceEventListener.EventDispatcher .
- Исправлена ошибка, из-за которой элементы или периоды плейлиста в многопериодных потоках DASH с длительностью, не соответствующей фактическому содержимому, могли вызывать зависание кадра в конце элемента ( #1698 ).
- Уменьшите значения по умолчанию для bufferForPlaybackMs и bufferForPlaybackAfterRebufferMs в DefaultLoadControl до 1000 и 2000 мс соответственно.
- Добавьте MediaExtractorCompat , новый класс, который предоставляет функции, эквивалентные платформе MediaExtractor .
- Переместите BasePreloadManager.Listener в PreloadManagerListener верхнего уровня.
- RenderersFactory.createSecondaryRenderer можно реализовать для предоставления вторичных средств визуализации для предварительного прогрева. Предварительный прогрев обеспечивает более быструю смену элементов мультимедиа во время воспроизведения.
- Включите отправку CmcdData для запросов манифеста в форматах адаптивной потоковой передачи DASH, HLS и SmoothStreaming ( #1951 ).
- Укажите MediaCodecInfo кодека, который будет инициализирован в MediaCodecRenderer.onReadyToInitializeCodec ( #1963 ).
- Измените AdsMediaSource , чтобы позволить AdPlaybackStates увеличиваться за счет добавления групп объявлений. Обнаруживаются недопустимые модификации и выдается исключение.
Трансформатор:
- Обновите параметры VideoFrameProcessor.registerInputStream и VideoFrameProcessor.Listener.onInputStreamRegistered чтобы использовать Format .
- Добавьте поддержку преобразования в альтернативные обратно совместимые форматы.
- Генерируйте статические метаданные HDR при использовании DefaultEncoderFactory .
Экстракторы:
- AVI: исправлена обработка файлов со сжатым звуком с постоянным битрейтом, где в заголовке потока хранится количество байтов, а не количество фрагментов.
Аудио:
- Исправлен вызов onAudioPositionAdvancing при возобновлении воспроизведения (ранее он вызывался, когда воспроизведение было приостановлено).
Видео:
- Исправьте MediaCodecVideoRenderer так, что при отсутствии Surface средство визуализации пропускает только ранние кадры, только если VideoFrameReleaseControl.getFrameReleaseAction не равен FRAME_RELEASE_TRY_AGAIN_LATER .
Текст:
- Прекратите нетерпеливую загрузку всех файлов субтитров, настроенных с помощью MediaItem.Builder.setSubtitleConfigurations , и вместо этого загружайте только один, если он выбран при выборе дорожки ( #1721 ).
Эффект:
- Функциональность OverlaySettings перенесена в StaticOverlaySettings . OverlaySettings можно разделить на подклассы, чтобы обеспечить динамические настройки наложения.
Мультиплексоры:
- Исключение MuxerException удалено из интерфейса Muxer , чтобы избежать очень длинного полного имени.
Сессия:
- Добавьте «Контекст» в качестве параметра в «MediaButtonReceiver.shouldStartForegroundService» ( #1887 ).
Пользовательский интерфейс:
- Добавьте PlayerSurface Composable в модуль media3-ui-compose .
- Добавьте классы PlayPauseButtonState , NextButtonState , PreviousButtonState , RepeatButtonState , ShuffleButtonState и соответствующие компонуемые элементы rememberPlayPauseButtonState , rememberNextButtonState , rememberPreviousButtonState , rememberRepeatButtonState , rememberShuffleButtonState в модуль media3-ui-compose .
Расширение HLS:
- Добавьте первую версию HlsInterstitialsAdsLoader . Загрузчик рекламы считывает межстраничные объявления HLS из списка воспроизведения мультимедиа HLS и сопоставляет их с AdPlaybackState , который передается в AdsMediaSource . Эта первоначальная версия поддерживает только потоки HLS VOD с атрибутами X-ASSET-URI .
- Добавьте HlsInterstitialsAdsLoader.AdsMediaSourceFactory . Приложения могут использовать его для создания экземпляров AdsMediaSource , использующих HlsInterstitialsAdsLoader , удобным и безопасным способом.
Расширение DASH:
- Добавьте поддержку формата AC-4 Level-4 для DASH ( #1898 ).
Расширения декодера (FFmpeg, VP9, AV1 и т. д.):
- Добавьте модуль декодера MPEG-H, который использует собственный модуль декодера MPEG-H для декодирования звука MPEG-H ( #1826 ).
Демо-приложение:
- Добавьте элементы MinimalControls ( PlayPauseButton , NextButton , PreviousButton ) и ExtraControls ( RepeatButton , ShuffleButton ) составного пользовательского интерфейса для demo-compose с использованием PlayPauseButtonState , NextButtonState , PreviousButtonState , RepeatButtonState , ShuffleButtonState .
Удалите устаревшие символы:
- Удалите устаревший метод AudioMixer.create() . Вместо этого используйте DefaultAudioMixer.Factory().create() .
- Удалите следующие устаревшие методы Transformer.Builder :
  - setTransformationRequest() вместо этого используйте setAudioMimeType() , setVideoMimeType() и setHdrMode() .
  - setAudioProcessors() , установите аудиопроцессор в EditedMediaItem.Builder.setEffects() и вместо этого передайте его в Transformer.start() .
  - setVideoEffects() , установите видеоэффект в EditedMediaItem.Builder.setEffects() и вместо этого передайте его в Transformer.start() .
  - setRemoveAudio() , используйте EditedMediaItem.Builder.setRemoveAudio() чтобы удалить звук из EditedMediaItem , переданного в Transformer.start() .
  - setRemoveVideo() , используйте EditedMediaItem.Builder.setRemoveVideo() чтобы удалить видео из EditedMediaItem , переданного вместо этого в Transformer.start() .
  - setFlattenForSlowMotion() , вместо этого используйте EditedMediaItem.Builder.setFlattenForSlowMotion() чтобы сгладить EditedMediaItem , переданный в Transformer.start() .
  - setListener() , вместо этого используйте addListener() , removeListener() или removeAllListeners() .
- Удалите следующие устаревшие методы Transformer.Listener :
  - onTransformationCompleted(MediaItem) , вместо этого используйте onCompleted(Composition, ExportResult) .
  - onTransformationCompleted(MediaItem, TransformationResult) вместо этого используйте onCompleted(Composition, ExportResult) .
  - onTransformationError(MediaItem, Exception) вместо этого используйте onError(Composition, ExportResult, ExportException) .
  - onTransformationError(MediaItem, TransformationException) вместо этого используйте onError(Composition, ExportResult, ExportException) .
  - onTransformationError(MediaItem, TransformationResult, TransformationException) вместо этого используйте onError(Composition, ExportResult, ExportException) .
  - onFallbackApplied(MediaItem, TransformationRequest, TransformationRequest) , вместо этого используйте onFallbackApplied(Composition, TransformationRequest, TransformationRequest) .
- Удалите устаревший класс TransformationResult . Вместо этого используйте ExportResult .
- Удалите устаревший класс TransformationException . Вместо этого используйте ExportException .
- Удалите устаревший Transformer.PROGRESS_STATE_NO_TRANSFORMATION . Вместо этого используйте Transformer.PROGRESS_STATE_NOT_STARTED .
- Удалите устаревший Transformer.setListener() . Вместо этого используйте Transformer.addListener() , Transformer.removeListener() или Transformer.removeAllListeners() .
- Удалите устаревший Transformer.startTransformation() . Вместо этого используйте Transformer.start(MediaItem, String) .
- Удалите устаревшую SingleFrameGlShaderProgram . Вместо этого используйте BaseGlShaderProgram .
- Удалите Transformer.flattenForSlowMotion . Вместо этого используйте EditedMediaItem.flattenForSlowMotion .

Версия 1.5

Версия 1.5.1

19 декабря 2024 г.

Выпущен androidx.media3:media3-*:1.5.1 . Версия 1.5.1 содержит эти коммиты .

Экзоплеер:
- Отключите использование асинхронного дешифрования в MediaCodec, чтобы избежать сообщений о проблемах с тайм-аутом кодека с этим API платформы ( #1641 ).
Экстракторы:
- MP3: не останавливать воспроизведение раньше времени, если таблица содержания кадра VBRI не охватывает все данные MP3 в файле ( #1904 ).
Видео:
- Откат использования значений соотношения сторон пикселей, предоставленных MediaCodecAdapter , если они были предоставлены во время обработки onOutputFormatChanged ( #1371 ).
Текст:
- Исправлена ошибка в ReplacingCuesResolver.discardCuesBeforeTimeUs , из-за которой сигнал, активный в timeUs (начавшийся раньше, но еще не закончившийся), был неправильно отброшен ( #1939 ).
Метаданные:
- Извлеките номер диска/трека и жанр из комментариев Vorbis в MediaMetadata ( #1958 ).

Версия 1.5.0

27 ноября 2024 г.

Выпущен androidx.media3:media3-*:1.5.0 . Версия 1.5.0 содержит эти коммиты .

Общая библиотека:
- Добавьте ForwardingSimpleBasePlayer , который позволяет пересылать другому проигрывателю с небольшими корректировками, обеспечивая при этом полную согласованность и обработку прослушивателя ( #1183 ).
- Замените SimpleBasePlayer.State.playlist методом getPlaylist() .
- Добавьте переопределение для SimpleBasePlayer.State.Builder.setPlaylist() чтобы напрямую указывать Timeline , текущие Tracks и Metadata вместо построения структуры списка воспроизведения.
- Увеличьте minSdk до 21 (Android Lollipop). Это соответствует всем другим библиотекам AndroidX.
- Добавьте артефакт androidx.media3:media3-common-ktx , который обеспечивает специфичные для Kotlin функции, построенные на основе библиотеки Common.
- Добавьте функцию расширения приостановки Player.listen для запуска сопрограммы для прослушивания Player.Events в библиотеку media3-common-ktx .
- Удалите аннотации @DoNotInline из внутренних классов, выведенных вручную, чтобы избежать сбоев проверки классов во время выполнения . Последние версии R8 теперь автоматически выполняют внеочередные вызовы, подобные этим, чтобы избежать сбоев во время выполнения (поэтому ручное внеочередное выполнение больше не требуется). Все пользователи библиотеки Gradle уже должны использовать версию плагина Android Gradle, которая использует версию R8, которая делает это, из-за compileSdk = 35 . Пользователям библиотеки с системами сборки, отличными от Gradle, необходимо убедиться, что их этап сжатия/запутывания, эквивалентный R8, выполняет аналогичный автоматический внеочередной процесс, чтобы избежать сбоев проверки класса во время выполнения. Это изменение уже было сделано в других библиотеках AndroidX .
Экзоплеер:
- MediaCodecRenderer.onProcessedStreamChange() теперь можно вызывать для каждого элемента мультимедиа. Раньше его не вызывали в первый раз. Используйте MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() чтобы включить это.
- Добавьте PreloadMediaSource.PreloadControl.onPreloadError , чтобы позволить реализациям PreloadMediaSource.PreloadControl предпринимать действия при возникновении ошибки.
- Добавьте BasePreloadManager.Listener для распространения событий предварительной загрузки в приложения.
- Разрешить изменение тайм-аута клиента SNTP и повторить попытку альтернативных адресов по тайм-ауту ( #1540 ).
- Удалите MediaCodecAdapter.Configuration.flags поскольку поле всегда было нулевым.
- Разрешить пользователю выбирать встроенный динамик для воспроизведения в Wear OS API 35+ (где устройство рекламирует такую поддержку).
- Отложите блокирующий вызов Context.getSystemService(Context.AUDIO_SERVICE) до тех пор, пока не будет включена обработка фокуса звука. Это гарантирует, что блокирующий вызов не будет выполнен, если обработка аудиофокуса не включена ( #1616 ).
- Разрешить воспроизведение независимо от продолжительности буферизации при сбое загрузки ( #1571 ).
- Добавьте AnalyticsListener.onRendererReadyChanged() чтобы сигнализировать, когда отдельные средства визуализации разрешают воспроизведение быть готовым.
- Исправлена ошибка, из-за которой MediaCodec.CryptoException иногда сообщался как «неожиданная ошибка времени выполнения», когда MediaCodec работает в асинхронном режиме (поведение по умолчанию для API 31+).
- Передайте bufferedDurationUs вместо bufferedPositionUs с помощью PreloadMediaSource.PreloadControl.onContinueLoadingRequested() . Также изменяется DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS на DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS , затем приложениям необходимо передать значение, представляющее определенную длительность из начальной позиции по умолчанию, для которой соответствующий источник мультимедиа должен быть предварительно загружен с этим IntDef вместо позиции.
- Добавьте реализацию ForwardingRenderer , которая пересылает все вызовы методов другому средству визуализации ( 1703 ).
- Добавьте предварительную загрузку плейлиста для следующего элемента в плейлисте. Приложения могут включить предварительную загрузку, вызвав ExoPlayer.setPreloadConfiguration(PreloadConfiguration) соответствующим образом. По умолчанию предварительная загрузка отключена. Если этот параметр включен и не мешает воспроизведению, DefaultLoadControl ограничивает предварительную загрузку запуском и продолжением только тогда, когда проигрыватель не загружается для воспроизведения. Приложения могут изменить это поведение, соответствующим образом реализовав LoadControl.shouldContinuePreloading() (например, при переопределении этого метода в DefaultLoadControl ). Реализация LoadControl по умолчанию отключает предварительную загрузку, если приложение использует пользовательскую реализацию LoadControl .
- Добавьте метод MediaSourceEventListener.EventDispatcher.dispatchEvent() чтобы разрешить вызов событий прослушивателей подкласса ( 1736 ).
- Добавьте DefaultPreloadManager.Builder , который создает экземпляры DefaultPreloadManager и ExoPlayer с единообразными общими конфигурациями.
- Удалите параметр Renderer[] из LoadControl.onTracksSelected() поскольку реализация DefaultLoadControl может получать типы потоков из ExoTrackSelection[] .
- Устаревший DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) и метод помечен как окончательный, чтобы предотвратить переопределения. Вместо этого следует использовать новый DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) .
- Сообщайте о событиях MediaSourceEventListener из вторичных источников в MergingMediaSource . Это приведет к тому, что для загруженных неопубликованных субтитров будут сообщаться о событиях начала/ошибки/отмены/завершения загрузки (добавленных с помощью MediaItem.LocalConfiguration.subtitleConfigurations ), которые могут отображаться как повторяющиеся события загрузки, исходящие из AnalyticsListener .
- Предотвратите ошибки субтитров и метаданных, приводящие к полной остановке воспроизведения. Вместо этого проблемный трек отключается, а воспроизведение оставшихся треков продолжается ( #1722 ).
  - При обработке новых субтитров (во время извлечения) связанные ошибки анализа (например, неверные данные субтитров) и загрузки (например, HTTP 404) выдаются через обратные вызовы onLoadError .
  - При устаревшей обработке субтитров (во время рендеринга) через обратные вызовы onLoadError выдаются только связанные ошибки загрузки, а ошибки синтаксического анализа молча игнорируются (это уже существующее поведение).
- Исправлена ошибка, из-за которой элементы или периоды плейлиста в многопериодных потоках DASH с длительностью, не соответствующей фактическому содержимому, могли вызывать зависание кадра в конце элемента ( #1698 ).
- Добавьте установщик в SntpClient чтобы установить максимальное время, прошедшее с момента последнего обновления, после которого клиент повторно инициализируется ( #1794 ).
Трансформатор:
- Добавьте SurfaceAssetLoader , который поддерживает постановку видеоданных в очередь в Transformer через Surface .
- ImageAssetLoader сообщает о неподдерживаемых входных данных через AssetLoader.onError вместо того, чтобы выдавать исключение IllegalStateException .
- Сделайте настройку продолжительности изображения с помощью MediaItem.Builder.setImageDurationMs обязательной для экспорта изображения.
- Добавлена поддержка экспорта пробелов в последовательностях аудио EditedMediaItems.
Выбор трека:
- DefaultTrackSelector : Предпочитайте объектно-ориентированное аудио аудио, а не канальное, при прочих равных условиях.
Экстракторы:
- Разрешить Mp4Extractor и FragmentedMp4Extractor идентифицировать образцы H264, которые не используются в качестве эталона в последующих образцах.
- Добавьте опцию, позволяющую включить поиск по индексу в AmrExtractor .
- Считайте файлы MP3 размером более 128 КБ между допустимыми кадрами усеченными (а не недействительными). Это означает, что файлы с данными, отличными от MP3 в конце, без других метаданных, указывающих длину байтов MP3, теперь прекращают воспроизведение в конце данных MP3, а не с ошибкой ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} ( #1563 ).
- Исправлена обработка образцов в начале ролика для начальных позиций мультимедиа, не являющихся ключевыми кадрами, при обработке списков редактирования в файлах MP4 ( #1659 ).
- Улучшен расчет частоты кадров с использованием продолжительности мультимедиа из поля mdhd в Mp4Extractor и FragmentedMp4Extractor ( #1531 ).
- Исправлено неправильное масштабирование media_time в списках редактирования MP4. Хотя segment_duration уже был правильно масштабирован с использованием шкалы времени фильма, media_time теперь правильно масштабируется с использованием шкалы времени дорожки, как указано в стандарте формата MP4 ( #1792 ).
- Обработка неупорядоченных кадров при расчете endIndices для MP4 с помощью списка редактирования ( #1797 ).
- Исправлен анализ продолжительности мультимедиа в поле mdhd файлов MP4 для обработки значений -1 ( #1819 ).
- Добавлена поддержка идентификации поля h263 в файлах MP4 для видео H.263 ( #1821 ).
- Добавлена поддержка базового формата медиафайлов ISO AC-4 Level-4 ( #1265 ).
Источник данных:
- Обновите HttpEngineDataSource , чтобы разрешить использование начиная с расширения версии S 7 вместо уровня API 34 ( #1262 ).
- DataSourceContractTest : утверждает, что DataSource.getUri() возвращает разрешенный URI (как описано). Если он отличается от запрошенного URI, тесты могут указать это с помощью нового метода DataSourceContractTest.TestResource.Builder.setResolvedUri() .
- DataSourceContractTest : утверждает, что DataSource.getUri() и getResponseHeaders() возвращают свое значение «open» после неудачного вызова open() (из-за «не найденного» ресурса) и перед последующим вызовом close() .
  - Переопределение DataSourceContractTest.getNotFoundResources() позволяет тестовым подклассам предоставлять несколько «не найденных» ресурсов, а также предоставлять любые ожидаемые заголовки. Это позволяет различать HTTP 404 (с заголовками) и «сервер не найден» (без заголовков).
Аудио:
- Автоматически настраивайте метаданные громкости CTA-2075 в кодеке, если они присутствуют на носителе.
- Обеспечьте плавное снижение громкости при поиске.
- Исправлены поп-звуки, которые могли возникнуть во время поиска.
- Исправлено накопление ошибок усечения для алгоритма растяжения времени/сдвига тона Соника.
- Исправлена ошибка в SpeedChangingAudioProcessor , приводившая к потере выходных кадров.
Видео:
- MediaCodecVideoRenderer избегает декодирования образцов, которые не обрабатываются и не используются в качестве ссылки другими образцами.
- В API 35 и более поздних версиях MediaCodecAdapter теперь может получать null Surface в configure и вызывать новый метод detachOutputSurface для удаления ранее установленной Surface если кодек поддерживает это ( MediaCodecInfo.detachedSurfaceSupported ).
- Используйте значения соотношения сторон пикселей, предоставленные MediaCodecAdapter , если они предоставлены при обработке onOutputFormatChanged ( #1371 ).
- Добавьте обходной путь для проблемы с устройством на Galaxy Tab S7 FE, из-за которой защищенные потоки H264 со скоростью 60 кадров в секунду помечаются как неподдерживаемые ( #1619 ).
- Добавьте обходной путь для кодеков, которые зависают после последней выборки, не возвращая сигнал конца потока.
Текст:
- Добавьте собственный VoiceSpan и заполните его для голосовых диапазонов WebVTT ( #1632 ).
- Убедитесь, что отображаются WebVTT в HLS с очень большими временными метками субтитров (которые превышают 64-битную long , если представлены в виде микросекунд и умножены на временную развертку 90,000 MPEG) ( #1763 ).
- Поддержка субтитров CEA-608 в контенте Dolby Vision ( #1820 ).
- Исправлено зависание воспроизведения в многопериодных потоках DASH при включенных субтитрах CEA-608 ( #1863 ).
Метаданные:
- Назначьте тип C.TRACK_TYPE_METADATA трекам, содержащим ледяной контент или контент vnd.dvb.ait.
Изображение:
- Добавьте ExternallyLoadedImageDecoder для упрощенной интеграции с внешними библиотеками загрузки изображений, такими как Glide или Coil.
Источник данных:
- Добавьте FileDescriptorDataSource — новый DataSource , который можно использовать для чтения из FileDescriptor ( #3757 ).
Эффект:
- Добавьте обходной путь DefaultVideoFrameProcessor для незначительного масштабирования SurfaceTexture . SurfaceTexture может включать в себя небольшое масштабирование, которое обрезает границу размером в 1 тексель по краю обрезанного буфера. Теперь это обрабатывается таким образом, чтобы результат был ближе к ожидаемому.
- Ускорьте DefaultVideoFrameProcessor.queueInputBitmap() . В результате экспорт изображений в видео с помощью Transformer выполняется быстрее.
Расширение IMA:
- Исправлена ошибка, из-за которой очистка списка воспроизведения могла вызвать исключение ArrayIndexOutOfBoundsException в ImaServerSideAdInsertionMediaSource .
- Исправлена ошибка, из-за которой вставленные на стороне сервера потоки DAI без предварительной прокрутки могли привести к исключению ArrayIndexOutOfBoundsException при воспроизведении после последней середины ролика ( #1741 ).
Сессия:
- Добавьте MediaButtonReceiver.shouldStartForegroundService(Intent) чтобы приложения могли подавлять команду воспроизведения, поступающую для возобновления воспроизведения, путем переопределения этого метода. По умолчанию служба запускается всегда, и воспроизведение невозможно остановить, если система не приведет к сбою службы с помощью исключения ForegroundServiceDidNotStartInTimeException ( #1528 ).
- Исправлена ошибка, из-за которой пользовательские команды, отправленные из MediaBrowser отправлялись в MediaSessionCompat.Callback вместо варианта метода MediaBrowserServiceCompat при подключении к устаревшей службе. Это не позволило MediaBrowser получить фактическое возвращаемое значение, отправленное устаревшей службой ( #1474 ).
- Обработка исключения IllegalArgumentException выдаваемого устройствами некоторых производителей при настройке приемника вещания для назначения мультимедийной кнопки ( #1730 ).
- Добавьте кнопки управления для медиа-элементов. Это добавляет API Media3 для так называемых Custom browse actions с устаревшей библиотекой MediaBrowserCompat . Обратите внимание, что в Media3 командные кнопки для медиа-элементов доступны как для MediaBrowser , так и MediaController . См. Пользовательские действия просмотра AAOS .
- Исправлена ошибка, из-за которой контроллер Media3 иногда не мог позволить приложению сеанса запустить службу переднего плана после запроса play() .
- Ограничьте CommandButton.Builder.setIconUri принимать только Uris содержимого.
- Передавайте подсказки о подключении браузера Media3 в исходный MediaBrowserCompat при подключении к устаревшему MediaBrowserCompat . Служба может получать подсказки о подключении, переданные как корневые подсказки, при первом вызове onGetRoot() .
- Исправлена ошибка, из-за которой MediaBrowser подключенный к устаревшей службе браузера, не получал сообщение об ошибке, отправленное службой после того, как браузер подписался на parentid .
- Улучшите поведение совместимости, чтобы браузер Media3, подключенный к устаревшей MediaBrowserService не запрашивал дочерние parentId дважды при подписке на родительский.
Пользовательский интерфейс:
- Сделайте растянутое/обрезанное видео в PlayerView -in-Compose- AndroidView обходным решением из-за проблем с общими переходами на основе XML. Приложениям, использующим PlayerView внутри AndroidView необходимо вызвать PlayerView.setEnableComposeSurfaceSyncWorkaround , чтобы согласиться ( #1237 , #1594 ).
- Добавьте setFullscreenButtonState в PlayerView чтобы разрешить обновление значка полноэкранной кнопки по требованию, т. е. вне диапазона, а не в ответ на нажатие кнопки ( #1590 , #184 ).
- Исправлена ошибка, из-за которой выбор «Нет» при выделении текста не работал, если существуют определенные приложением настройки выбора текстовой дорожки.
Расширение DASH:
- Добавьте поддержку периодов, начинающихся с середины сегмента ( #1440 ).
Расширение плавной потоковой передачи:
- Исправлено Bad magic number for Bundle при воспроизведении потоков SmoothStreaming с текстовыми дорожками ( #1779 ).
Расширение RTSP:
- Исправлено удаление информации о пользователе для URL-адресов, содержащих закодированные символы @ ( #1138 ).
- Исправлен сбой при анализе пакетов RTP с расширениями заголовков ( #1225 ).
Расширения декодера (FFmpeg, VP9, AV1 и т. д.):
- Добавьте модуль декодера IAMF, который обеспечивает поддержку воспроизведения файлов MP4, содержащих треки IAMF, с использованием собственной библиотеки libiamf для синтеза звука.
  - Воспроизведение включено в стерео раскладке, а также в формате 5.1 с пространственным разделением и включенным дополнительным отслеживанием головы, но поддержка бинаурального воспроизведения в настоящее время недоступна.
- Добавьте поддержку страниц размером 16 КБ для расширений декодера на Android 15 ( #1685 ).
Расширение актерского состава:
- Прекратите очистку временной шкалы после отключения CastSession, что позволит приложению-отправителю возобновить воспроизведение локально после отключения.
- Заполните DeviceInfo CastPlayer, когда предоставлен Context . Это позволяет связать MediaSession с RoutingSession , что необходимо для интеграции переключателя вывода ( #1056 ).
Тестовые утилиты:
- DataSourceContractTest теперь включает тесты для проверки:
  - read position входного потока обновляется.
  - offset выходного буфера применяется правильно.
Демо-приложение
- Устраните утечки памяти в коротком демонстрационном приложении ( #1839 ).
Удалите устаревшие символы:
- Удалите устаревшие Player.hasPrevious , Player.hasPreviousWindow() . Вместо этого используйте Player.hasPreviousMediaItem() .
- Удалите устаревший метод Player.previous() . Вместо этого используйте Player.seekToPreviousMediaItem() .
- Удалите устаревший метод DrmSessionEventListener.onDrmSessionAcquired .
- Удалите устаревшие конструкторы DefaultEncoderFactory . Вместо этого используйте DefaultEncoderFactory.Builder .

Версия 1.5.0-rc02

19 ноября 2024 г.

Используйте стабильную версию 1.5.0.

Версия 1.5.0-rc01

13 ноября 2024 г.

Используйте стабильную версию 1.5.0.

Версия 1.5.0-бета01

30 октября 2024 г.

Используйте стабильную версию 1.5.0.

Версия 1.5.0-альфа01

10 сентября 2024 г.

Используйте стабильную версию 1.5.0.

Версия 1.4.0

Версия 1.4.1

27 августа 2024 г.

Выпущен androidx.media3:media3-*:1.4.1 . Версия 1.4.1 содержит эти коммиты .

Экзоплеер:
- Асинхронно обрабатывайте обратные вызовы предварительной загрузки в PreloadMediaSource ( #1568 ).
- Разрешить воспроизведение независимо от длительности буферизации при сбое загрузки ( #1571 ).
Экстракторы:
- MP3: исправлена ошибка Searched too many bytes путем правильного игнорирования конечных данных, не относящихся к MP3, на основе поля длины в Info кадре ( #1480 ).
Текст:
- TTML: исправлена обработка процентных значений tts:fontSize , чтобы гарантировать, что они правильно наследуются от родительских узлов с процентными значениями tts:fontSize .
- Исправьте исключение IndexOutOfBoundsException в LegacySubtitleUtil из-за неправильной обработки случая, когда запрошенное время начала вывода больше или равно времени конечного события в Subtitle ( #1516 ).
УПРАВЛЕНИЕ ДРМ:
- Исправьте android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE на устройствах API 31+, воспроизводящих контент L1 Widevine. Эта ошибка вызвана неполной реализацией метода MediaDrm.requiresSecureDecoder платформы ( #1603 ).
Эффект:
- Добавьте метод release() в GlObjectsProvider .
Сессия:
- Преобразуйте двойное нажатие KEYCODE_HEADSETHOOK в действие «перейти к следующему», как описано ( #1493 ).
- Обрабатывайте KEYCODE_HEADSETHOOK как команду воспроизведения в MediaButtonReceiver решая, игнорировать ли ее, чтобы избежать исключения ForegroundServiceDidNotStartInTimeException ( #1581 ).
Расширение RTSP:
- Пропустить недопустимые описания носителей при анализе SDP ( #1087 ).

Версия 1.4.0

25 июля 2024 г.

Выпущен androidx.media3:media3-*:1.4.0 . Версия 1.4.0 содержит эти коммиты .

Общая библиотека:
- Пересылать предполагаемые неактивные вызовы поиска к защищенным методам BasePlayer.seekTo() и SimpleBasePlayer.handleSeek() вместо их игнорирования. Если вы реализуете эти методы в пользовательском проигрывателе, вам может потребоваться обработать эти дополнительные вызовы с помощью mediaItemIndex == C.INDEX_UNSET .
- Удалите зависимость компиляции при улучшенной очистке Java 8 ( #1312 ).
- Убедитесь, что продолжительность, передаваемая в MediaItem.Builder.setImageDurationMs() игнорируется для MediaItem не являющегося изображением (как описано в документации).
- Добавьте Format.customData для хранения предоставленной приложением пользовательской информации об экземплярах Format .
Экзоплеер:
- Добавьте BasePreloadManager , который координирует предварительную загрузку для нескольких источников на основе приоритетов, определенных их rankingData . Настройка возможна путем расширения этого класса. Добавьте DefaultPreloadManager , который использует PreloadMediaSource для предварительной загрузки образцов мультимедиа источников в память и использует целочисленное rankingData , которое указывает индекс элемента в пользовательском интерфейсе.
- Добавьте PlayerId к большинству методов LoadControl , чтобы реализации LoadControl могли поддерживать несколько игроков.
- Удалите Buffer.isDecodeOnly() и C.BUFFER_FLAG_DECODE_ONLY . Нет необходимости устанавливать этот флаг, поскольку средства рендеринга и декодеры решат пропустить буферы на основе метки времени. Реализации пользовательских Renderer должны проверять, равно ли время буфера хотя бы BaseRenderer.getLastResetPositionUs() чтобы решить, следует ли отображать образец. Пользовательские реализации SimpleDecoder могут при необходимости проверять isAtLeastOutputStartTimeUs() или помечать другие буферы с помощью DecoderOutputBuffer.shouldBeSkipped , чтобы пропустить их.
- Разрешить возврат значения null с помощью TargetPreloadStatusControl.getTargetPreloadStatus(T) чтобы указать, что не следует предварительно загружать MediaSource с заданным rankingData .
- Добавьте remove(MediaSource) в BasePreloadManager .
- Добавьте reset() в BasePreloadManager чтобы освободить все источники удержания, сохранив при этом экземпляр менеджера предварительной загрузки.
- Добавьте ExoPlayer.setPriority() (и Builder.setPriority() ), чтобы определить значение приоритета, используемое в PriorityTaskManager , и для важности MediaCodec из API 35.
- Исправлена проблема с обновлением времени последней повторной буферизации, которая приводила к неправильному ключу bs (нехватка буфера) в CMCD ( #1124 ).
- Добавьте PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) чтобы указать, что источник загрузился до конца. Это позволяет DefaultPreloadManager и пользовательским реализациям PreloadMediaSource.PreloadControl предварительно загружать следующий источник или выполнять другие действия.
- Исправлена ошибка, из-за которой пропуск тишины в конце элементов мог вызвать исключение воспроизведения.
- Добавьте clear в PreloadMediaSource чтобы отменить период предварительной загрузки.
- Добавьте новый код ошибки PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED , который используется, когда ресурсы кодека освобождаются для задач с более высоким приоритетом.
- Разрешите AdsMediaSource загружать рекламу в начале ролика до завершения первоначальной подготовки носителя контента ( #1358 ).
- Исправлена ошибка, из-за которой воспроизведение переходило на STATE_ENDED при повторной подготовке многопериодного прямого эфира DASH после того, как исходный период уже был удален из манифеста.
- Переименуйте onTimelineRefreshed() в onSourcePrepared() и onPrepared() в onTracksSelected() в PreloadMediaSource.PreloadControl . Также переименуйте IntDefs в DefaultPreloadManager.Stage соответствующим образом.
- Добавьте экспериментальную поддержку динамического планирования, чтобы лучше согласовать работу с циклами пробуждения ЦП и задержать пробуждение до того момента, когда средства рендеринга смогут продолжить работу. Вы можете включить это с помощью experimentalSetDynamicSchedulingEnabled() при настройке экземпляра ExoPlayer.
- Добавьте Renderer.getDurationToProgressUs() . Renderer может реализовать этот метод, чтобы возвращать ExoPlayer продолжительность, на которую воспроизведение должно продвинуться, чтобы средство рендеринга могло продолжить работу. Если ExoPlayer установлен с помощью experimentalSetDynamicSchedulingEnabled() то ExoPlayer вызовет этот метод при расчете времени для планирования своей рабочей задачи.
- Добавьте MediaCodecAdapter#OnBufferAvailableListener для оповещения, когда буферы ввода и вывода доступны для использования MediaCodecRenderer . MediaCodecRenderer будет сигнализировать ExoPlayer при получении этих обратных вызовов, и если ExoPlayer установлен с помощью experimentalSetDynamicSchedulingEnabled() , тогда ExoPlayer запланирует свой рабочий цикл по мере того, как средства рендеринга могут продвигаться вперед.
- Используйте класс данных для методов LoadControl вместо отдельных параметров.
- Добавьте ExoPlayer.isReleased() , чтобы проверить, был ли вызван Exoplayer.release() .
- Добавьте ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() , чтобы настроить максимальную позицию, для которой seekToPrevious() ищет предыдущий элемент ( #1425 ).
- Исправлены некоторые несоответствия фокуса звука, например отсутствие сообщения о полной или временной потере фокуса, когда проигрыватель находится на паузе ( #1436 ).
- Исправлено потенциальное исключение IndexOutOfBoundsException вызванное тем, что экстракторы сообщали о дополнительных треках после начального этапа подготовки ( #1476 ).
- Effects в ExoPlayer.setVideoEffect() получат временные метки с удаленным смещением рендеринга ( #1098 ).
- Исправлено потенциальное исключение IllegalArgumentException при обработке ошибки проигрывателя, возникшей при чтении вперед в другой элемент списка воспроизведения ( #1483 ).
Трансформатор:
- Добавьте audioConversionProcess и videoConversionProcess в ExportResult указывая, как была создана соответствующая дорожка в выходном файле.
- Расслабляющая оптимизация, проверка уровня H.264.
- Добавьте поддержку последовательного переключения между входными носителями SDR и HDR.
- Добавьте поддержку звуковых эффектов на уровне композиции.
- Добавьте поддержку перекодирования изображений Ultra HDR в видео HDR.
- Исправлена проблема, из-за которой DefaultAudioMixer не выводит правильное количество байтов после сброса и повторного использования.
- Работайте по ошибке декодера, где количество аудиоканалов было ограничено стереоподобным при обработке ввода PCM.
- При выборе треков в ExoPlayerAssetLoader игнорируйте ограничения подсчета аудиоканалов, поскольку они применяются только для воспроизведения.
- Замените androidx.media3.transformer.Muxer интерфейс с androidx.media3.muxer.Muxer и удалить androidx.media3.transformer.Muxer .
- Исправить загрузку изображения HEIC из схем URI Content. ( #1373 ).
- Отрегулируйте продолжительность аудиотегии в AudioGraphInput чтобы улучшить синхронизацию AV.
- Удалить ExportResult.processedInputs Field. Если вы используете это поле для деталей кодека, то используйте вместо этого DefaultDecoderFactory.listener . В случае исключения кодека подробности кодека будут доступны в ExportException.codecInfo .
Экстракторы:
- MPEG-TS: Сверните изменение, гарантируя, что последний кадр отображается путем передачи последнего блока доступа потока в очередь образца ( #7909 ). Включая исправления для решения проблем, возникших в потоках I-Frame Only HLS ( #1150 ) и H.262 HLS-потоках ( #1126 ).
- MP3: предпочитают размер данных из Info кадры по размеру, сообщаемому базовым потоком (например, размер файла или заголовок HTTP Content-Length ). Это помогает исключить неиспользуемые данные трейлера (например, произведения об альбоме) из постоянных расчетов в поисках битрейтов, делая поиск более точными ( #1376 ).
- Mp3: используйте количество кадров и другие данные в Info кадре (если присутствует), чтобы вычислить средний битрейт для постоянного поиска битрейта, а не экстраполяции из битрейта кадра после Info кадра, которая может быть искусственно небольшим, например, кадр PCUT ( #1376 ).
- Исправьте извлечение аудио формата PCM в контейнерах AVI.
Аудио:
- Исправить DTS: x Профиль 2 Атрибуты кодирования для воспроизведения PassThrough ( #1299 ).
- Для разгруженного воспроизведения сбросьте поле отслеживания для завершения потока в DefaultAudioSink до вызова AudioTrack.stop() , чтобы AudioTrack.StreamEventCallback#onPresentationEnded Правильно идентифицируется, когда были разыгрываются все ожидающие данные.
- Исправить ошибку в SilenceSkippingAudioProcessor , где переходы между различными аудиоформатами (например, стерео -моно) могут привести к тому, что процессор может вывести исключение ( #1352 ).
- Реализовать MediaCodecAudioRenderer.getDurationToProgressUs() , чтобы Exoplayer динамически запланировал свой основной рабочий цикл, когда MediaCodeCaudiorenderer может добиться прогресса.
Видео:
- Исправить проблему, где Listener.onRenderedFirstFrame() прибывает слишком рано при переключении поверхностей в середине игры.
- Исправьте логику резервного декодера для Dolby Vision, чтобы использовать совместимый декодер AV1, если это необходимо ( #1389 ).
- Исправлена исключение кодека, которое может быть вызвано включением видео-визуализатора в середине воспроизведения.
Текст:
- Исправьте проблему, в которой субтитры, начинающиеся перед пропущенной позицией. Эта проблема была представлена только в Media3 1.4.0-Alpha01.
- Изменить поведение подзаголовок по умолчанию, так что это происходит во время извлечения, а не во время рендеринга (см. Архитектурную диаграмму Exoplayer для разницы между экстракцией и рендерингом).
  - Это изменение может быть переопределено, вызывая обоих MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) и TextRenderer.experimentalSetLegacyDecodingEnabled(true) . См. Документы об настройке для того, как превратить эти компоненты в ExoPlayer . Эти методы (и вся поддержка унаследованного декодирования субтитров) будут удалены в будущем выпуске.
  - Приложения с пользовательскими реализациями SubtitleDecoder должны вместо этого обновить их для реализации SubtitleParser (и SubtitleParser.Factory вместо SubtitleDecoderFactory ).
- PGS: Исправьте декодирование длины прогона, чтобы разрешить 0 в виде индекса цвета вместо буквального значения цвета ( #1367 ).
- CEA-708: игнорировать значение rowLock . Спецификация CEA-708-E S-2023 гласит, что rowLock и columnLock должны быть считаются истинными, независимо от значений, присутствующих в потоке (поддержка columnLock не реализована, поэтому предполагается, что она всегда должна быть ложной).
  - Первоначально это было включено в заметки о выпуске 1.3.0-alpha01 , но изменение было случайно возвращено перед выпуском 1.3.0-rc01 . Теперь это исправлено, поэтому изменение снова присутствует.
- CEA-708: Избегайте дублирующих новичков, добавленных путем наивного обращения с Exoplayer команды «установленное местоположение ручки» ( #1315 ).
- Исправьте IllegalArgumentException из LegacySubtitleUtil , когда образец субтитров WebVTT не содержит сигналов, например, как часть потока приборной панели ( #1516 ).
Метаданные:
- Исправлена картирование тегов MP4 с id3. Ранее «Sort» ( soal ), «SOAL Sort» ( soar ) и «Sort Artist Artist» ( soaa ) MP4 были неправильно отображены с тегами TSO2 , TSOA и TSOP ID3 ( #1302 ).
- Исправьте чтение меток MP4 (/iTunes) числовых gnre (жанр) и tmpo (темп), когда значение длится более одного байта.
- Распространить ID3 TCON FRAME в MediaMetadata.genre ( #1305 ).
Изображение:
- Добавьте поддержку для сети с не-квадратными сетками Dash Dash ( #1300 ).
- Добавьте поддержку для AVIF для API 34+.
- Разрешить null в качестве параметра для ExoPlayer.setImageOutput() для очистки ранее установленного ImageOutput .
DataSource:
- Реализуйте поддержку для android.resource://package/id RAVE Rourcse URI, где package отличается от пакета текущего приложения. Ранее это не было задокументировано для работы, но является более эффективным способом доступа к ресурсам в другом пакете, чем по имени.
- Обоснованно проверяет url -адрес в конструкторах DataSpec . Этот параметр уже был аннотирован как не нулевый.
- Позвольте ByteArrayDataSource разрешить URI на байт-массив во время open() , вместо того, чтобы быть жестким кодированием на строительстве ( #1405 ).
DRM:
- Разрешить установить LoadErrorHandlingPolicy на DefaultDrmSessionManagerProvider ( #1271 ).
Эффект:
- Поддержите множественные изменения скорости в одном и том же EditedMediaItem или Composition в SpeedChangeEffect .
- Поддержка выхода HLG и PQ с входа Ultra HDR Bitmap.
- Добавьте поддержку EGL_GL_COLORSPACE_BT2020_HLG_EXT, который улучшает вывод поверхности HLG в Exoplayer.SetVideoeFect и отладчике Transformer SurfaceView.
- Обновите реализацию Matrix Opplay, чтобы сделать ее в соответствии с документацией путем переворачивания значений x и y, применяемых в setOverlayFrameAnchor() . При использовании OverlaySettings.Builder.setOverlayFrameAnchor() , переверните их значения x и y, умножая их на -1 .
- Исправьте ошибку, где TimestampWrapper сбои при использовании с ExoPlayer#setVideoEffects ( #821 ).
- Измените по умолчанию рабочее пространство SDR от линейных цветов на электрическое видео BT 709 SDR. Также предоставьте третий вариант, чтобы сохранить исходное пространство для цветов.
- Разрешить определение неопределенного Z-порядка отредактированных последовательности ( #1055 ).
- Поддерживайте постоянный диапазон яркости на разных частях содержания HDR (использует диапазон HLG).
- Добавьте поддержку наложений Ultra HDR (растрового карты) на содержание HDR.
- Разрешить использование эффектов SeparableConvolution до API 26.
- Удалить неиспользованные OverlaySettings.useHdr .
- Добавьте HDR поддержку TextOverlay . Яркости текстового наложения может быть отрегулирована с помощью OverlaySettings.Builder.setHdrLuminanceMultiplier() .
Расширение IMA:
- Продвигайте API, который необходим для приложений, чтобы воспроизводить Dai Ad Streams для стабильных.
- Добавьте replaceAdTagParameters(Map <String, String>) в ImaServerSideAdInsertionMediaSource.AdLoader , который позволяет заменить параметры тега AD во время выполнения.
- Исправить ошибку, где VideoAdPlayer.VideoAdPlayerCallback.onError() не вызвали, когда ошибка игрока произошла во время воспроизведения рекламы ( #1334 ).
- Версию IMA SDK до 3.33.0, чтобы исправить NullPointerException при использовании data:// AD TAG URIS ( #700 ).
Сессия:
- Изменить дефолт на CommandButton.enabled на true и убедитесь, что значение может оставаться ложным для контроллеров, даже если соответствующая команда доступна.
- Добавьте константы значков для CommandButton , которые следует использовать вместо пользовательских ресурсов значков.
- Добавьте MediaSessionService.isPlaybackOngoing() , чтобы позволить приложениям запросить, необходимо ли услугу быть остановленной в onTaskRemoved() ( #1219 ).
- Добавить MediaSessionService.pauseAllPlayersAndStopSelf() , который удобно позволяет приостановить воспроизведение всех сессий и вызовать stopSelf() , чтобы завершить жизненный цикл MediaSessionService .
- Переопределить MediaSessionService.onTaskRemoved(Intent) для обеспечения безопасной реализации по умолчанию, которая поддерживает работу обслуживания на переднем плане, если воспроизведение продолжается или останавливает услугу в противном случае.
- Скрыть Seekbar в уведомлении о медиа для живых потоков, не установив продолжительность в метаданные сессии платформы ( #1256 ).
- Совместите преобразование MediaMetadata в MediaDescriptionCompat , чтобы использовать тот же предпочтительный порядок и логику при выборе свойств метаданных, что и в Media1.
- Добавить MediaSession.sendError() , который позволяет отправлять нефильные ошибки в контроллер Media3. При использовании контроллера уведомлений (см. MediaSession.getMediaNotificationControllerInfo() ), пользовательская ошибка используется для обновления PlaybackState сеанса платформы до состояния ошибки с данной информацией об ошибке ( #543 ).
- Добавить MediaSession.Callback.onPlayerInteractionFinished() чтобы информировать сеансы, когда серия взаимодействий игроков от конкретного контроллера закончена.
- Добавьте SessionError и используйте его в SessionResult и LibraryResult вместо кода ошибки, чтобы предоставить больше информации об ошибке и о том, как это возможно, если это возможно.
- Опубликуйте код для приложения Test Controller Media3, которое можно использовать для тестирования взаимодействий с приложениями, публикующими сеанс медиа.
- Пропаганные дополнения передаются в Media3 MediaSession[Builder].setSessionExtras() в Media1 Controller's PlaybackStateCompat.getExtras() .
- Нанесите на карту смертельные и нерадостные ошибки в сеанс платформы и обратно. PlaybackException нанесено на карту с фатальной ошибкой состояния PlaybackStateCompat . SessionError отправленный контроллеру уведомлений о носителях с помощью MediaSession.sendError(ControllerInfo, SessionError) , отображается с неэтажной ошибкой в PlaybackStateCompat , что означает, что код ошибки и сообщения устанавливаются, но состояние сеанса платформы остается отличным от STATE_ERROR .
- Позвольте установке активности сеанса для переопределения активности глобального сеанса. Сессионная деятельность может быть определена для контроллера во время подключения, создав ConnectionResult с AcceptedResultBuilder.setSessionActivivty(PendingIntent) . После подключения активность сеанса может быть обновлена с помощью MediaSession.setSessionActivity(ControllerInfo, PendingIntent) .
- Улучшение репликации ошибок вызовов в MediaLibrarySession.Callback . Репликация ошибки теперь может быть настроена с помощью MediaLibrarySession.Builder.setLibraryErrorReplicationMode() для выбора типа ошибки или выхода из репликации ошибки, которая включена по умолчанию.
UI:
- Добавьте поддержку отображения изображения в PlayerView при подключении к ExoPlayer ( #1144 ).
- Добавьте настройку различных значков в PlayerControlView через xml -атрибуты, чтобы разрешить различные рисунки на экземпляр PlayerView , а не глобальные переопределения ( #1200 ).
- Работайте вокруг ошибки платформы, вызывающей растянутое/обрезанное видео при использовании SurfaceView внутри AndroidView на API 34 ( #1237 ).
Загрузки:
- Убедитесь, что DownloadHelper не протекает не выпущенные экземпляры Renderer , что в конечном итоге может привести к сбою приложения с помощью IllegalStateException: Too many receivers, total of 1000, registered for pid ( #1224 ).
Расширение Cronet:
- Исправить SocketTimeoutException в CronetDataSource . В некоторых версиях Cronet запрос, предоставленный обратным вызовом, не всегда одинаковы. Это приводит к обратному обращению, не завершающемуся и запросу время времени (https://issuetracker.google.com/328442628).
Расширение HLS:
- Исправлена ошибка, в которой ожидающие образцы EMSG, ожидающие разрыва, были делегированы в HlsSampleStreamWrapper с неправильным смещением, вызывающим IndexOutOfBoundsException или IllegalArgumentException ( #1002 ).
- Исправьте ошибку, где неприемные списки воспроизведения продолжают перезарядку для потоков LL-HLS ( #1240 ).
- Исправление ошибки, где включение CMCD для HLS с сегментами инициализации привело к Source Error и IllegalArgumentException .
- Исправьте ошибку, где неприемные игровые плейлисты не обновляются во время проживания в прямом эфире ( #1240 ).
- Исправление ошибки, где включение CMCD для HLS Live Streams вызывает ArrayIndexOutOfBoundsException ( #1395 ).
Расширение DASH:
- Исправить ошибку, где повторная подготовка многопериодного живого потока может бросить IndexOutOfBoundsException ( #1329 ).
- Добавьте поддержку dashif:Laurl ( #1345 ).
Расширение листа:
- Исправить ошибку, которая преобразовала название альбома MediaQueueItem в артист в Media3 Media Item ( #1255 ).
Проверьте утилиты:
- Реализация onInit() и onRelease() в FakeRenderer .
- Изменение TestPlayerRunHelper.runUntil()/playUntil() Методы сбоя при нефатальных ошибках (например, те, кто сообщается в AnalyticsListener.onVideoCodecError() ). Используйте New TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX()
Демо -приложение:
- Используйте DefaultPreloadManager в приложении для демонстрации короткой формы.
- Разрешить настройку режима повторения с аргументами Intent из командной строки ( #1266 ).
- Используйте HttpEngineDataSource в качестве HttpDataSource , когда поддерживается устройством.
Удалить устаревшие символы:
- Удалить CronetDataSourceFactory . Вместо этого используйте CronetDataSource.Factory .
- Удалить несколько конструкторов DataSpec . Вместо этого используйте DataSpec.Builder .
- Удалите метод setContentTypePredicate(Predicate) из DefaultHttpDataSource , OkHttpDataSource и CronetDataSource . Вместо этого используйте эквивалентный метод на каждом XXXDataSource.Factory .
- Удалите конструкторы OkHttpDataSource и OkHttpDataSourceFactory . Вместо этого используйте OkHttpDataSource.Factory .
- Удалите PlayerMessage.setHandler(Handler) . Используйте setLooper(Looper) вместо этого.
- Удалить Timeline.Window.isLive . Window.islive Field. Вместо этого используйте метод isLive() .
- Удалить конструкторы DefaultHttpDataSource . Вместо этого используйте DefaultHttpDataSource.Factory .
- Удалить DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS . Используйте DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS вместо этого.
- Удалить MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean) . Вместо этого используйте MediaCodecInfo.canReuseCodec(Format, Format) .
- Удалить DrmSessionManager.DUMMY и getDummyDrmSessionManager() Метод. Вместо этого используйте DrmSessionManager.DRM_UNSUPPORTED .
- Удалить AnalyticsListener.onAudioInputFormatChanged(EventTime, Format) , AnalyticsListener.onVideoInputFormatChanged(EventTime, Format) , AudioRendererEventListener.onAudioInputFormatChanged(Format) , VideoRendererEventListener.onVideoInputFormatChanged(Format) . Вместо этого используйте перегрузки, которые принимают DecoderReuseEvaluation .
- Удалить RendererSupport.FormatSupport intdef и FORMAT_HANDLED , FORMAT_EXCEEDS_CAPABILITIES , FORMAT_UNSUPPORTED_DRM , FORMAT_UNSUPPORTED_SUBTYPE , FORMAT_UNSUPPORTED_TYPE Constants. Вместо этого используйте эквивалентные Intdef и константы в androidx.media3.common.C (например, C.FORMAT_HANDLED ).
- Удалите Bundleable интерфейс. Это включает в себя удаление всех полей Bundleable.Creator<Foo> CREATOR . Вместо этого вызывающие абоненты должны использовать методы Bundle toBundle() и static Foo fromBundle(Bundle) .

Версия 1.4.0-RC01

10 июля 2024 г.

Используйте стабильную версию 1.4.0.

Версия 1.4.0-бета01

26 июня 2024 года

Используйте стабильную версию 1.4.0.

Версия 1.4.0-Alpha02

07 июня 2024 года

Используйте стабильную версию 1.4.0.

Версия 1.4.0-Alpha01

17 апреля 2024 г.

Используйте стабильную версию 1.4.0.

Версия 1.3.0

Версия 1.3.1

11 апреля 2024 г.

androidx.media3:media3-*:1.3.1 выпускается. Версия 1.3.1 содержит эти коммиты .

Общая библиотека:
- Добавить Format.labels , чтобы разрешить локализованные или другие альтернативные этикетки.
Exoplayer:
- Исправлена проблема, где PreloadMediaPeriod не может сохранить потоки, когда он снова загружен.
- Примените правильный соответствующий TrackSelectionResult к периоду воспроизведения в повторном выборе трека.
- Начните рендерины в раннем возрасте только после продвижения периода игры при переходе между предметами СМИ ( #1017 ).
- Добавьте отсутствующий тип возврата в Proguard -keepclasseswithmembers Правило для DefaultVideoFrameProcessor.Factory.Builder.build() ( #1187 ).
Трансформатор:
- Добавьте обходной путь для исключения из -за того, что MediaMuxer не поддерживает негативные временные метки презентации перед API 30.
Выбор трека:
- DefaultTrackSelector : предпочитаю видео треки с «разумной» частотой кадров (> = 10 кадров в секунду) по сравнению с тем, что с более низкой или неразделенной частотой кадров. Это гарантирует, что игрок выбирает «реальную» видеолеугу в MP4S, извлеченных из фотографий, которые могут содержать два трека HEVC, где один имеет более высокое разрешение, но очень небольшое количество кадров ( #1051 ).
Экстракторы:
- Исправлена проблема, где прокладка не была пропущена при чтении кусков нечетного размера из файлов WAV ( #1117 ).
- MP3: Populate Format.averageBitrate из кадров метаданных, таких как XING и VBRI .
- MPEG-TS: вернуть изменение, которое было направлено на то, чтобы обеспечить предоставление последнего кадра путем передачи последней единицы доступа потока в очередь образца ( #7909 ). Это связано с изменением, вызывающим новые проблемы с потоками HLS только I-Frame ( #1150 ) и H.262 HLS-потоками ( #1126 ).
Аудио:
- Разрешить рендеринг восстановление путем отключения разгрузки, если аудиоте не удается инициализировать в режиме разгрузки.
Видео:
- Добавьте обходной путь для выпуска устройства на Galaxy Tab S7 Fe, Chromecast с Google TV и Lenovo M10 FHD Plus, который приводит к отмечению потоков H265 60 кадров в секунду.
- Добавьте обходной путь, который гарантирует, что первый кадр всегда отображается при туннелировании, даже если устройство не делает это автоматически, как требуется API ( #1169 ). ( #966 ).
- Исправлена проблема, где обработка информации о цвете HDR вызывает неправильное поведение кодека и предотвращает адаптивные переключатели формата для видео -треков SDR ( #1158 ).
Текст:
- WebVTT: предотвратите непосредственные подряд подряд создать ложные дополнительные CuesWithTiming с помощью экземпляров WebvttParser.parse ( #1177 ).
DRM:
- Работайте вокруг NoSuchMethodError , который может быть выброшен средством MediaDrm вместо ResourceBusyException , или NotProvisionedException на некоторых устройствах Android 14 ( #1145 ).
Эффект:
- Улучшенное картирование тона PQ в SDR путем преобразования цветовых пространств.
Сессия:
- Исправьте проблему, где текущая позиция отрывается назад, когда контроллер заменяет текущий элемент ( #951 ).
- Исправлена проблема, где MediaMetadata с просто не нулевыми extras не передается между контроллерами и сеансами медиа ( #1176 ).
UI:
- Задолженность, чтобы включить имя языка аудио трека, если Locale не может идентифицировать отображаемое имя ( #988 ).
Расширение DASH:
- Заполните все элементы Label из манифеста в Format.labels ( #1054 ).
Расширение RTSP:
- Пропустите информационные значения с пустыми сеансами (I-TAGS) в SDP-анализе ( #1087 ).
Расширения декодера (FFMPEG, VP9, AV1, MIDI и т. Д.):
- Отключите расширение MIDI в качестве локальной зависимости по умолчанию, потому что для него требуется дополнительный репозиторий Maven. Пользователи, которым нужен этот модуль от локальной зависимости, могут его повторно использовать .

Версия 1.3.0

6 марта 2024 г.

androidx.media3:media3-*:1.3.0 выпускается. Версия 1.3.0 содержит эти коммиты .

Общая библиотека:
- Реализуйте поддержку для android.resource://package/[type/]name round uris uris, где package отличается от пакета текущего приложения. Это всегда было задокументировано для работы, но не было правильно реализовано до сих пор.
- Нормализуйте типы MIME, установленные кодом приложения или чтение из носителя, чтобы быть полностью более низким.
- Определите рекламу с полной MediaItem вместо одного Uri в AdPlaybackState .
- Увеличьте minSdk до 19 (Android kitkat). Это согласовано со всеми остальными библиотеками Androidx , и нам необходимо перейти на последние версии наших зависимостей Androidx.
- Заполняют как artworkUri , так и artworkData в MediaMetadata.Builder.populate(MediaMetadata) когда хотя бы один из них не нулевой ( #964 ).
Exoplayer:
- Добавьте PreloadMediaSource и PreloadMediaPeriod , которые позволяют приложениям предварительно загружать источник контента в конкретной начальной позиции перед воспроизведением. PreloadMediaSource позаботится о подготовке источника контента для получения Timeline , подготовки и кэширования периода в данной начальной позиции, выборе треков и загрузки данных носителя в течение периода. Приложения управляют прогрессом предварительной нагрузки, внедряя PreloadMediaSource.PreloadControl и установите предварительно загруженный источник игроку для воспроизведения.
- Добавить ExoPlayer.setImageOutput , который позволяет приложениям устанавливать ImageRenderer.ImageOutput .
- DefaultRenderersFactory теперь предоставляет игроку ImageRenderer для игрока с Null ImageOutput и ImageDecoder.Factory.DEFAULT .
- EMIT Player.Listener.onPositionDiscontinuity событие, когда молчание пропускается ( #765 ).
- Добавьте экспериментальную поддержку для диапазона субтитров во время извлечения. Вы можете включить это, используя MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() .
- Поддержка адаптивных источников СМИ с PreloadMediaSource .
- Реализовать HttpEngineDataSource , HttpDataSource с использованием HTTPengine API.
- Предотвратить подклассник CompositeSequenceableLoader . Этот компонент ранее был сделан расширяемым , но никогда не был подкласс в библиотеке. Настройки могут быть выполнены, обернув экземпляр, используя рисунок декоратора и реализуя пользовательский CompositeSequenceableLoaderFactory .
- Исправьте проблему, в которой повторение в одно и то же время вызывает очистку метаданных из этого элемента ( #1007 ).
- RENAME experimentalSetSubtitleParserFactory Методы на BundledChunkExtractor.Factory и DefaultHlsExtractorFactory в setSubtitleParserFactory и запретить прохождение null . Используйте новые методы experimentalParseSubtitlesDuringExtraction(boolean) чтобы контролировать поведение анализа.
- Добавьте поддержку для настройки SubtitleParser.Factory , используемого во время извлечения. Это может быть достигнуто с помощью MediaSource.Factory.setSubtitleParserFactory() .
- Добавьте префикс MergingMediaSource ко всем полям Format.id . Это помогает определить, какой источник создал Format ( #883 ).
- Исправьте резервуарную экспозицию, используемую для проверки пользовательских имен ключей данных Common Media Data Client (CMCD), изменяя его только для проверки на hyphen ( #1028 ).
- Остановить параметры запроса CMCD с двойным кодированием ( #1075 ).
Трансформатор:
- Добавьте поддержку для сглаживания H.265/HEVC SEF Mlow Motion Videos.
- Увеличьте скорость передачи, особенно для «удалить видео».
- Добавьте API, чтобы убедиться, что выходной файл запускается на видео кадре. Это может сделать вывод операций обрезки более совместимыми с реализациями игроков, которые не показывают первую видео кадр до его временной метки презентации ( #829 ).
- Добавьте поддержку для оптимизации операций отделки MP4 MP4.
- Добавьте поддержку, чтобы убедиться, что видео кадр имеет первую метку времени в выходном файле. Исправляет выходные файлы, начиная с черной кадры на игроках на основе iOS ( #829 ).
Выбор трека:
- Добавить DefaultTrackSelector.selectImageTrack , чтобы включить выбор трека.
- Добавьте TrackSelectionParameters.isPrioritizeImageOverVideoEnabled , чтобы определить, выбрать ли трек изображения, если доступны как трек изображения, так и видео трек. Значение по умолчанию является false , что означает, что выбор видеолегии приоритет приоритетным.
Экстракторы:
- Добавьте дополнительный анализ AV1C в экстрактор MP4, чтобы получить ColorInfo.colorSpace , ColorInfo.colorTransfer и ColorInfo.colorRange ( #692 ).
- MP3: используйте постоянный битрейт (CBR), чтобы найти файлы с Info заголовком (эквивалент CBR заголовка Xing ). Ранее мы использовали таблицу поиска из заголовка Info , но это приводит к менее точной поиске, чем если бы мы игнорировали ее, и предполагаем, что файл является CBR.
- MPEG2-TS: добавить DTS, DTS-LBR и DTS: x Profile2 Поддержка ( #275 ).
- Извлеките типы аудио из дескрипторов TS и сопоставьте их на флаги роли, что позволяет пользователям делать более информированный выбор аудиоуправления ( #973 ).
Аудио:
- Улучшить алгоритм пропуска тишины с плавным объемом рампы; сохранили минимальное молчание и более естественную продолжительность молчания ( #7423 ).
- Сообщите о пропущенном молчании более детерминированно ( #1035 ).
Видео:
- Измените конструктор MediaCodecVideoRenderer , который принимает аргумент VideoFrameProcessor.Factory и замените его конструктором, который принимает аргумент VideoSinkProvider . Приложения, которые хотят внедрить пользовательский VideoFrameProcessor.Factory , могут создать экземпляр CompositingVideoSinkProvider , который использует пользовательский VideoFrameProcessor.Factory Factory и передавать поставщика видео поставщика MediaCodecVideoRenderer .
Текст:
- Исправлена сериализация растровых сигналов, чтобы разрешить Tried to marshall a Parcel that contained Binder objects при использовании DefaultExtractorsFactory.setTextTrackTranscodingEnabled ( #836 ).
- CEA-708: игнорировать значение rowLock . Спецификация CEA-708-E S-2023 гласит, что rowLock и columnLock должны быть считаются истинными, независимо от значений, присутствующих в потоке (поддержка columnLock не реализована, поэтому предполагается, что она всегда должна быть ложной).
Изображение:
- Добавьте поддержку для Dash MhNHCNALS. Изображения сетки обрезаны, а отдельные миниатюры предоставляются для ImageOutput вблизи их времени презентации.
DRM:
- По умолчанию сразу по умолчанию воспроизводите «чистый свинцовый» образцы в содержании DRM, даже если ключи для более поздних зашифрованных образцов еще не готовы. Это может привести к киоскам в середине воспроизведения, если ключи все еще не готовы, когда позиция воспроизведения достигнет зашифрованных образцов (но ранее воспроизведение вообще не началось к этому моменту). Такое поведение может быть отключено с помощью MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey или DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys .
Расширение IMA:
- Исправить проблему, где Dash и HLS объявления без соответствующего расширения файлов не могут быть воспроизведены.
Сессия:
- Отключите обнаружение двойного щелчка для телевизионных приложений ( #962 ).
- Исправлена проблема, где MediaItem.RequestMetadata с просто не нулевыми дополнениями не передается между контроллерами медиа и сеансов.
- Добавьте конструктор в MediaLibrarySession.Builder , который принимает только Context вместо MediaLibraryService .
Расширение HLS:
- Снизить HlsMediaPeriod до видимости в пакете. Этот тип не должен напрямую зависеть из -за пакета HLS.
- Resolve стремится к началу сегмента более эффективно ( #1031 ).
Расширения декодера (FFMPEG, VP9, AV1, MIDI и т. Д.):
- MIDI Decoder: игнорируйте сообщения о событиях SYSEX ( #710 ).
Проверьте утилиты:
- Не останавливайтесь на воспроизведении в TestPlayerRunHelper.playUntilPosition . Тест сохраняет воспроизведение в игровом состоянии, но приостанавливает прогресс, пока тест не сможет добавить утверждения и дальнейшие действия.
Демо -приложение:
- Добавьте краткосрочный демонстрационный модуль для демонстрации использования PreloadMediaSource с помощью краткосрочного варианта использования содержания.

Версия 1.3.0-RC01

22 февраля 2024 г.

Используйте стабильную версию 1.3.0 .

Версия 1.3.0-бета01

7 февраля 2024 г.

Используйте стабильную версию 1.3.0 .

Версия 1.3.0-Alpha01

15 января 2024 года

Используйте стабильную версию 1.3.0 .

Версия 1.2.0

Версия 1.2.1

9 января 2024 г.

Exoplayer:
- Исправлена проблема, где ручное руководство ищет за пределами диапазона LiveConfiguration.min/maxOffset продолжает регулировать смещение обратно в min/maxOffset .
- Исправлена проблема, что макеты каналов Opus и Vorbis неверны для 3, 5, 6, 7 и 8 каналов ( #8396 ).
- Исправьте проблему, где выборы треков после поиска ноль в прямой трансляции неправильно позвольте потоку запуститься в его позиции по умолчанию ( #9347 ).
- Исправьте проблему, в которой новые экземпляры CmcdData.Factory получали отрицательные значения для bufferedDurationUs из источников Chunk, что приводит к IllegalArgumentException ( #888 ).
Трансформатор:
- Работайте над проблемой, в которой энкодер будет бросать во время конфигурации из -за установки высокой рабочей скорости.
Экстракторы:
- Марк второстепенный (не играемый) треки HEVC в JPEG Tiofle Photos как ROLE_FLAG_ALTERNATE чтобы предотвратить их автоматически выбирать для воспроизведения из -за их более высокого разрешения.
- Исправьте неправильное обнаружение ключей для потоков TS H264 ( #864 ).
- Оценка продолжительности исправления потоков TS, которые более 47721 секунды ( #855 ).
Аудио:
- Исправьте обработку EOS для SilenceSkippingAudioProcessor , когда вы называете несколько раз ( #712 ).
Видео:
- Добавьте обходной путь для выпуска устройства на Tab Galaxy S7 Fe, Chromecast с Google TV и Lenovo M10 FHD Plus, который приводит к отмечению 60 кадров в секунду AVC как не поддерживаемые ( #693 ).
Метаданные:
- Исправьте ошибку, где MediaMetadata был заполнен только из комментариев Vorbis с ключами верхнего часа ( #876 ).
- Поймать OutOfMemoryError При анализе очень больших кадров ID3, то есть воспроизведение может продолжаться без информации о теге, а не полностью сбои.
DRM:
- Расширить обходной путь для ложного URL лицензии ClearKey https://default.url на API 33+ (ранее обходной путь применялся только на API 33 точно) ( #837 ).
- Исправьте ERROR_DRM_SESSION_NOT_OPENED при переключении от зашифрованного на очистку содержимого без поверхности, прикрепленной к игроку. Ошибка была вызвана неправильным использованием безопасного декодера для воспроизведения четкого контента.
Сессия:
- Поместите пользовательские ключи и значения в MediaMetadataCompat в MediaMetadata.extras и MediaMetadata.extras в MediaMetadataCompat ( #756 , #802 ).
- Исправьте вещание notifyChildrenChanged для устаревших контроллеров ( #644 ).
- Исправьте ошибку, в которой установление отрицательного времени для отключенного setWhen уведомления вызвал сбой на некоторых устройствах ( #903 ).
- Исправьте IllegalStateException , когда контроллер уведомления в СМИ не завершил подключение при запросе первого обновления уведомлений ( #917 ).
UI:
- Исправлена проблема, где кнопки вперед и перемотки не видны при использовании с дизайном материала в нижней части heetdialogfragment ( #511 ).
- Исправлена проблема, где цифры в кнопке Fast Forward of PlayerControlView были смещены ( #547 ).
Расширение DASH:
- Parse "F800" как количество каналов 5 для Dolby в Dash Manifest ( #688 ).
Расширения декодера (FFMPEG, VP9, AV1, MIDI и т. Д.):
- MIDI: Исправлена проблема, где поиск вперед пропускает события изменения программы ( #704 ).
- Мигрируйте в FFMPEG 6.0 и обновляется поддержание NDK до r26b ( #707 , #867 ).
Расширение листа:
- Дезинфицировать создание Timeline , чтобы не сбой приложения, когда загрузка носителя не сбои на устройстве CAST ( #708 ).

Версия 1.2.0

15 ноября 2023 г.

Общая библиотека:
- Добавьте @Nullable Throwable параметр в методы в интерфейсе Log.Logger . Параметр message об этих методах больше не содержит никакой информации Logger.appendThrowableString(String, Throwable) Throwable , передаваемом в Log.{d,i,w,e}() Logger.appendThrowableString(String, Throwable) ).
- Исправьте проблему совместимости Kotlin, где нулевые параметры общего типа и нулевые типы элементов массива не обнаруживаются как нулевые. Примерами являются параметры метода TrackSelectorResult и SimpleDecoder ( #6792 ).
- Изменить пользовательский интерфейс по умолчанию и поведение уведомлений в Util.shouldShowPlayButton , чтобы показать кнопку «Воспроизведение», в то время как воспроизведение временно подавлено (например, из -за переходной потери фокуса аудио). Унаследованное поведение можно поддерживать с помощью PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) или MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) ( #11213 ).
- Обновление androidx.annotation:annotation-experimental до 1.3.1 , чтобы исправить https://issuetracker.google.com/251172715.
- Переместите ExoPlayer.setAudioAttributes в интерфейс Player .
Exoplayer:
- Исправление проблем с поиском в потоках AC4, вызванных неправильным выявлением образцов только для декодирования ( #11000 ).
- Добавьте подавление воспроизведения на неподходящие аудиовывочные устройства (например, встроенный динамик на устройствах Wear OS), когда эта функция включена через ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput . Причина подавления воспроизведения будет обновлена как Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT , если воспроизведение будет предпринято, когда нет подходящих аудиовывода, или если все подходящие выходы отключены во время воспроизведения. Причина подавления будет удалена при подключении подходящего выхода.
- Добавить MediaSource.canUpdateMediaItem и MediaSource.updateMediaItem , чтобы принять обновления MediaItem после создания через Player.replaceMediaItem(s) .
- Разрешить обновления MediaItem для всех классов MediaSource , предоставленных библиотекой через Player.replaceMediaItem(s) ( #33 , #9978 ).
- Rename MimeTypes.TEXT_EXOPLAYER_CUES to MimeTypes.APPLICATION_MEDIA3_CUES .
- Добавьте PngExtractor , который отправляет и считывает целый файл PNG в TrackOutput в качестве одного образца.
- Увеличить метод SequenceableLoader.continueLoading(long) на SequenceableLoader -интерфейса для SequenceableLoader.continueLoading(LoadingInfo loadingInfo) . LoadingInfo contains additional parameters, including playbackSpeed and lastRebufferRealtimeMs in addition to the existing playbackPositionUs .
- Enhance ChunkSource.getNextChunk(long, long, List, ChunkHolder) method in the ChunkSource interface to ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder) .
- Add additional fields to Common Media Client Data (CMCD) logging: buffer starvation ( bs ), deadline ( dl ), playback rate ( pr ) and startup ( su ) ( #8699 ).
- Add luma and chroma bitdepth to ColorInfo ( #491 ).
- Add additional fields to Common Media Client Data (CMCD) logging: next object request ( nor ) and next range request ( nrr ) ( #8699 ).
- Add functionality to transmit Common Media Client Data (CMCD) data using query parameters ( #553 ).
- Fix ConcurrentModificationException in ExperimentalBandwidthMeter ( #612 ).
- Add MediaPeriodId parameter to CompositeMediaSource.getMediaTimeForChildMediaTime .
- Support ClippingMediaSource (and other sources with period/window time offsets) in ConcatenatingMediaSource2 ( #11226 ).
- Change BaseRenderer.onStreamChanged() to also receive a MediaPeriodId argument.
Transformer:
- Parse EXIF rotation data for image inputs.
- Remove TransformationRequest.HdrMode annotation type and its associated constants. Use Composition.HdrMode and its associated constants instead.
- Simplify the OverlaySettings to fix rotation issues.
- Changed frameRate and durationUs parameters of SampleConsumer.queueInputBitmap to TimestampIterator .
Track Selection:
- Add DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness to explicitly allow or disallow non-seamless adaptation. The default stays at its current behavior of true .
Extractors:
- MPEG-TS: Ensure the last frame is rendered by passing the last access unit of a stream to the sample queue ( #7909 ).
- Fix typo when determining rotationDegrees . Changed projectionPosePitch to projectionPoseRoll ( #461 ).
- Remove the assumption that Extractor instances can be directly inspected with instanceof . If you want runtime access to the implementation details of an Extractor you must first call Extractor.getUnderlyingInstance .
- Add BmpExtractor .
- Add WebpExtractor .
- Add HeifExtractor .
- Add QuickTime classic support to Mp4Extractor .
Audio:
- Add support for 24/32-bit big-endian PCM in MP4 and Matroska, and parse PCM encoding for lpcm in MP4.
- Add support for extracting Vorbis audio in MP4.
- Add AudioSink.getFormatOffloadSupport(Format) that retrieves level of offload support the sink can provide for the format through a DefaultAudioOffloadSupportProvider . It returns the new AudioOffloadSupport that contains isFormatSupported , isGaplessSupported , and isSpeedChangeSupported .
- Add AudioSink.setOffloadMode() through which the offload configuration on the audio sink is configured. Default is AudioSink.OFFLOAD_MODE_DISABLED .
- Offload can be enabled through setAudioOffloadPreference in TrackSelectionParameters . If the set preference is to enable, the device supports offload for the format, and the track selection is a single audio track, then audio offload will be enabled.
- If audioOffloadModePreference is set to AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED , then the DefaultTrackSelector will only select an audio track and only if that track's format is supported in offload. If no audio track is supported in offload, then no track will be selected.
- Disabling gapless support for offload when pre-API level 33 due to playback position issue after track transition.
- Remove parameter enableOffload from DefaultRenderersFactory.buildAudioSink method signature.
- Remove method DefaultAudioSink.Builder.setOffloadMode .
- Remove intdef value DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED .
- Add support for Opus gapless metadata during offload playback.
- Allow renderer recovery by disabling offload if failed at first write ( #627 ).
- Enable Offload Scheduling by default for audio-only offloaded playback.
- Delete ExoPlayer.experimentalSetOffloadSchedulingEnabled and AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged .
- Renamed onExperimentalSleepingForOffloadChanged as onSleepingForOffloadChanged and onExperimentalOffloadedPlayback as onOffloadedPlayback .
- Move audio offload mode related TrackSelectionParameters interfaces and definitions to an inner AudioOffloadPreferences class.
- Add onAudioTrackInitialized and onAudioTrackReleased callbacks to AnalyticsListener , AudioRendererEventListener and AudioSink.Listener .
- Fix DTS Express audio buffer underflow issue ( #650 ).
- Fix bug where the capabilities check for E-AC3-JOC throws an IllegalArgumentException ( #677 ).
Видео:
- Allow MediaCodecVideoRenderer to use a custom VideoFrameProcessor.Factory .
- Fix bug where the first frame couldn't be rendered if the audio stream starts with negative timestamps ( #291 ).
Текст:
- Remove ExoplayerCuesDecoder . Text tracks with sampleMimeType = application/x-media3-cues are now directly handled by TextRenderer without needing a SubtitleDecoder instance.
Metadata:
- MetadataDecoder.decode will no longer be called for "decode-only" samples as the implementation must return null anyway.
Эффект:
- Add VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) queuing bitmap input by timestamp.
- Change VideoFrameProcessor.registerInputStream() to be non-blocking. Apps must implement VideoFrameProcessor.Listener#onInputStreamRegistered() .
- Changed frameRate and durationUs parameters of VideoFrameProcessor.queueInputBitmap to TimestampIterator .
IMA extension:
- Fix bug where a multi-period DASH live stream that is not the first item in a playlist can throw an exception ( #571 ).
- Release StreamManager before calling AdsLoader.destroy()
- Bump IMA SDK version to 3.31.0.
Сессия:
- Set the notifications foreground service behavior to FOREGROUND_SERVICE_IMMEDIATE in DefaultMediaNotificationProvider ( #167 ).
- Use only android.media.session.MediaSession.setMediaButtonBroadcastReceiver() above API 31 to avoid problems with deprecated API on Samsung devices ( #167 ).
- Use the media notification controller as proxy to set available commands and custom layout used to populate the notification and the platform session.
- Convert media button events that are received by MediaSessionService.onStartCommand() within Media3 instead of routing them to the platform session and back to Media3. With this, the caller controller is always the media notification controller and apps can easily recognize calls coming from the notification in the same way on all supported API levels.
- Fix bug where MediaController.getCurrentPosition() is not advancing when connected to a legacy MediaSessionCompat .
- Add MediaLibrarySession.getSubscribedControllers(mediaId) for convenience.
- Override MediaLibrarySession.Callback.onSubscribe() to assert the availability of the parent ID for which the controller subscribes. If successful, the subscription is accepted and notifyChildrenChanged() is called immediately to inform the browser ( #561 ).
- Add session demo module for Automotive OS and enable session demo for Android Auto.
- Do not set the queue of the framework session when COMMAND_GET_TIMELINE is not available for the media notification controller. With Android Auto as the client controller reading from the framework session, this has the effect that the queue button in the UI of Android Auto is not displayed ( #339 ).
- Use DataSourceBitmapLoader by default instead of SimpleBitmapLoader ( #271 , #327 ).
- Add MediaSession.Callback.onMediaButtonEvent(Intent) that allows apps to override the default media button event handling.
UI:
- Add a Player.Listener implementation for Wear OS devices that handles playback suppression due to Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT by launching a system dialog to allow a user to connect a suitable audio output (eg bluetooth headphones). The listener will auto-resume playback if a suitable device is connected within a configurable timeout (default is 5 minutes).
Загрузки:
- Declare "data sync" foreground service type for DownloadService for Android 14 compatibility. When using this service, the app also needs to add dataSync as foregroundServiceType in the manifest and add the FOREGROUND_SERVICE_DATA_SYNC permission ( #11239 ).
HLS Extension:
- Refresh the HLS live playlist with an interval calculated from the last load start time rather than the last load completed time ( #663 ).
DASH Extension:
- Allow multiple of the same DASH identifier in segment template URL.
- Add experimental support for parsing subtitles during extraction. This has better support for merging overlapping subtitles, including resolving flickering when transitioning between subtitle segments. You can enable this using DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() ( #288 ).
RTSP Extension:
- Fix a race condition that could lead to IndexOutOfBoundsException when falling back to TCP, or playback hanging in some situations.
- Check state in RTSP setup when returning loading state of RtspMediaPeriod ( #577 ).
- Ignore custom Rtsp request methods in Options response public header ( #613 ).
- Use RTSP Setup Response timeout value in time interval of sending keep-alive RTSP Options requests ( #662 ).
Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
- Release the MIDI decoder module, which provides support for playback of standard MIDI files using the Jsyn library to synthesize audio.
- Add DecoderOutputBuffer.shouldBeSkipped to directly mark output buffers that don't need to be presented. This is preferred over C.BUFFER_FLAG_DECODE_ONLY that will be deprecated.
- Add Decoder.setOutputStartTimeUs and SimpleDecoder.isAtLeastOutputStartTimeUs to allow decoders to drop decode-only samples before the start time. This should be preferred to Buffer.isDecodeOnly that will be deprecated.
- Fix bug publishing MIDI decoder artifact to Maven repository. The artifact is renamed to media3-exoplayer-midi ( #734 ).
Leanback extension:
- Fix bug where disabling a surface can cause an ArithmeticException in Leanback code ( #617 ).
Test Utilities:
- Make TestExoPlayerBuilder and FakeClock compatible with Espresso UI tests and Compose UI tests. This fixes a bug where playback advances non-deterministically during Espresso or Compose view interactions.
Remove deprecated symbols:
- Remove TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) and TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean) . Use Composition.Builder.setHdrMode(int) and pass the Composition to Transformer.start(Composition, String) instead.
- Remove deprecated DownloadNotificationHelper.buildProgressNotification method, use a non deprecated method that takes a notMetRequirements parameter instead.

Version 1.2.0-rc01

November 1, 2023

Use the 1.2.0 stable version .

Version 1.2.0-beta01

October 19, 2023

Use the 1.2.0 stable version .

Version 1.2.0-alpha02

29 сентября 2023 г.

Use the 1.2.0 stable version .

Version 1.2.0-alpha01

17 августа 2023 г.

Use the 1.2.0 stable version .

Версия 1.1.0

Version 1.1.1

16 августа 2023 г.

Common Library:
- Remove accidentally added multidex dependency from all modules ( #499 ).
ExoPlayer:
- Fix issue in PlaybackStatsListener where spurious PlaybackStats are created after the playlist is cleared.
- Add additional fields to Common Media Client Data (CMCD) logging: streaming format (sf), stream type (st), version (v), top birate (tb), object duration (d), measured throughput (mtp) and object type (ot) ( #8699 ).
Audio:
- Fix a bug where Player.getState() never transitioned to STATE_ENDED when playing very short files ( #538 ).
Audio Offload:
- Prepend Ogg ID Header and Comment Header Pages to bitstream for offloaded Opus playback in accordance with RFC 7845.
Видео:
- H.265/HEVC: Fix parsing SPS short and long term reference picture info.
Текст:
- CEA-608: Change cue truncation logic to only consider visible text. Previously indent and tab offset were included when limiting the cue length to 32 characters (which was technically correct by the spec) ( #11019 ).
IMA extension:
- Bump IMA SDK version to 3.30.3.
Сессия:
- Add custom layout to the state of the controller and provide a getter to access it. When the custom layout changes, MediaController.Listener.onCustomLayoutChanged is called. Apps that want to send different custom layouts to different Media3 controller can do this in MediaSession.Callback.onConnect by using an AcceptedResultBuilder to make sure the custom layout is available to the controller when connection completes.
- Fix cases where MediaLibraryServiceLegacyStub sent an error to a Result that didn't support this which produced an UnsupportedOperationException ( #78 ).
- Fix the way PlayerWrapper creates a VolumeProviderCompat by determining volumeControlType through both legacy commands ( COMMAND_ADJUST_DEVICE_VOLUME and COMMAND_SET_DEVICE_VOLUME ) and new commands ( COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS and COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS ) ( #554 ).

Версия 1.1.0

5 июля 2023 г.

Common Library:
- Add suppression reason for unsuitable audio route and play when ready change reason for suppressed too long. ( #15 ).
- Add commands to Player:
  - COMMAND_GET_METADATA
  - COMMAND_SET_PLAYLIST_METADATA
  - COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
  - COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
- Add overloaded methods to Player which allow users to specify volume flags:
  - void setDeviceVolume(int, int)
  - void increaseDeviceVolume(int)
  - void decreaseDeviceVolume(int)
  - void setDeviceMuted(boolean, int)
- Add Builder for DeviceInfo and deprecate existing constructor.
- Add DeviceInfo.routingControllerId to specify the routing controller ID for remote playbacks.
- Add Player.replaceMediaItem(s) as a shortcut to adding and removing items at the same position ( #8046 ).
ExoPlayer:
- Allow ExoPlayer to have control of device volume methods only if explicitly opted in. Use ExoPlayer.Builder.setDeviceVolumeControlEnabled to have access to:
  - getDeviceVolume()
  - isDeviceMuted()
  - setDeviceVolume(int) and setDeviceVolume(int, int)
  - increaseDeviceVolume(int) and increaseDeviceVolume(int, int)
  - decreaseDeviceVolume(int) and decreaseDeviceVolume(int, int)
- Add FilteringMediaSource that allows to filter available track types from a MediaSource .
- Add support for including Common Media Client Data (CMCD) in the outgoing requests of adaptive streaming formats DASH, HLS, and SmoothStreaming. The following fields, br , bl , cid , rtp , and sid , have been incorporated ( #8699 ). API structure and API methods:
  - CMCD logging is disabled by default, use MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) to enable it.
  - All keys are enabled by default, override CmcdConfiguration.RequestConfig.isKeyAllowed(String key) to filter out which keys are logged.
  - Override CmcdConfiguration.RequestConfig.getCustomData() to enable custom key logging.
- Add additional action to manifest of main demo to make it easier to start the demo app with a custom *.exolist.json file ( #439 ).
- Add ExoPlayer.setVideoEffects() for using Effect during video playback.
- Update SampleQueue to store sourceId as a long rather than an int . This changes the signatures of public methods SampleQueue.sourceId and SampleQueue.peekSourceId .
- Add parameters to LoadControl methods shouldStartPlayback and onTracksSelected that allow associating these methods with the relevant MediaPeriod .
- Change signature of ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) by adding a timeline parameter that contains the periods with the UIDs used as keys in the map. This is required to avoid concurrency issues with multi-period live streams.
- Deprecate EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) and BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs) . The variant of the methods without the mediaTimeOffsetUs can be called instead. Note that even for the deprecated variants, the offset is not anymore added to startTimeUs and endTimeUs of the MediaLoadData objects that are dispatched by the dispatcher.
- Rename ExoTrackSelection.blacklist to excludeTrack and isBlacklisted to isTrackExcluded .
- Fix inconsistent behavior between ExoPlayer.setMediaItem(s) and addMediaItem(s) when called on an empty playlist.
Transformer:
- Remove Transformer.Builder.setMediaSourceFactory(MediaSource.Factory) . Use ExoPlayerAssetLoader.Factory(MediaSource.Factory) and Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory) instead.
- Remove Transformer.startTransformation(MediaItem, ParcelFileDescriptor) .
- Fix a bug where transformation could get stuck (leading to muxer timeout) if the end of the video stream was signaled at the moment when an input frame was pending processing.
- Query codecs via MediaCodecList instead of using findDecoder/EncoderForFormat utilities, to expand support.
- Remove B-frame configuration in DefaultEncoderFactory because it doesn't work on some devices.
Track selection:
- Add DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange which is disabled by default. When enabled, the DefaultTrackSelector will trigger a new track selection when the renderer capabilities changed.
Extractors:
- Ogg: Fix bug when seeking in files with a long duration ( #391 ).
- FMP4: Fix issue where TimestampAdjuster initializes a wrong timestamp offset with metadata sample time from emsg atom ( #356 ).
Audio:
- Fix bug where some playbacks fail when tunneling is enabled and AudioProcessors are active, eg for gapless trimming ( #10847 ).
- Encapsulate Opus frames in Ogg packets in direct playbacks (offload).
- Extrapolate current position during sleep with offload scheduling.
- Add Renderer.release() and AudioSink.release() for releasing the resources at the end of player's lifecycle.
- Listen to audio capabilities changes in DefaultAudioSink . Add a required parameter context in the constructor of DefaultAudioSink , with which the DefaultAudioSink will register as the listener to the AudioCapabilitiesReceiver and update its audioCapabilities property when informed with a capabilities change.
- Propagate audio capabilities changes via a new event onAudioCapabilitiesChanged in AudioSink.Listener interface, and a new interface RendererCapabilities.Listener which triggers onRendererCapabilitiesChanged events.
- Add ChannelMixingAudioProcessor for applying scaling/mixing to audio channels.
- Add new int value DISCARD_REASON_AUDIO_BYPASS_POSSIBLE to DecoderDiscardReasons to discard audio decoder when bypass mode is possible after audio capabilities change.
- Add direct playback support for DTS Express and DTS:X ( #335 ).
Видео:
- Make MediaCodecVideoRenderer report a VideoSize with a width and height of 0 when the renderer is disabled. Player.Listener.onVideoSizeChanged is called accordingly when Player.getVideoSize() changes. With this change, ExoPlayer's video size with MediaCodecVideoRenderer has a width and height of 0 when Player.getCurrentTracks does not support video, or the size of the supported video track is not yet determined.
DRM:
- Reduce the visibility of several internal-only methods on DefaultDrmSession that aren't expected to be called from outside the DRM package:
  - void onMediaDrmEvent(int)
  - void provision()
  - void onProvisionCompleted()
  - onProvisionError(Exception, boolean)
Muxer:
- Add a new muxer library which can be used to create an MP4 container file.
IMA extension:
- Enable multi-period live DASH streams for DAI. Please note that the current implementation does not yet support seeking in live streams ( #10912 ).
- Fix a bug where a new ad group is inserted in live streams because the calculated content position in consecutive timelines varies slightly.
Сессия:
- Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling a Player method.
- Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset ( #167 ).
- Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
- Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
- Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (eg URI) ( #282 ).
- Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ( #410 ).
UI:
- Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
RTSP Extension:
- For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message ( #302 ).
- Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header ( #11160 ).
DASH Extension:
- Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
- Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException ( #10838 ).
HLS Extension:
- Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. If the initialization doesn't complete before the timeout, a PlaybackException is thrown to avoid the playback endless stalling. The timeout is set to zero by default ( #323 ).
Test Utilities:
- Check for URI scheme case insensitivity in DataSourceContractTest .
Remove deprecated symbols:
- Remove DefaultAudioSink constructors, use DefaultAudioSink.Builder instead.
- Remove HlsMasterPlaylist , use HlsMultivariantPlaylist instead.
- Remove Player.stop(boolean) . Use Player.stop() and Player.clearMediaItems() (if reset is true ) instead.
- Remove two deprecated SimpleCache constructors, use a non-deprecated constructor that takes a DatabaseProvider instead for better performance.
- Remove DefaultBandwidthMeter constructor, use DefaultBandwidthMeter.Builder instead.
- Remove DefaultDrmSessionManager constructors, use DefaultDrmSessionManager.Builder instead.
- Remove two deprecated HttpDataSource.InvalidResponseCodeException constructors, use a non-deprecated constructor that accepts additional fields( cause , responseBody ) to enhance error logging.
- Remove DownloadHelper.forProgressive , DownloadHelper.forHls , DownloadHelper.forDash , and DownloadHelper.forSmoothStreaming , use DownloadHelper.forMediaItem instead.
- Remove deprecated DownloadService constructor, use a non deprecated constructor that includes the option to provide a channelDescriptionResourceId parameter.
- Remove deprecated String constants for Charsets ( ASCII_NAME , UTF8_NAME , ISO88591_NAME , UTF16_NAME and UTF16LE_NAME ), use Kotlin Charsets from the kotlin.text package, the java.nio.charset.StandardCharsets or the com.google.common.base.Charsets instead.
- Remove deprecated WorkManagerScheduler constructor, use a non deprecated constructor that includes the option to provide a Context parameter instead.
- Remove the deprecated methods createVideoSampleFormat , createAudioSampleFormat , createContainerFormat , and createSampleFormat , which were used to instantiate the Format class. Instead use Format.Builder for creating instances of Format .
- Remove the deprecated methods copyWithMaxInputSize , copyWithSubsampleOffsetUs , copyWithLabel , copyWithManifestFormatInfo , copyWithGaplessInfo , copyWithFrameRate , copyWithDrmInitData , copyWithMetadata , copyWithBitrate and copyWithVideoSize , use Format.buildUpon() and setter methods instead.
- Remove deprecated ExoPlayer.retry() , use prepare() instead.
- Remove deprecated zero-arg DefaultTrackSelector constructor, use DefaultTrackSelector(Context) instead.
- Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
- Remove deprecated DownloadManager constructor, use the constructor that takes an Executor instead.
- Remove deprecated Cue constructors, use Cue.Builder instead.
- Remove deprecated OfflineLicenseHelper constructor, use OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher) instead.
- Remove four deprecated AnalyticsListener methods:
  - onDecoderEnabled , use onAudioEnabled and/or onVideoEnabled instead.
  - onDecoderInitialized , use onAudioDecoderInitialized and/or onVideoDecoderInitialized instead.
  - onDecoderInputFormatChanged , use onAudioInputFormatChanged and/or onVideoInputFormatChanged instead.
  - onDecoderDisabled , use onAudioDisabled and/or onVideoDisabled instead.
- Remove the deprecated Player.Listener.onSeekProcessed and AnalyticsListener.onSeekProcessed , use onPositionDiscontinuity with DISCONTINUITY_REASON_SEEK instead.
- Remove ExoPlayer.setHandleWakeLock(boolean) , use setWakeMode(int) instead.
- Remove deprecated DefaultLoadControl.Builder.createDefaultLoadControl() , use build() instead.
- Remove deprecated MediaItem.PlaybackProperties , use MediaItem.LocalConfiguration instead. Deprecated field MediaItem.playbackProperties is now of type MediaItem.LocalConfiguration .

Version 1.1.0-rc01

June 21, 2023

Use the 1.1.0 stable version .

Version 1.1.0-beta01

7 июня 2023 г.

Use the 1.1.0 stable version .

Version 1.1.0-alpha01

10 мая 2023 г.

Use the 1.1.0 stable version .

Версия 1.0.0

Версия 1.0.2

18 мая 2023 г.

androidx.media3:media3-*:1.0.2 is released. Version 1.0.2 contains these commits.

This release corresponds to the ExoPlayer 2.18.7 release .

This release contains the following changes since the 1.0.1 release :

Core library:
- Add Buffer.isLastSample() that denotes if Buffer contains flag C.BUFFER_FLAG_LAST_SAMPLE .
- Fix issue where last frame may not be rendered if the last sample with frames is dequeued without reading the 'end of stream' sample. ( #11079 ).
Extractors:
- Fix parsing of H.265 SPS in MPEG-TS files by re-using the parsing logic already used by RTSP and MP4 extractors ( #303 ).
Текст:
- SSA: Add support for UTF-16 files if they start with a byte order mark ( #319 ).
Сессия:
- Fix issue where MediaController doesn't update its available commands when connected to a legacy MediaSessionCompat that updates its actions.
- Fix bug that prevented the MediaLibraryService from returning null for a call from System UI to Callback.onGetLibraryRoot with params.isRecent == true on API 30 ( #355 ).
- Fix memory leak of MediaSessionService or MediaLibraryService ( #346 ).
- Fix bug where a combined Timeline and position update in a MediaSession may cause a MediaController to throw an IllegalStateException .

Версия 1.0.1

18 апреля 2023 г.

androidx.media3:media3-*:1.0.1 is released. Version 1.0.1 contains these commits.

This release corresponds to the ExoPlayer 2.18.6 release .

Core library:
- Reset target live stream override when seeking to default position ( #11051 ).
- Fix bug where empty sample streams in the media could cause playback to be stuck.
Сессия:
- Fix bug where multiple identical queue items published by a legacy MediaSessionCompat result in an exception in MediaController ( #290 ).
- Add missing forwarding of MediaSession.broadcastCustomCommand to the legacy MediaControllerCompat.Callback.onSessionEvent ( #293 ).
- Fix bug where calling MediaSession.setPlayer doesn't update the available commands.
- Fix issue that TrackSelectionOverride instances sent from a MediaController are ignored if they reference a group with Format.metadata ( #296 ).
- Fix issue where Player.COMMAND_GET_CURRENT_MEDIA_ITEM needs to be available to access metadata via the legacy MediaSessionCompat .
- Fix issue where MediaSession instances on a background thread cause crashes when used in MediaSessionService ( #318 ).
- Fix issue where a media button receiver was declared by the library without the app having intended this ( #314 ).
БРОСАТЬСЯ:
- Fix handling of empty segment timelines ( #11014 ).
RTSP:
- Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport ( #11069 ).

Версия 1.0.0

March 22, 2023

androidx.media3:media3-*:1.0.0 is released. Version 1.0.0 contains these commits.

This release corresponds to the ExoPlayer 2.18.5 release .

There are no changes since 1.0.0-rc02.

Version 1.0.0-rc02

2 марта 2023 г.

androidx.media3:media3-*:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits.

This release corresponds to the ExoPlayer 2.18.4 release .

Core library:
- Fix network type detection on API 33 ( #10970 ).
- Fix NullPointerException when calling ExoPlayer.isTunnelingEnabled ( #10977 ).
Загрузки:
- Make the maximum difference of the start time of two segments to be merged configurable in SegmentDownloader and subclasses ( #248 ).
Audio:
- Fix broken gapless MP3 playback on Samsung devices ( #8594 ).
- Fix bug where playback speeds set immediately after disabling audio may be overridden by a previous speed change ( #10882 ).
Видео:
- Map HEVC HDR10 format to HEVCProfileMain10HDR10 instead of HEVCProfileMain10 .
- Add workaround for a device issue on Chromecast with Google TV and Lenovo M10 FHD Plus that causes 60fps AVC streams to be marked as unsupported ( #10898 ).
- Fix frame release performance issues when playing media with a frame rate far higher than the screen refresh rate.
Бросать:
- Fix transient STATE_IDLE when transitioning between media items ( #245 ).
RTSP:
- Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ( #10971 ).
Сессия:
- Fix a bug where notification play/pause button doesn't update with player state ( #192 ).
IMA extension:
- Fix a bug which prevented DAI streams without any ads from starting because the first (and in the case without ads the only) LOADED event wasn't received.

Version 1.0.0-rc01

16 февраля 2023 г.

androidx.media3:media3-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

This release corresponds to the ExoPlayer 2.18.3 release .

Core library:
- Tweak the renderer's decoder ordering logic to uphold the MediaCodecSelector 's preferences, even if a decoder reports it may not be able to play the media performantly. For example with default selector, hardware decoder with only functional support will be preferred over software decoder that fully supports the format ( #10604 ).
- Add ExoPlayer.Builder.setPlaybackLooper that sets a pre-existing playback thread for a new ExoPlayer instance.
- Allow download manager helpers to be cleared ( #10776 ).
- Add parameter to BasePlayer.seekTo to also indicate the command used for seeking.
- Use theme when loading drawables on API 21+ ( #220 ).
- Add ConcatenatingMediaSource2 that allows combining multiple media items into a single window ( #247 ).
Extractors:
- Throw a ParserException instead of a NullPointerException if the sample table (stbl) is missing a required sample description (stsd) when parsing trak atoms.
- Correctly skip samples when seeking directly to a sync frame in fMP4 ( #10941 ).
Audio:
- Use the compressed audio format bitrate to calculate the min buffer size for AudioTrack in direct playbacks (passthrough).
Текст:
- Fix TextRenderer passing an invalid (negative) index to Subtitle.getEventTime if a subtitle file contains no cues.
- SubRip: Add support for UTF-16 files if they start with a byte order mark.
Metadata:
- Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
- Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
- Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
БРОСАТЬСЯ:
- Add full parsing for image adaptation sets, including tile counts ( #3752 ).
UI:
- Fix the deprecated PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) to ensure visibility changes are passed to the registered listener ( #229 ).
- Fix the ordering of the center player controls in PlayerView when using a right-to-left (RTL) layout ( #227 ).
Сессия:
- Add abstract SimpleBasePlayer to help implement the Player interface for custom players.
- Add helper method to convert platform session token to Media3 SessionToken ( #171 ).
- Use onMediaMetadataChanged to trigger updates of the platform media session ( #219 ).
- Add the media session as an argument of getMediaButtons() of the DefaultMediaNotificationProvider and use immutable lists for clarity ( #216 ).
- Add onSetMediaItems callback listener to provide means to modify/set MediaItem list, starting index and position by session before setting onto Player ( #156 ).
- Avoid double tap detection for non-Bluetooth media button events ( #233 ).
- Make QueueTimeline more robust in case of a shady legacy session state ( #241 ).
Metadata:
- Parse multiple null-separated values from ID3 frames, as permitted by ID3 v2.4.
- Add MediaMetadata.mediaType to denote the type of content or the type of folder described by the metadata.
- Add MediaMetadata.isBrowsable as a replacement for MediaMetadata.folderType . The folder type will be deprecated in the next release.
Cast extension:
- Bump Cast SDK version to 21.2.0.
IMA extension:
- Remove player listener of the ImaServerSideAdInsertionMediaSource on the application thread to avoid threading issues.
- Add a property focusSkipButtonWhenAvailable to the ImaServerSideAdInsertionMediaSource.AdsLoader.Builder to request focusing the skip button on TV devices and set it to true by default.
- Add a method focusSkipButton() to the ImaServerSideAdInsertionMediaSource.AdsLoader to programmatically request to focus the skip button.
- Bump IMA SDK version to 3.29.0.
Demo app:
- Request notification permission for download notifications at runtime ( #10884 ).

Version 1.0.0-beta03

November 22, 2022

androidx.media3:media3-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

This release corresponds to the ExoPlayer 2.18.2 release .

Core library:
- Add ExoPlayer.isTunnelingEnabled to check if tunneling is enabled for the currently selected tracks ( #2518 ).
- Add WrappingMediaSource to simplify wrapping a single MediaSource ( #7279 ).
- Discard back buffer before playback gets stuck due to insufficient available memory.
- Close the Tracing "doSomeWork" block when offload is enabled.
- Fix session tracking problem with fast seeks in PlaybackStatsListener ( #180 ).
- Send missing onMediaItemTransition callback when calling seekToNext or seekToPrevious in a single-item playlist ( #10667 ).
- Add Player.getSurfaceSize that returns the size of the surface on which the video is rendered.
- Fix bug where removing listeners during the player release can cause an IllegalStateException ( #10758 ).
Строить:
- Enforce minimum compileSdkVersion to avoid compilation errors ( #10684 ).
- Avoid publishing block when included in another gradle build.
Track selection:
- Prefer other tracks to Dolby Vision if display does not support it. ( #8944 ).
Загрузки:
- Fix potential infinite loop in ProgressiveDownloader caused by simultaneous download and playback with the same PriorityTaskManager ( #10570 ).
- Make download notification appear immediately ( #183 ).
- Limit parallel download removals to 1 to avoid excessive thread creation ( #10458 ).
Видео:
- Try alternative decoder for Dolby Vision if display does not support it. ( #9794 ).
Audio:
- Use SingleThreadExecutor for releasing AudioTrack instances to avoid OutOfMemory errors when releasing multiple players at the same time ( #10057 ).
- Adds AudioOffloadListener.onExperimentalOffloadedPlayback for the AudioTrack offload state. ( #134 ).
- Make AudioTrackBufferSizeProvider a public interface.
- Add ExoPlayer.setPreferredAudioDevice to set the preferred audio output device ( #135 ).
- Rename androidx.media3.exoplayer.audio.AudioProcessor to androidx.media3.common.audio.AudioProcessor .
- Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions ( #10701 ).
Metadata:
- MetadataRenderer can now be configured to render metadata as soon as they are available. Create an instance with MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) to specify whether the renderer will output metadata early or in sync with the player position.
DRM:
- Work around a bug in the Android 13 ClearKey implementation that returns a non-empty but invalid license URL.
- Fix setMediaDrmSession failed: session not opened error when switching between DRM schemes in a playlist (eg Widevine to ClearKey).
Текст:
- CEA-608: Ensure service switch commands on field 2 are handled correctly ( #10666 ).
БРОСАТЬСЯ:
- Parse EventStream.presentationTimeOffset from manifests ( #10460 ).
UI:
- Use current overrides of the player as preset in TrackSelectionDialogBuilder ( #10429 ).
Сессия:
- Ensure commands are always executed in the correct order even if some require asynchronous resolution ( #85 ).
- Add DefaultMediaNotificationProvider.Builder to build DefaultMediaNotificationProvider instances. The builder can configure the notification ID, the notification channel ID and the notification channel name used by the provider. Also, add method DefaultMediaNotificationProvider.setSmallIcon(int) to set the notifications small icon. ( #104 ).
- Ensure commands sent before MediaController.release() are not dropped ( #99 ).
- SimpleBitmapLoader can load bitmap from file:// URIs ( #108 ).
- Fix assertion that prevents MediaController to seek over an ad in a period ( #122 ).
- When playback ends, the MediaSessionService is stopped from the foreground and a notification is shown to restart playback of the last played media item ( #112 ).
- Don't start a foreground service with a pending intent for pause ( #167 ).
- Manually hide the 'badge' associated with the notification created by DefaultNotificationProvider on API 26 and API 27 (the badge is automatically hidden on API 28+) ( #131 ).
- Fix bug where a second binder connection from a legacy MediaSession to a Media3 MediaController causes IllegalStateExceptions ( #49 ).
RTSP:
- Add H263 fragmented packet handling ( #119 ).
- Add support for MP4A-LATM ( #162 ).
IMA:
- Add timeout for loading ad information to handle cases where the IMA SDK gets stuck loading an ad ( #10510 ).
- Prevent skipping mid-roll ads when seeking to the end of the content ( #10685 ).
- Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI ( #10764 ).
FFmpeg extension:
- Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above ( #9933 ).
AV1 extension:
- Update CMake version to avoid incompatibilities with the latest Android Studio releases ( #9933 ).
Cast extension:
- Implement getDeviceInfo() to be able to identify CastPlayer when controlling playback with a MediaController ( #142 ).
Transformer:
- Add muxer watchdog timer to detect when generating an output sample is too slow.
Remove deprecated symbols:
- Remove Transformer.Builder.setOutputMimeType(String) . This feature has been removed. The MIME type will always be MP4 when the default muxer is used.

Version 1.0.0-beta02

21 июля 2022 г.

androidx.media3:media3-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

This release corresponds to the ExoPlayer 2.18.1 release .

Core library:
- Ensure that changing the ShuffleOrder with ExoPlayer.setShuffleOrder results in a call to Player.Listener#onTimelineChanged with reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED ( #9889 ).
- For progressive media, only include selected tracks in buffered position ( #10361 ).
- Allow custom logger for all ExoPlayer log output ( #9752 ).
- Fix implementation of setDataSourceFactory in DefaultMediaSourceFactory , which was non-functional in some cases ( #116 ).
Extractors:
- Fix parsing of H265 short term reference picture sets ( #10316 ).
- Fix parsing of bitrates from esds boxes ( #10381 ).
БРОСАТЬСЯ:
- Parse ClearKey license URL from manifests ( #10246 ).
UI:
- Ensure TalkBack announces the currently active speed option in the playback controls menu ( #10298 ).
RTSP:
- Add VP8 fragmented packet handling ( #110 ).
Leanback extension:
- Listen to playWhenReady changes in LeanbackAdapter ( 10420 ).
Бросать:
- Use the MediaItem that has been passed to the playlist methods as Window.mediaItem in CastTimeline ( #25 , #8212 ).
- Support Player.getMetadata() and Listener.onMediaMetadataChanged() with CastPlayer ( #25 ).

Version 1.0.0-beta01

June 16, 2022

androidx.media3:media3-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

This corresponds to the ExoPlayer 2.18.0 release .

Core library:
- Enable support for Android platform diagnostics via MediaMetricsManager . ExoPlayer will forward playback events and performance data to the platform, which helps to provide system performance and debugging information on the device. This data may also be collected by Google if sharing usage and diagnostics data is enabled by the user of the device. Apps can opt-out of contributing to platform diagnostics for ExoPlayer with ExoPlayer.Builder.setUsePlatformDiagnostics(false) .
- Fix bug that tracks are reset too often when using MergingMediaSource , for example when side-loading subtitles and changing the selected subtitle mid-playback ( #10248 ).
- Stop detecting 5G-NSA network type on API 29 and 30. These playbacks will assume a 4G network.
- Disallow passing null to MediaSource.Factory.setDrmSessionManagerProvider and MediaSource.Factory.setLoadErrorHandlingPolicy . Instances of DefaultDrmSessionManagerProvider and DefaultLoadErrorHandlingPolicy can be passed explicitly if required.
- Add MediaItem.RequestMetadata to represent metadata needed to play media when the exact LocalConfiguration is not known. Also remove MediaMetadata.mediaUrl as this is now included in RequestMetadata .
- Add Player.Command.COMMAND_SET_MEDIA_ITEM to enable players to allow setting a single item.
Track selection:
- Flatten TrackSelectionOverrides class into TrackSelectionParameters , and promote TrackSelectionOverride to a top level class.
- Rename TracksInfo to Tracks and TracksInfo.TrackGroupInfo to Tracks.Group . Player.getCurrentTracksInfo and Player.Listener.onTracksInfoChanged have also been renamed to Player.getCurrentTracks and Player.Listener.onTracksChanged . This includes 'un-deprecating' the Player.Listener.onTracksChanged method name, but with different parameter types.
- Change DefaultTrackSelector.buildUponParameters and DefaultTrackSelector.Parameters.buildUpon to return DefaultTrackSelector.Parameters.Builder instead of the deprecated DefaultTrackSelector.ParametersBuilder .
- Add DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities which is enabled by default. When enabled, the DefaultTrackSelector will prefer audio tracks whose channel count does not exceed the device output capabilities. On handheld devices, the DefaultTrackSelector will prefer stereo/mono over multichannel audio formats, unless the multichannel format can be Spatialized (Android 12L+) or is a Dolby surround sound format. In addition, on devices that support audio spatialization, the DefaultTrackSelector will monitor for changes in the Spatializer properties and trigger a new track selection upon these. Devices with a television UI mode are excluded from these constraints and the format with the highest channel count will be preferred. To enable this feature, the DefaultTrackSelector instance must be constructed with a Context .
Видео:
- Rename DummySurface to PlaceholderSurface .
- Add AV1 support to the MediaCodecVideoRenderer.getCodecMaxInputSize .
Audio:
- Use LG AC3 audio decoder advertising non-standard MIME type.
- Change the return type of AudioAttributes.getAudioAttributesV21() from android.media.AudioAttributes to a new AudioAttributesV21 wrapper class, to prevent slow ART verification on API < 21.
- Query the platform (API 29+) or assume the audio encoding channel count for audio passthrough when the format audio channel count is unset, which occurs with HLS chunkless preparation ( 10204 ).
- Configure AudioTrack with channel mask AudioFormat.CHANNEL_OUT_7POINT1POINT4 if the decoder outputs 12 channel PCM audio ( #10322 .
DRM
- Ensure the DRM session is always correctly updated when seeking immediately after a format change ( 10274 ).
Текст:
- Change Player.getCurrentCues() to return CueGroup instead of List<Cue> .
- SSA: Support OutlineColour style setting when BorderStyle == 3 (ie OutlineColour sets the background of the cue) ( #8435 ).
- CEA-708: Parse data into multiple service blocks and ignore blocks not associated with the currently selected service number.
- Remove RawCcExtractor , which was only used to handle a Google-internal subtitle format.
Extractors:
- Add support for AVI ( #2092 ).
- Matroska: Parse DiscardPadding for Opus tracks.
- MP4: Parse bitrates from esds boxes.
- Ogg: Allow duplicate Opus ID and comment headers ( #10038 ).
UI:
- Fix delivery of events to OnClickListener s set on PlayerView in the case that useController=false ( #9605 ). Also fix delivery of events to OnLongClickListener for all view configurations.
- Fix incorrectly treating a sequence of touch events that exit the bounds of PlayerView before ACTION_UP as a click ( #9861 ).
- Fix PlayerView accessibility issue where tapping might toggle playback rather than hiding the controls ( #8627 ).
- Rewrite TrackSelectionView and TrackSelectionDialogBuilder to work with the Player interface rather than ExoPlayer . This allows the views to be used with other Player implementations, and removes the dependency from the UI module to the ExoPlayer module. This is a breaking change.
- Don't show forced text tracks in the PlayerView track selector, and keep a suitable forced text track selected if "None" is selected ( #9432 ).
БРОСАТЬСЯ:
- Parse channel count from DTS AudioChannelConfiguration elements. This re-enables audio passthrough for DTS streams ( #10159 ).
- Disallow passing null to DashMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
HLS:
- Fallback to chunkful preparation if the playlist CODECS attribute does not contain the audio codec ( #10065 ).
- Disallow passing null to HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory , HlsMediaSource.Factory.setPlaylistParserFactory , and HlsMediaSource.Factory.setPlaylistTrackerFactory . Instances of DefaultCompositeSequenceableLoaderFactory , DefaultHlsPlaylistParserFactory , or a reference to DefaultHlsPlaylistTracker.FACTORY can be passed explicitly if required.
Smooth Streaming:
- Disallow passing null to SsMediaSource.Factory.setCompositeSequenceableLoaderFactory . Instances of DefaultCompositeSequenceableLoaderFactory can be passed explicitly if required.
RTSP:
- Add RTP reader for H263 ( #63 ).
- Add RTP reader for MPEG4 ( #35 ).
- Add RTP reader for HEVC ( #36 ).
- Add RTP reader for AMR. Currently only mono-channel, non-interleaved AMR streams are supported. Compound AMR RTP payload is not supported. ( #46 )
- Add RTP reader for VP8 ( #47 ).
- Add RTP reader for WAV ( #56 ).
- Fix RTSP basic authorization header. ( #9544 ).
- Stop checking mandatory SDP fields as ExoPlayer doesn't need them ( #10049 ).
- Throw checked exception when parsing RTSP timing ( #10165 ).
- Add RTP reader for VP9 ( #47 ).
- Add RTP reader for OPUS ( #53 ).
Data sources:
- Rename DummyDataSource to PlaceholderDataSource .
- Workaround OkHttp interrupt handling.
Сессия:
- Replace MediaSession.MediaItemFiller with MediaSession.Callback.onAddMediaItems to allow asynchronous resolution of requests.
- Support setMediaItems(s) methods when MediaController connects to a legacy media session.
- Remove MediaController.setMediaUri and MediaSession.Callback.onSetMediaUri . The same functionality can be achieved by using MediaController.setMediaItem and MediaSession.Callback.onAddMediaItems .
- Forward legacy MediaController calls to play media to MediaSession.Callback.onAddMediaItems instead of onSetMediaUri .
- Add MediaNotification.Provider and DefaultMediaNotificationProvider to provide customization of the notification.
- Add BitmapLoader and SimpleBitmapLoader for downloading artwork images.
- Add MediaSession.setCustomLayout() to provide backwards compatibility with the legacy session.
- Add MediaSession.setSessionExtras() to provide feature parity with legacy session.
- Rename MediaSession.MediaSessionCallback to MediaSession.Callback , MediaLibrarySession.MediaLibrarySessionCallback to MediaLibrarySession.Callback and MediaSession.Builder.setSessionCallback to setCallback .
- Fix NPE in MediaControllerImplLegacy ( #59 ).
- Update session position info on timeline change( #51 ).
- Fix NPE in MediaControllerImplBase after releasing controller ( #74 ).
Ad playback / IMA:
- Decrease ad polling rate from every 100ms to every 200ms, to line up with Media Rating Council (MRC) recommendations.
FFmpeg extension:
- Update CMake version to 3.21.0+ to avoid a CMake bug causing AndroidStudio's gradle sync to fail ( #9933 ).
Remove deprecated symbols:
- Remove Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray) . Use Player.Listener.onTracksChanged(Tracks) instead.
- Remove Player.getCurrentTrackGroups and Player.getCurrentTrackSelections . Use Player.getCurrentTracks instead. You can also continue to use ExoPlayer.getCurrentTrackGroups and ExoPlayer.getCurrentTrackSelections , although these methods remain deprecated.
- Remove DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT and DEFAULT_TRACK_SELECTOR_PARAMETERS constants. Use getDefaultTrackSelectorParameters(Context) instead when possible, and DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT otherwise.
- Remove constructor DefaultTrackSelector(ExoTrackSelection.Factory) . Use DefaultTrackSelector(Context, ExoTrackSelection.Factory) instead.
- Remove Transformer.Builder.setContext . The Context should be passed to the Transformer.Builder constructor instead.

Version 1.0.0-alpha03

14 марта 2022 г.

androidx.media3:media3-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

This corresponds to the ExoPlayer 2.17.1 release .

Audio:
- Fix error checking audio capabilities for Dolby Atmos (E-AC3-JOC) in HLS.
Extractors:
- FMP4: Fix issue where emsg sample metadata could be output in the wrong order for streams containing both v0 and v1 emsg atoms ( #9996 ).
Текст:
- Fix the interaction of SingleSampleMediaSource.Factory.setTrackId and MediaItem.SubtitleConfiguration.Builder.setId to prioritise the SubtitleConfiguration field and fall back to the Factory value if it's not set ( #10016 ).
Ad playback:
- Fix audio underruns between ad periods in live HLS SSAI streams.

Version 1.0.0-alpha02

March 2, 2022

androidx.media3:media3-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

This corresponds to the ExoPlayer 2.17.0 release .

Core Library:
- Add protected method DefaultRenderersFactory.getCodecAdapterFactory() so that subclasses of DefaultRenderersFactory that override buildVideoRenderers() or buildAudioRenderers() can access the codec adapter factory and pass it to MediaCodecRenderer instances they create.
- Propagate ICY header fields name and genre to MediaMetadata.station and MediaMetadata.genre respectively so that they reach the app via Player.Listener.onMediaMetadataChanged() ( #9677 ).
- Remove null keys from DefaultHttpDataSource#getResponseHeaders .
- Sleep and retry when creating a MediaCodec instance fails. This works around an issue that occurs on some devices when switching a surface from a secure codec to another codec ( #8696 ).
- Add MediaCodecAdapter.getMetrics() to allow users obtain metrics data from MediaCodec . ( #9766 ).
- Fix Maven dependency resolution ( #8353 ).
- Disable automatic speed adjustment for live streams that neither have low-latency features nor a user request setting the speed ( #9329 ).
- Rename DecoderCounters#inputBufferCount to queuedInputBufferCount .
- Make SimpleExoPlayer.renderers private. Renderers can be accessed via ExoPlayer.getRenderer .
- Updated some AnalyticsListener.EventFlags constant values to match values in Player.EventFlags .
- Split AnalyticsCollector into an interface and default implementation to allow it to be stripped by R8 if an app doesn't need it.
Track selection:
- Support preferred video role flags in track selection ( #9402 ).
- Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation ( #9519 ).
- Update video and audio track selection logic to only choose formats for adaptive selections that have the same level of decoder and hardware support ( #9565 ).
- Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders ( #4835 ).
- Prefer audio content preferences (for example, the "default" audio track or a track matching the system locale language) over technical track selection constraints (for example, preferred MIME type, or maximum channel count).
- Fix track selection issue where overriding one track group did not disable other track groups of the same type ( #9675 ).
- Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly ( #9649 ).
- Prohibit duplicate TrackGroup s in a TrackGroupArray . TrackGroup s can always be made distinguishable by setting an id in the TrackGroup constructor. This fixes a crash when resuming playback after backgrounding the app with an active track override ( #9718 ).
- Amend logic in AdaptiveTrackSelection to allow a quality increase under sufficient network bandwidth even if playback is very close to the live edge ( #9784 ).
Видео:
- Fix decoder fallback logic for Dolby Vision to use a compatible H264/H265 decoder if needed.
Audio:
- Fix decoder fallback logic for Dolby Atmos (E-AC3-JOC) to use a compatible E-AC3 decoder if needed.
- Change AudioCapabilities APIs to require passing explicitly AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES instead of null .
- Allow customization of the AudioTrack buffer size calculation by injecting an AudioTrackBufferSizeProvider to DefaultAudioSink . ( #8891 ).
- Retry AudioTrack creation if the requested buffer size was > 1MB. ( #9712 ).
Extractors:
- WAV: Add support for RF64 streams ( #9543 ).
- Fix incorrect parsing of H.265 SPS NAL units ( #9719 ).
- Parse Vorbis Comments (including METADATA_BLOCK_PICTURE ) in Ogg Opus and Ogg Vorbis files.
Текст:
- Add a MediaItem.SubtitleConfiguration.id field which is propagated to the Format.id field of the subtitle track created from the configuration ( #9673 ).
- Add basic support for WebVTT subtitles in Matroska containers ( #9886 ).
- Prevent Cea708Decoder from reading more than the declared size of a service block.
DRM:
- Remove playbackLooper from DrmSessionManager.(pre)acquireSession . When a DrmSessionManager is used by an app in a custom MediaSource , the playbackLooper needs to be passed to DrmSessionManager.setPlayer instead.
Ad playback / IMA:
- Add support for IMA Dynamic Ad Insertion (DAI) ( #8213 ).
- Add a method to AdPlaybackState to allow resetting an ad group so that it can be played again ( #9615 ).
- Enforce playback speed of 1.0 during ad playback ( #9018 ).
- Fix issue where an ad group that failed to load caused an immediate playback reset ( #9929 ).
UI:
- Fix the color of the numbers in StyledPlayerView rewind and fastforward buttons when using certain themes ( #9765 ).
- Correctly translate playback speed strings ( #9811 ).
БРОСАТЬСЯ:
- Add parsed essential and supplemental properties to the Representation ( #9579 ).
- Support the forced-subtitle track role ( #9727 ).
- Stop interpreting the main track role as C.SELECTION_FLAG_DEFAULT .
- Fix base URL exclusion logic for manifests that do not declare the DVB namespace ( #9856 ).
- Support relative MPD.Location URLs ( #9939 ).
HLS:
- Correctly populate Format.label for audio only HLS streams ( #9608 ).
- Use chunkless preparation by default to improve start up time. If your renditions contain muxed closed-caption tracks that are not declared in the master playlist, you should add them to the master playlist to be available for playback, or turn off chunkless preparation with HlsMediaSource.Factory.setAllowChunklessPreparation(false) .
- Support key-frame accurate seeking in HLS ( #2882 ).
RTSP:
- Provide a client API to override the SocketFactory used for any server connection ( #9606 ).
- Prefer DIGEST authentication method over BASIC if both are present ( #9800 ).
- Handle when RTSP track timing is not available ( #9775 ).
- Ignore invalid RTP-Info header values ( #9619 ).
Transformer:
- Increase required min API version to 21.
- TransformationException is now used to describe errors that occur during a transformation.
- Add TransformationRequest for specifying the transformation options.
- Allow multiple listeners to be registered.
- Fix Transformer being stuck when the codec output is partially read.
- Fix potential NPE in Transformer.getProgress when releasing the muxer throws.
- Add a demo app for applying transformations.
MediaSession extension:
- By default, MediaSessionConnector now clears the playlist on stop. Apps that want the playlist to be retained can call setClearMediaItemsOnStop(false) on the connector.
Cast extension:
- Fix bug that prevented CastPlayer from calling onIsPlayingChanged correctly ( #9792 ).
- Support audio metadata including artwork with DefaultMediaItemConverter ( #9663 ).
FFmpeg extension:
- Make build_ffmpeg.sh depend on LLVM's bin utils instead of GNU's ( #9933 ).
Android 12 compatibility:
- Upgrade the Cast extension to depend on com.google.android.gms:play-services-cast-framework:20.1.0 . Earlier versions of play-services-cast-framework are not compatible with apps targeting Android 12, and will crash with an IllegalArgumentException when creating PendingIntent s ( #9528 ).
Remove deprecated symbols:
- Remove Player.EventListener . Use Player.Listener instead.
- Remove MediaSourceFactory#setDrmSessionManager , MediaSourceFactory#setDrmHttpDataSourceFactory , and MediaSourceFactory#setDrmUserAgent . Use MediaSourceFactory#setDrmSessionManagerProvider instead.
- Remove MediaSourceFactory#setStreamKeys . Use MediaItem.Builder#setStreamKeys instead.
- Remove MediaSourceFactory#createMediaSource(Uri) . Use MediaSourceFactory#createMediaSource(MediaItem) instead.
- Remove setTag from DashMediaSource , HlsMediaSource and SsMediaSource . Use MediaItem.Builder#setTag instead.
- Remove DashMediaSource#setLivePresentationDelayMs(long, boolean) . Use MediaItem.Builder#setLiveConfiguration and MediaItem.LiveConfiguration.Builder#setTargetOffsetMs to override the manifest, or DashMediaSource#setFallbackTargetLiveOffsetMs to provide a fallback value.
- Remove (Simple)ExoPlayer.setThrowsWhenUsingWrongThread . Opting out of the thread enforcement is no longer possible.
- Remove ActionFile and ActionFileUpgradeUtil . Use ExoPlayer 2.16.1 or before to use ActionFileUpgradeUtil to merge legacy action files into DefaultDownloadIndex .
- Remove ProgressiveMediaSource#setExtractorsFactory . Use ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) constructor instead.
- Remove ProgressiveMediaSource.Factory#setTag and, and ProgressiveMediaSource.Factory#setCustomCacheKey . Use MediaItem.Builder#setTag and MediaItem.Builder#setCustomCacheKey instead.
- Remove DefaultRenderersFactory(Context, @ExtensionRendererMode int) and DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) constructors. Use the DefaultRenderersFactory(Context) constructor, DefaultRenderersFactory#setExtensionRendererMode , and DefaultRenderersFactory#setAllowedVideoJoiningTimeMs instead.
- Remove all public CronetDataSource constructors. Use CronetDataSource.Factory instead.
Change the following IntDefs to @Target(TYPE_USE) only. This may break the compilation of usages in Kotlin, which can be fixed by moving the annotation to annotate the type ( Int ).
- @AacAudioObjectType
- @Ac3Util.SyncFrameInfo.StreamType
- @AdLoadException.Type
- @AdtsExtractor.Flags
- @AmrExtractor.Flags
- @AspectRatioFrameLayout.ResizeMode
- @AudioFocusManager.PlayerCommand
- @AudioSink.SinkFormatSupport
- @BinarySearchSeeker.TimestampSearchResult.Type
- @BufferReplacementMode
- @C.BufferFlags
- @C.ColorRange
- @C.ColorSpace
- @C.ColorTransfer
- @C.CryptoMode
- @C.Encoding
- @C.PcmEncoding
- @C.Projection
- @C.SelectionReason
- @C.StereoMode
- @C.VideoOutputMode
- @CacheDataSource.Flags
- @CaptionStyleCompat.EdgeType
- @DataSpec.Flags
- @DataSpec.HttpMethods
- @DecoderDiscardReasons
- @DecoderReuseResult
- @DefaultAudioSink.OutputMode
- @DefaultDrmSessionManager.Mode
- @DefaultTrackSelector.SelectionEligibility
- @DefaultTsPayloadReaderFactory.Flags
- @EGLSurfaceTexture.SecureMode
- @EbmlProcessor.ElementType
- @ExoMediaDrm.KeyRequest.RequestType
- @ExtensionRendererMode
- @Extractor.ReadResult
- @FileTypes.Type
- @FlacExtractor.Flags (in com.google.android.exoplayer2.ext.flac package)
- @FlacExtractor.Flags (in com.google.android.exoplayer2.extractor.flac package)
- @FragmentedMp4Extractor.Flags
- @HlsMediaPlaylist.PlaylistType
- @HttpDataSourceException.Type
- @IllegalClippingException.Reason
- @IllegalMergeException.Reason
- @LoadErrorHandlingPolicy.FallbackType
- @MatroskaExtractor.Flags
- @Mp3Extractor.Flags
- @Mp4Extractor.Flags
- @NotificationUtil.Importance
- @PlaybackException.FieldNumber
- @PlayerNotificationManager.Priority
- @PlayerNotificationManager.Visibility
- @PlayerView.ShowBuffering
- @Renderer.State
- @RendererCapabilities.AdaptiveSupport
- @RendererCapabilities.Capabilities
- @RendererCapabilities.DecoderSupport
- @RendererCapabilities.FormatSupport
- @RendererCapabilities.HardwareAccelerationSupport
- @RendererCapabilities.TunnelingSupport
- @SampleStream.ReadDataResult
- @SampleStream.ReadFlags
- @StyledPlayerView.ShowBuffering
- @SubtitleView.ViewType
- @TextAnnotation.Position
- @TextEmphasisSpan.MarkFill
- @TextEmphasisSpan.MarkShape
- @Track.Transformation
- @TrackOutput.SampleDataPart
- @Transformer.ProgressState
- @TsExtractor.Mode
- @TsPayloadReader.Flags
- @WebvttCssStyle.FontSizeUnit

Version 1.0.0-alpha01

October 27, 2021

androidx.media3:media3-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

Новые возможности

Media3 is the new home for media support libraries, including ExoPlayer. The first alpha contains early, functional implementations of libraries for implementing media use cases, including:

ExoPlayer, an application-level media player for Android that is easy to customize and extend.
Media session functionality, for exposing and controlling playbacks. This new session module uses the same Player interface as ExoPlayer.
UI components for building media playback user interfaces.
Modules wrapping functionality in other libraries for use with ExoPlayer, for example, ad insertion via the IMA SDK.

For more information, see the Media3 GitHub project .

ExoPlayer was previously hosted in a separate ExoPlayer GitHub project . In Media3 its package name is androidx.media3.exoplayer . We plan to continue to maintain and release the ExoPlayer GitHub project for a while to give apps time to migrate to Media3. Media3 has replacements for all the ExoPlayer modules, except for the legacy media2 and mediasession extensions, which are replaced by the new media3-session module. This provides direct integration between players and media sessions without needing to use an adapter/connector class.