Bump media from 1.4.1 to 1.5.0

[dependabot]

Bumps media from 1.4.1 to 1.5.0.
Updates androidx.media3:media3-exoplayer from 1.4.1 to 1.5.0

Release notes

Sourced from androidx.media3:media3-exoplayer's releases.

1.5.0

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled (#1616).
  • Allow playback regardless of buffered duration when loading fails (#1571).
  • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • Fix MediaCodec.CryptoException sometimes being reported as an "unexpected runtime error" when MediaCodec is operated in asynchronous mode (default behaviour on API 31+).
  • Pass bufferedDurationUs instead of bufferedPositionUs with PreloadMediaSource.PreloadControl.onContinueLoadingRequested(). Also changes DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS to DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS, apps then need to pass a value representing a specific duration from the default start position for which the corresponding media source has to be preloaded with this IntDef, instead of a position.
  • Add ForwardingRenderer implementation that forwards all method calls to another renderer (1703).
  • Add playlist preloading for the next item in the playlist. Apps can enable preloading by calling ExoPlayer.setPreloadConfiguration(PreloadConfiguration) accordingly. By default preloading is disabled. When opted-in and to not interfere with playback, DefaultLoadControl restricts preloading to start and continue only when the player is not loading for playback. Apps can change this behaviour by implementing LoadControl.shouldContinuePreloading() accordingly (like when overriding this method in DefaultLoadControl). The default implementation of LoadControl disables preloading in case an app is using a custom implementation of LoadControl.
  • Add method MediaSourceEventListener.EventDispatcher.dispatchEvent() to allow invoking events of subclass listeners (1736).
  • Add DefaultPreloadManager.Builder that builds the DefaultPreloadManager and ExoPlayer instances with consistently shared configurations.
  • Remove Renderer[] parameter from LoadControl.onTracksSelected() as DefaultLoadControl implementation can retrieve the stream types from ExoTrackSelection[].
  • Deprecated DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) and marked method as final to prevent overrides. The new DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) should be used instead.
  • Report MediaSourceEventListener events from secondary sources in MergingMediaSource. This will result in load start/error/cancelled/completed events being reported for sideloaded subtitles (those added with MediaItem.LocalConfiguration.subtitleConfigurations), which may appear as duplicate load events emitted from AnalyticsListener.
  • Prevent subtitle & metadata errors from completely stopping playback. Instead the problematic track is disabled and playback of the remaining tracks continues (#1722).
    • In new subtitle handling (during extraction), associated parse (e.g. invalid subtitle data) and load errors (e.g. HTTP 404) are emitted via onLoadError callbacks.
    • In legacy subtitle handling (during rendering), only associated load errors are emitted via onLoadError callbacks while parse errors are silently ignored (this is pre-existing behaviour).
  • Fix bug where playlist items or periods in multi-period DASH streams with durations that don't match the actual content could cause frame freezes at the end of the item (#1698).
  • Add a setter to SntpClient to set the max elapsed time since the last update after which the client is re-initialized (#1794).
• Transformer:
  • Add SurfaceAssetLoader, which supports queueing video data to Transformer via a Surface.
  • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException.
  • Make setting the image duration using MediaItem.Builder.setImageDurationMs mandatory for image export.
  • Add export support for gaps in sequences of audio EditedMediaItems.
• Track Selection:
  • DefaultTrackSelector: Prefer object-based audio over channel-based audio when other factors are equal.
• Extractors:
  • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
  • Add option to enable index-based seeking in AmrExtractor.
  • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563).
  • Fix preroll sample handling for non-keyframe media start positions when processing edit lists in MP4 files (#1659).
  • Improved frame rate calculation by using media duration from the mdhd box in Mp4Extractor and FragmentedMp4Extractor (#1531).
  • Fix incorrect scaling of media_time in MP4 edit lists. While segment_duration was already correctly scaled using the movie timescale, media_time is now properly scaled using the track timescale, as specified by the MP4 format standard (#1792).
  • Handle out-of-order frames in endIndices calculation for MP4 with edit list (#1797).

... (truncated)

Changelog

Sourced from androidx.media3:media3-exoplayer's changelog.

1.5.0 (2024-11-27)

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to

... (truncated)

Commits

• cc8439d Bump Media3 version to 1.5.0
• 46a5f0f Merge release notes for media3 1.5.0 stable release
• f63069e Move misplaced release note to Unreleased changes section
• 8bab423 Bump media3 version to 1.5.0-rc02
• 737fdd8 Deflake the DefaultPreloadManagerTest
• fd02ee1 Release notes for 1.5.0-rc01
• ef90f50 Don't assume MP4 keyframe metadata is correct for CEA re-ordering
• 47f3aab Merge pull request #1265 from DolbyLaboratories:dlb/ac4-level4/dev_new2
• 57d0721 Resolve the memory leaks in demo short-form app
• a46716c Handle C.TIME_END_OF_SOURCE buffer timestamps in CeaDecoder
• Additional commits viewable in compare view

Updates androidx.media3:media3-exoplayer-hls from 1.4.1 to 1.5.0

Release notes

Sourced from androidx.media3:media3-exoplayer-hls's releases.

1.5.0

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled (#1616).
  • Allow playback regardless of buffered duration when loading fails (#1571).
  • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • Fix MediaCodec.CryptoException sometimes being reported as an "unexpected runtime error" when MediaCodec is operated in asynchronous mode (default behaviour on API 31+).
  • Pass bufferedDurationUs instead of bufferedPositionUs with PreloadMediaSource.PreloadControl.onContinueLoadingRequested(). Also changes DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS to DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS, apps then need to pass a value representing a specific duration from the default start position for which the corresponding media source has to be preloaded with this IntDef, instead of a position.
  • Add ForwardingRenderer implementation that forwards all method calls to another renderer (1703).
  • Add playlist preloading for the next item in the playlist. Apps can enable preloading by calling ExoPlayer.setPreloadConfiguration(PreloadConfiguration) accordingly. By default preloading is disabled. When opted-in and to not interfere with playback, DefaultLoadControl restricts preloading to start and continue only when the player is not loading for playback. Apps can change this behaviour by implementing LoadControl.shouldContinuePreloading() accordingly (like when overriding this method in DefaultLoadControl). The default implementation of LoadControl disables preloading in case an app is using a custom implementation of LoadControl.
  • Add method MediaSourceEventListener.EventDispatcher.dispatchEvent() to allow invoking events of subclass listeners (1736).
  • Add DefaultPreloadManager.Builder that builds the DefaultPreloadManager and ExoPlayer instances with consistently shared configurations.
  • Remove Renderer[] parameter from LoadControl.onTracksSelected() as DefaultLoadControl implementation can retrieve the stream types from ExoTrackSelection[].
  • Deprecated DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) and marked method as final to prevent overrides. The new DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) should be used instead.
  • Report MediaSourceEventListener events from secondary sources in MergingMediaSource. This will result in load start/error/cancelled/completed events being reported for sideloaded subtitles (those added with MediaItem.LocalConfiguration.subtitleConfigurations), which may appear as duplicate load events emitted from AnalyticsListener.
  • Prevent subtitle & metadata errors from completely stopping playback. Instead the problematic track is disabled and playback of the remaining tracks continues (#1722).
    • In new subtitle handling (during extraction), associated parse (e.g. invalid subtitle data) and load errors (e.g. HTTP 404) are emitted via onLoadError callbacks.
    • In legacy subtitle handling (during rendering), only associated load errors are emitted via onLoadError callbacks while parse errors are silently ignored (this is pre-existing behaviour).
  • Fix bug where playlist items or periods in multi-period DASH streams with durations that don't match the actual content could cause frame freezes at the end of the item (#1698).
  • Add a setter to SntpClient to set the max elapsed time since the last update after which the client is re-initialized (#1794).
• Transformer:
  • Add SurfaceAssetLoader, which supports queueing video data to Transformer via a Surface.
  • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException.
  • Make setting the image duration using MediaItem.Builder.setImageDurationMs mandatory for image export.
  • Add export support for gaps in sequences of audio EditedMediaItems.
• Track Selection:
  • DefaultTrackSelector: Prefer object-based audio over channel-based audio when other factors are equal.
• Extractors:
  • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
  • Add option to enable index-based seeking in AmrExtractor.
  • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563).
  • Fix preroll sample handling for non-keyframe media start positions when processing edit lists in MP4 files (#1659).
  • Improved frame rate calculation by using media duration from the mdhd box in Mp4Extractor and FragmentedMp4Extractor (#1531).
  • Fix incorrect scaling of media_time in MP4 edit lists. While segment_duration was already correctly scaled using the movie timescale, media_time is now properly scaled using the track timescale, as specified by the MP4 format standard (#1792).
  • Handle out-of-order frames in endIndices calculation for MP4 with edit list (#1797).

... (truncated)

Changelog

Sourced from androidx.media3:media3-exoplayer-hls's changelog.

1.5.0 (2024-11-27)

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to

... (truncated)

Commits

• cc8439d Bump Media3 version to 1.5.0
• 46a5f0f Merge release notes for media3 1.5.0 stable release
• f63069e Move misplaced release note to Unreleased changes section
• 8bab423 Bump media3 version to 1.5.0-rc02
• 737fdd8 Deflake the DefaultPreloadManagerTest
• fd02ee1 Release notes for 1.5.0-rc01
• ef90f50 Don't assume MP4 keyframe metadata is correct for CEA re-ordering
• 47f3aab Merge pull request #1265 from DolbyLaboratories:dlb/ac4-level4/dev_new2
• 57d0721 Resolve the memory leaks in demo short-form app
• a46716c Handle C.TIME_END_OF_SOURCE buffer timestamps in CeaDecoder
• Additional commits viewable in compare view

Updates androidx.media3:media3-exoplayer-workmanager from 1.4.1 to 1.5.0

Release notes

Sourced from androidx.media3:media3-exoplayer-workmanager's releases.

1.5.0

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled (#1616).
  • Allow playback regardless of buffered duration when loading fails (#1571).
  • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • Fix MediaCodec.CryptoException sometimes being reported as an "unexpected runtime error" when MediaCodec is operated in asynchronous mode (default behaviour on API 31+).
  • Pass bufferedDurationUs instead of bufferedPositionUs with PreloadMediaSource.PreloadControl.onContinueLoadingRequested(). Also changes DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS to DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS, apps then need to pass a value representing a specific duration from the default start position for which the corresponding media source has to be preloaded with this IntDef, instead of a position.
  • Add ForwardingRenderer implementation that forwards all method calls to another renderer (1703).
  • Add playlist preloading for the next item in the playlist. Apps can enable preloading by calling ExoPlayer.setPreloadConfiguration(PreloadConfiguration) accordingly. By default preloading is disabled. When opted-in and to not interfere with playback, DefaultLoadControl restricts preloading to start and continue only when the player is not loading for playback. Apps can change this behaviour by implementing LoadControl.shouldContinuePreloading() accordingly (like when overriding this method in DefaultLoadControl). The default implementation of LoadControl disables preloading in case an app is using a custom implementation of LoadControl.
  • Add method MediaSourceEventListener.EventDispatcher.dispatchEvent() to allow invoking events of subclass listeners (1736).
  • Add DefaultPreloadManager.Builder that builds the DefaultPreloadManager and ExoPlayer instances with consistently shared configurations.
  • Remove Renderer[] parameter from LoadControl.onTracksSelected() as DefaultLoadControl implementation can retrieve the stream types from ExoTrackSelection[].
  • Deprecated DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) and marked method as final to prevent overrides. The new DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) should be used instead.
  • Report MediaSourceEventListener events from secondary sources in MergingMediaSource. This will result in load start/error/cancelled/completed events being reported for sideloaded subtitles (those added with MediaItem.LocalConfiguration.subtitleConfigurations), which may appear as duplicate load events emitted from AnalyticsListener.
  • Prevent subtitle & metadata errors from completely stopping playback. Instead the problematic track is disabled and playback of the remaining tracks continues (#1722).
    • In new subtitle handling (during extraction), associated parse (e.g. invalid subtitle data) and load errors (e.g. HTTP 404) are emitted via onLoadError callbacks.
    • In legacy subtitle handling (during rendering), only associated load errors are emitted via onLoadError callbacks while parse errors are silently ignored (this is pre-existing behaviour).
  • Fix bug where playlist items or periods in multi-period DASH streams with durations that don't match the actual content could cause frame freezes at the end of the item (#1698).
  • Add a setter to SntpClient to set the max elapsed time since the last update after which the client is re-initialized (#1794).
• Transformer:
  • Add SurfaceAssetLoader, which supports queueing video data to Transformer via a Surface.
  • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException.
  • Make setting the image duration using MediaItem.Builder.setImageDurationMs mandatory for image export.
  • Add export support for gaps in sequences of audio EditedMediaItems.
• Track Selection:
  • DefaultTrackSelector: Prefer object-based audio over channel-based audio when other factors are equal.
• Extractors:
  • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
  • Add option to enable index-based seeking in AmrExtractor.
  • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563).
  • Fix preroll sample handling for non-keyframe media start positions when processing edit lists in MP4 files (#1659).
  • Improved frame rate calculation by using media duration from the mdhd box in Mp4Extractor and FragmentedMp4Extractor (#1531).
  • Fix incorrect scaling of media_time in MP4 edit lists. While segment_duration was already correctly scaled using the movie timescale, media_time is now properly scaled using the track timescale, as specified by the MP4 format standard (#1792).
  • Handle out-of-order frames in endIndices calculation for MP4 with edit list (#1797).

... (truncated)

Changelog

Sourced from androidx.media3:media3-exoplayer-workmanager's changelog.

1.5.0 (2024-11-27)

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to

... (truncated)

Commits

• cc8439d Bump Media3 version to 1.5.0
• 46a5f0f Merge release notes for media3 1.5.0 stable release
• f63069e Move misplaced release note to Unreleased changes section
• 8bab423 Bump media3 version to 1.5.0-rc02
• 737fdd8 Deflake the DefaultPreloadManagerTest
• fd02ee1 Release notes for 1.5.0-rc01
• ef90f50 Don't assume MP4 keyframe metadata is correct for CEA re-ordering
• 47f3aab Merge pull request #1265 from DolbyLaboratories:dlb/ac4-level4/dev_new2
• 57d0721 Resolve the memory leaks in demo short-form app
• a46716c Handle C.TIME_END_OF_SOURCE buffer timestamps in CeaDecoder
• Additional commits viewable in compare view

Updates androidx.media3:media3-session from 1.4.1 to 1.5.0

Release notes

Sourced from androidx.media3:media3-session's releases.

1.5.0

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to Context.getSystemService(Context.AUDIO_SERVICE) until audio focus handling is enabled. This ensures the blocking call isn't done if audio focus handling is not enabled (#1616).
  • Allow playback regardless of buffered duration when loading fails (#1571).
  • Add AnalyticsListener.onRendererReadyChanged() to signal when individual renderers allow playback to be ready.
  • Fix MediaCodec.CryptoException sometimes being reported as an "unexpected runtime error" when MediaCodec is operated in asynchronous mode (default behaviour on API 31+).
  • Pass bufferedDurationUs instead of bufferedPositionUs with PreloadMediaSource.PreloadControl.onContinueLoadingRequested(). Also changes DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS to DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS, apps then need to pass a value representing a specific duration from the default start position for which the corresponding media source has to be preloaded with this IntDef, instead of a position.
  • Add ForwardingRenderer implementation that forwards all method calls to another renderer (1703).
  • Add playlist preloading for the next item in the playlist. Apps can enable preloading by calling ExoPlayer.setPreloadConfiguration(PreloadConfiguration) accordingly. By default preloading is disabled. When opted-in and to not interfere with playback, DefaultLoadControl restricts preloading to start and continue only when the player is not loading for playback. Apps can change this behaviour by implementing LoadControl.shouldContinuePreloading() accordingly (like when overriding this method in DefaultLoadControl). The default implementation of LoadControl disables preloading in case an app is using a custom implementation of LoadControl.
  • Add method MediaSourceEventListener.EventDispatcher.dispatchEvent() to allow invoking events of subclass listeners (1736).
  • Add DefaultPreloadManager.Builder that builds the DefaultPreloadManager and ExoPlayer instances with consistently shared configurations.
  • Remove Renderer[] parameter from LoadControl.onTracksSelected() as DefaultLoadControl implementation can retrieve the stream types from ExoTrackSelection[].
  • Deprecated DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) and marked method as final to prevent overrides. The new DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]) should be used instead.
  • Report MediaSourceEventListener events from secondary sources in MergingMediaSource. This will result in load start/error/cancelled/completed events being reported for sideloaded subtitles (those added with MediaItem.LocalConfiguration.subtitleConfigurations), which may appear as duplicate load events emitted from AnalyticsListener.
  • Prevent subtitle & metadata errors from completely stopping playback. Instead the problematic track is disabled and playback of the remaining tracks continues (#1722).
    • In new subtitle handling (during extraction), associated parse (e.g. invalid subtitle data) and load errors (e.g. HTTP 404) are emitted via onLoadError callbacks.
    • In legacy subtitle handling (during rendering), only associated load errors are emitted via onLoadError callbacks while parse errors are silently ignored (this is pre-existing behaviour).
  • Fix bug where playlist items or periods in multi-period DASH streams with durations that don't match the actual content could cause frame freezes at the end of the item (#1698).
  • Add a setter to SntpClient to set the max elapsed time since the last update after which the client is re-initialized (#1794).
• Transformer:
  • Add SurfaceAssetLoader, which supports queueing video data to Transformer via a Surface.
  • ImageAssetLoader reports unsupported input via AssetLoader.onError instead of throwing an IllegalStateException.
  • Make setting the image duration using MediaItem.Builder.setImageDurationMs mandatory for image export.
  • Add export support for gaps in sequences of audio EditedMediaItems.
• Track Selection:
  • DefaultTrackSelector: Prefer object-based audio over channel-based audio when other factors are equal.
• Extractors:
  • Allow Mp4Extractor and FragmentedMp4Extractor to identify H264 samples that are not used as reference by subsequent samples.
  • Add option to enable index-based seeking in AmrExtractor.
  • Treat MP3 files with more than 128kB between valid frames as truncated (instead of invalid). This means files with non-MP3 data at the end, with no other metadata to indicate the length of the MP3 bytes, now stop playback at the end of the MP3 data instead of failing with ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563).
  • Fix preroll sample handling for non-keyframe media start positions when processing edit lists in MP4 files (#1659).
  • Improved frame rate calculation by using media duration from the mdhd box in Mp4Extractor and FragmentedMp4Extractor (#1531).
  • Fix incorrect scaling of media_time in MP4 edit lists. While segment_duration was already correctly scaled using the movie timescale, media_time is now properly scaled using the track timescale, as specified by the MP4 format standard (#1792).
  • Handle out-of-order frames in endIndices calculation for MP4 with edit list (#1797).

... (truncated)

Changelog

Sourced from androidx.media3:media3-session's changelog.

1.5.0 (2024-11-27)

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (#1183).
  • Replace SimpleBasePlayer.State.playlist by getPlaylist() method.
  • Add override for SimpleBasePlayer.State.Builder.setPlaylist() to directly specify a Timeline and current Tracks and Metadata instead of building a playlist structure.
  • Increase minSdk to 21 (Android Lollipop). This is aligned with all other AndroidX libraries.
  • Add androidx.media3:media3-common-ktx artifact which provides Kotlin-specific functionality built on top of the Common library
  • Add Player.listen suspending extension function to spin a coroutine to listen to Player.Events to the media3-common-ktx library.
  • Remove @DoNotInline annotations from manually out-of-lined inner classes designed to avoid runtime class verification failures. Recent versions of R8 now automatically out-of-line calls like these to avoid the runtime failures (so the manual out-of-lining is no longer required). All Gradle users of the library must already be a using a version of the Android Gradle Plugin that uses a version of R8 which does this, due to compileSdk = 35. Users of the library with non-Gradle build systems will need to ensure their R8-equivalent shrinking/obfuscating step does a similar automatic out-of-lining process in order to avoid runtime class verification failures. This change has already been done in other AndroidX libraries.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() can now be called for every media item. Previously it was not called for the first one. Use MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() to enable this.
  • Add PreloadMediaSource.PreloadControl.onPreloadError to allow PreloadMediaSource.PreloadControl implementations to take actions when error occurs.
  • Add BasePreloadManager.Listener to propagate preload events to apps.
  • Allow changing SNTP client timeout and retry alternative addresses on timeout (#1540).
  • Remove MediaCodecAdapter.Configuration.flags as the field was always zero.
  • Allow the user to select the built-in speaker for playback on Wear OS API 35+ (where the device advertises support for this).
  • Defer the blocking call to

... (truncated)

Commits

• cc8439d Bump Media3 version to 1.5.0
• 46a5f0f Merge release notes for media3 1.5.0 stable release
• f63069e Move misplaced release note to Unreleased changes section
• 8bab423 Bump media3 version to 1.5.0-rc02
• 737fdd8 Deflake the DefaultPreloadManagerTest
• fd02ee1 Release notes for 1.5.0-rc01
• ef90f50 Don't assume MP4 keyframe metadata is correct for CEA re-ordering
• 47f3aab Merge pull request #1265 from DolbyLaboratories:dlb/ac4-level4/dev_new2
• 57d0721 Resolve the memory leaks in demo short-form app
• a46716c Handle C.TIME_END_OF_SOURCE buffer timestamps in CeaDecoder
• Additional commits viewable in compare view

Updates androidx.media3:media3-extractor from 1.4.1 to 1.5.0

Release notes

Sourced from androidx.media3:media3-extractor's releases.

1.5.0

This release includes the following changes since the 1.4.1 release:

• Common Library:
  • Add ForwardingSimpleBasePlayer that allows forwarding to another player with small adjustments while ensuring full consistency and listener handling (