- Common library:
- Promote
Player.mute() and Player.unmute() from UnstableApi to stable. - Promote
Format.pcmEncoding and C.PcmEncoding from UnstableApi to stable. - Add
Format.primaryTrackGroupId to identify the primary group of embedded Format instances #294.
- ExoPlayer:
- Add clipping capabilities to
AdsMediaSource. - Add support for dynamic scheduling in
MediaCodecVideoRenderer to better align scheduling work and CPU wake-cycles to when video frames can be processed. You can enable this using experimentalSetEnableMediaCodecVideoRendererDurationToProgressUs() in the DefaultRenderersFactory. - Allow setting a custom
DataSource.Factory in DefaultPreloadManager.Builder. - Allow
ExoPlayer to be mocked without Robolectric by moving some default constants to ExoPlayer.Builder. Mocking this complex interface is not generally encouraged - only when the usage is minimal/simple/incidental #2985.
- This required moving
DEFAULT_STUCK_PLAYING_DETECTION_TIMEOUT_MS from ExoPlayer to ExoPlayer.Builder (without deprecation).
- Fix a bug where
ProgressiveMediaSource propagates out-of-date timeline info to the player, and the queued periods unexpectedly get removed #3016. - Fix issue where ExoPlayer would not request delayed audio focus when playback is requested during phone calls.
- Fix bug where transitions from on-demand to live content may cause re-buffers at the end of the on-demand content #3052.
- Add support for Dolby Vision Profile 10 #2830.
- Fix bug where an uninitialized pre roll ad produced an
ArrayIndexOutOfBoundsException #3125.
- CompositionPlayer:
- Add support for
EditedMediaItem.removeVideo.
- Transformer:
EditedMediaItem.Builder.setFrameRate() can now set a maximum output frame rate for video, which is particularly helpful when increasing media speed with setSpeed().
- Track selection:
- Change signature of
DefaultTrackSelector.selectAllTracks to include the output array as a parameter, pre-populated with track overrides. - Fix issue where embedded metadata tracks are selected irrespective of whether the corresponding primary track is selected #294.
- Stabilize
TrackSelectionParameters options for preferredVideoLanguages, preferredVideoLabels, preferredAudioLabels, preferredTextLabels and selectTextByDefault.
- Extractors:
- MP4: Support files with large
uuid boxes before other boxes like moov #3046. - MP4: Add support for Versatile Video Coding (VVC) tracks in MP4 containers.
- Inspector:
- Breaking change: remove
FrameExtractor. Users should now depend on the new :media3-inspector-frame module and update imports to androidx.media3.inspector.frame.FrameExtractor. - Introduce a new module for extracting and processing decoded video frames.
- Audio:
- Change underlying decoding library for the IAMF decoder extension from
libiamf to iamf_tools. - IAMF decoding supports binaural output either through the decoder (when using the IAMF decoder extension) or through the Android Spatializer.
- Correctly remove support for
AC4Profile22 and other legacy profiles when assessing AC-4 decoder support in Automotive scenarios #2609. - Improve the retry logic of
AudioOutput initialization in DefaultAudioSink #2905. - Attempt to match the output layout of the speakers (or Spatializer if applicable) when decoding IAMF, both with the IAMF extension and media codec decoders, supported by new fields and logic in AudioCapabilities and AudioCapabilitiesReceiver.
- Fix bug where playback gets stuck when playing a playlist of gapless audio in compressed offload mode.
- Text:
- VobSub: Use
START and STOP SPU control commands to derive cue duration instead of always defaulting to 5 seconds #2935.
- Metadata:
- Increase default count of metadata renderers to four to cover all potential metadata tracks published by HLS variants and renditions #3043.
- Effect:
- Move
LottieOverlay to a new :media3-effect-lottie module (which also involved renaming it from androidx.media3.effect.LottieOverlay to androidx.media3.effect.lottie.LottieOverlay).
- Effect Lottie:
- Introduce a new
:media3-effect-lottie module which provides functionality for applying lottie effects to video frames.
- IMA extension:
- Update the IMA SDK version to 3.39.0 in order to have access to the latest Ad media info API.
- Fix a bug where the ad MIME type did not match the MIME type provided in the IMA LOADED event. The fix now maps the ad MIME type using the ad media info provided by IMA.
- Add
setEnableCustomTabs to ImaAdsLoader and ImaServerSideAdInsertionMediaSource, allowing users to control whether ad click-through URLs are launched using Custom Tabs. - Add the
ImaAdTagUriBuilder, a class that offers an alternative way to construct an adTagUri. It contains the setPreferredLinearOrientation API. This is an API in alpha testing that will allow you to set your preferred orientation for linear ads. If you want to join the alpha testing group, please reach out to your account partner.
- Session:
- Fix a bug where large arrays in
MediaMetadata.artworkData can crash the app. - Use type int for
@Player.Command argument in the ActionFactory interface #2933. - Make
MediaSessionService and MediaLibraryService a LifecycleService, allowing to attach lifecycle-aware operations to the service's lifecycle #187. - Stop supporting device volume change commands from
MediaController and MediaBrowser for local playbacks. Apps shouldn't change the local device volume, and if required, can use AudioManager APIs for this purpose. - Detect stale
Intent instances that started the service as a foreground service. This prevents a ForegroundServiceDidNotStartInTimeException being thrown by the system. This is a breaking change on an unstable API for apps implementing a custom MediaNotification.Provider as there is a new required method. - Add builders for
PendingIntent instances to be used with home screen widgets #2933. - Add static methods for creating
Intent instances for Compose-based home screen widgets #2933. - Fix a bug where the media item transition wasn't reported to controllers when playback transitioned from a given media item index to another with the same media item for discontinuity reason 'AUTO' and 'SEEK' #2997.
- Fix issue where system UI button placement workaround negatively affects other UI surface like Android Auto or manufacturers not needing the workaround #3041.
- Fix issue where access to subscriptions was not synchronized #3056.
- Workaround SysUI bug on API 29 where media session artwork in a particular size can crash SysUI and force the device to reboot #3118.
- Fix notification artwork icon scaling on Android Q #3084.
- UI:
- Add
PlaybackSpeedControl Composable to media3-ui-compose for displaying and modifying playback speed. - Add
PlaybackSpeedToggleButton Composable to media3-ui-compose-material3 for controlling playback speed. - Add
ProgressSlider Composable to media3-ui-compose-material3 for displaying player progress and performing seeks using dragging and tapping #2288. - Avoid large offscreen buffer in animating PlayerControlView.
- Add
Player Composable to media3-ui-compose-material3 which combines a ContentFrame with customizable controls aligned to top, center, and bottom. - Hide playback position from the accessibility service to prevent continuous announcement update when
PlayerControlView is visible.
- HLS extension:
- Support X-PLAYOUT-LIMIT with HLS interstitials #2484.
- Support the
QUERYPARAM attribute with #EXT-X-DEFINE #1854. - Optimize HLS playlist parsing by caching regular expression matchers #3008.
- Expose ID3 (EMSG) metadata track in audio renditions #3043.
- Allow location fallback upon encountering load errors, if redundant streams from different locations are available #1988.
- Fix X-SNAP behaviour for HLS interstitials to correctly calculate start and resumption position #3013.
- DASH extension:
- Fix issue where tracks with unaligned segment start times cause delays or missed samples at the beginning of playback #3057.
- Fix bug where timestamps of inband EMSG v0 metadata are not set correctly #3024.
- RTSP extension:
- Fixed regression in H.264 and H.265 streaming that would incorrectly parse samples of the same access unit that spanned multiple RTP packets. This resulted in visual artifacts and corruption in the video #3121.
- Decoder extensions (FFmpeg, VP9, AV1, etc.):
- Add MPEG-H UI manager support to the MPEG-H decoder extension #3066.
- Cast extension:
- Add
RemoteCastPlayer.Builder#setTrackSelector method that enables the implementation of track selection for Cast playbacks.
- Remove deprecated symbols:
- Remove
ExperimentalFrameExtractor. Use androidx.media3.inspector.frame.FrameExtractor instead. - Remove
ChannelMixingMatrix.create(). Use ChannelMixingMatrix.createForConstantGain() instead. - Remove
androidx.media3.extractor.metadata.flac.VorbisComment. Use androidx.media3.extractor.metadata.vorbis.VorbisComment instead. - Remove
MediaSource.prepareSource(MediaSourceCaller, TransferListener). Use MediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId) instead.