ExoPlayer

This is the last planned release of the com.google.android.exoplayer2 artifacts. This project is now deprecated. All users should migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

This release corresponds to the AndroidX Media3 1.1.1 release.

• 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.
• Video:
  • H.265/HEVC: Fix parsing SPS short and long term reference picture info.
• Text:
  • 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.

This is the last planned release of the com.google.android.exoplayer2 artifacts. This project is now deprecated. All users should migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

This release corresponds to the AndroidX Media3 1.1.0 release.

• 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, e.g. 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).
• Video:
  • 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.
• 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.

This release corresponds to the
AndroidX Media3 1.0.2 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).
• Text:
  • SSA: Add support for UTF-16 files if they start with a byte order mark (#319).

This release corresponds to the AndroidX Media3 1.0.1 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.
• DASH:
  • Fix handling of empty segment timelines (#11014).
• RTSP:
  • Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport (#11069).

This release corresponds to the AndroidX Media3 1.0.0 release.

There are no changes since 2.18.4.

This release corresponds to the AndroidX Media3 1.0.0-rc02 release.

• Core library:
  • Fix network type detection on API 33 (#10970).
  • Fix NullPointerException when calling ExoPlayer.isTunnelingEnabled (#10977).
• Downloads:
  • 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).
• Video:
  • 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.
• Cast:
  • Fix transient STATE_IDLE when transitioning between media items (#245).
• RTSP:
  • Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages (#10971).
• 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.

• 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).
• Text:
  • 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.
• DASH:
  • Add full parsing for image adaptation sets, including tile counts (#3752).
• UI:
  • Fix the deprecated StyledPlayerView.setControllerVisibilityListener(StyledPlayerControlView.VisibilityListener) to ensure visibility changes are passed to the registered listener (#229).
  • Fix the ordering of the center player controls in StyledPlayerView when using a right-to-left (RTL) layout (#227).
• 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.
  • Fix a bug which prevented playback from starting for a DAI stream without any ads.
  • Bump IMA SDK version to 3.29.0.
• Demo app:
  • Request notification permission for download notifications at runtime (#10884).

• Core library:
  • Add ExoPlayer.isTunnelingEnabled to check if tunneling is enabled for the currently selected tracks (https://github.com/google/ExoPlayer/issues/2518).
  • Add WrappingMediaSource to simplify wrapping a single MediaSource (https://github.com/google/ExoPlayer/issues/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 (https://github.com/androidx/media/issues/180).
  • Send missing onMediaItemTransition callback when calling seekToNext or seekToPrevious in a single-item playlist (https://github.com/google/ExoPlayer/issues/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 (https://github.com/google/ExoPlayer/issues/10758).
• Build:
  • Enforce minimum compileSdkVersion to avoid compilation errors (https://github.com/google/ExoPlayer/issues/10684).
  • Avoid publishing block when included in another gradle build.
• Track selection:
  • Prefer other tracks to Dolby Vision if display does not support it. (https://github.com/google/ExoPlayer/issues/8944).
• Downloads:
  • Fix potential infinite loop in ProgressiveDownloader caused by simultaneous download and playback with the same PriorityTaskManager (https://github.com/google/ExoPlayer/pull/10570).
  • Make download notification appear immediately (https://github.com/androidx/media/pull/183).
  • Limit parallel download removals to 1 to avoid excessive thread creation (https://github.com/google/ExoPlayer/issues/10458).
• Video:
  • Try alternative decoder for Dolby Vision if display does not support it. (https://github.com/google/ExoPlayer/issues/9794).
• Audio:
  • Use SingleThreadExecutor for releasing AudioTrack instances to avoid OutOfMemory errors when releasing multiple players at the same time (https://github.com/google/ExoPlayer/issues/10057).
  • Adds AudioOffloadListener.onExperimentalOffloadedPlayback for the AudioTrack offload state. (https://github.com/androidx/media/issues/134).
  • Make AudioTrackBufferSizeProvider a public interface.
  • Add ExoPlayer.setPreferredAudioDevice to set the preferred audio output device (https://github.com/androidx/media/issues/135).
  • Rename com.google.android.exoplayer2.audio.AudioProcessor to com.google.android.exoplayer2.audio.AudioProcessor.
  • Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions (https://github.com/google/ExoPlayer/issues/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 (e.g. Widevine to ClearKey).
• Text:
  • CEA-608: Ensure service switch commands on field 2 are handled correctly (https://github.com/google/ExoPlayer/issues/10666).
• DASH:
  • Parse EventStream.presentationTimeOffset from manifests (https://github.com/google/ExoPlayer/issues/10460).
• UI:
  • Use current overrides of the player as preset in TrackSelectionDialogBuilder (https://github.com/google/ExoPlayer/issues/10429).
• RTSP:
  • Add H263 fragmented packet handling (https://github.com/androidx/media/pull/119).
  • Add support for MP4A-LATM (https://github.com/androidx/media/pull/162).
• IMA:
  • Add timeout for loading ad information to handle cases where the IMA SDK gets stuck loading an ad (https://github.com/google/ExoPlayer/issues/10510).
  • Prevent skipping mid-roll ads when seeking to the end of the content (https://github.com/google/ExoPlayer/issues/10685).
  • Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI (https://github.com/google/ExoPlayer/issues/10764).
• FFmpeg extension:
  • Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above (https://github.com/google/ExoPlayer/issues/9933).
• AV1 extension:
  • Update CMake version to avoid incompatibilities with the latest Android Studio releases (https://github.com/google/ExoPlayer/issues/9933).
• Cast extension:
  • Implement getDeviceInfo() to be able to identify CastPlayer when controlling playback with a MediaController (https://github.com/androidx/media/issues/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.

This release corresponds to the AndroidX media3 1.0.0-beta02 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).
• DASH:
  • 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).
• Cast:
  • 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).

This release corresponds to the AndroidX media3 1.0.0-beta01 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.
• Video:
  • 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).
• Text:
  • Change Player.getCurrentCues() to return CueGroup instead of List<Cue>.
  • SSA: Support OutlineColour style setting when BorderStyle == 3 (i.e. 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:
  • 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 OnClickListeners set on StyledPlayerView and 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 StyledPlayerView and 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).
• DASH:
  • 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 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.
• 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.

This release corresponds to the AndroidX media3 1.0.0-alpha03 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).
• Text:
  • 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.

• Core library:
  • 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).
  • Prohibit duplicate TrackGroups in a TrackGroupArray. TrackGroups 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).
• Video:
  • 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:
  • Fix incorrect parsing of H.265 SPS NAL units (#9719).
  • Parse Vorbis Comments (including METADATA_BLOCK_PICTURE) in Ogg Opus and Ogg Vorbis files.
• Text:
  • 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).
• DASH:
  • 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:
  • 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).
  • Correctly populate Format.label for audio only HLS streams (#9608).
• 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.
  • The transformer module is no longer included by depending on com.google.android.exoplayer:exoplayer. To continue using transformer, add an additional dependency on com.google.android.exoplayer:exoplayer-transformer.
• 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 PendingIntents (#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, 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

• Core Library:
  • 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).
  • 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.
• Extractors:
  • WAV: Add support for RF64 streams (#9543).
• DASH:
  • Add parsed essential and supplemental properties to the Representation (#9579).
• HLS:
  • Correctly populate Format.label for audio only HLS streams (#9608).

• Core Library:
  • Deprecate SimpleExoPlayer. All functionality has been moved to ExoPlayer instead. ExoPlayer.Builder can be used instead of SimpleExoPlayer.Builder.
  • Add track selection methods to the Player interface, for example, Player.getCurrentTracksInfo and Player.setTrackSelectionParameters. These methods can be used instead of directly accessing the track selector.
  • Enable MediaCodec asynchronous queueing by default on devices with API level >= 31. Add methods in DefaultMediaCodecRendererFactory and DefaultRenderersFactory to force enable or force disable asynchronous queueing (6348).
  • Remove final dependency on jcenter().
  • Fix mediaMetadata being reset when media is repeated (#9458).
  • Adjust ExoPlayer MediaMetadata update priority, such that values input through the MediaItem.MediaMetadata are used above media derived values.
  • Move com.google.android.exoplayer2.device.DeviceInfo to com.google.android.exoplayer2.DeviceInfo.
  • Move com.google.android.exoplayer2.drm.DecryptionException to com.google.android.exoplayer2.decoder.CryptoException.
  • Move com.google.android.exoplayer2.upstream.cache.CachedRegionTracker to com.google.android.exoplayer2.upstream.CachedRegionTracker.
  • Move Player.addListener(EventListener) and Player.removeListener(EventListener) out of Player into subclasses.
• Android 12 compatibility:
  • Keep DownloadService started and in the foreground whilst waiting for requirements to be met on Android 12. This is necessary due to new foreground service launch restrictions. DownloadService.getScheduler will not be called on Android 12 devices.
  • Disable platform transcoding when playing content URIs on Android 12.
  • Add ExoPlayer.setVideoChangeFrameRateStrategy to allow disabling of calls from the player to Surface.setFrameRate. This is useful for applications wanting to call Surface.setFrameRate directly from application code with Android 12's Surface.CHANGE_FRAME_RATE_ALWAYS.
  • Upgrade the WorkManager extension to depend on androidx.work:work-runtime:2.7.0. Earlier versions of work-runtime
    are not compatible with apps targeting Android 12, and will crash with an IllegalArgumentException when creating PendingIntents (#9181).
• Video:
  • Fix bug in MediaCodecVideoRenderer that resulted in re-using a released Surface when playing without an app-provided Surface (#9476).
• DRM:
  • Log an error (instead of throwing IllegalStateException) when calling DefaultDrmSession#release() on a fully released session
    (#9392).
• UI:
  • SubtitleView no longer implements TextOutput. SubtitleView implements Player.Listener, so can be registered to a player with Player.addListener.
  • Fix initial timestamp display in PlayerControlView (#9524).
  • Fix capitalization of languages in the track selector (#9452).
• Extractors:
  • MP4: Correctly handle HEVC tracks with pixel aspect ratios other than 1.
  • MP4: Add support for Dolby TrueHD (only for unfragmented streams) (#9496).
  • MP4: Avoid throwing ArrayIndexOutOfBoundsException when parsing invalid colr boxes produced by some device cameras (#9332).
  • MP4: Parse HDR static metadata from the clli and mdcv boxes.
  • TS: Correctly handle HEVC tracks with pixel aspect ratios other than 1.
  • TS: Map stream type 0x80 to H262 (#9472).
• Downloads and caching:
  • Modify DownloadService behavior when DownloadService.getScheduler returns null, or returns a Scheduler that does not support the requirements for downloads to continue. In both cases, DownloadService will now remain started and in the foreground whilst waiting for requirements to be met.
  • Modify DownloadService behavior when running on Android 12 and above. See the "Android 12 compatibility" section above.
• RTSP:
  • Support RFC4566 SDP attribute field grammar (#9430).
• DASH:
  • Populate Format.sampleMimeType, width and height for image AdaptationSet elements (#9500).
• HLS:
  • Fix rounding error in HLS playlists (#9575).
  • Fix NoSuchElementException thrown when an HLS manifest declares #EXT-X-RENDITION-REPORT at the beginning of the playlist (#9592).
• RTMP extension:
  • Upgrade to io.antmedia:rtmp_client, which does not rely on jcenter() (#9591).
• MediaSession extension:
  • Rename MediaSessionConnector.QueueNavigator#onCurrentWindowIndexChanged to onCurrentMediaItemIndexChanged.
• Transformer:
  • Avoid sending a duplicate timestamp to the encoder with the end of stream buffer.
• Remove deprecated symbols:
  • Remove Renderer.VIDEO_SCALING_MODE_* constants. Use identically named constants in C instead.
  • Remove C.MSG_* constants. Use identically named constants in Renderer instead, except for C.MSG_SET_SURFACE, which is replaced with Renderer.MSG_SET_VIDEO_OUTPUT.
  • Remove DeviceListener. Use Player.Listener instead.
  • Remove CacheDataSourceFactory. Use CacheDataSource.Factory instead.
  • Remove CacheDataSinkFactory. Use CacheDataSink.Factory instead.
  • Remove FileDataSourceFactory. Use FileDataSource.Factory instead.
  • Remove SimpleExoPlayer.addMetadataOutput and removeMetadataOutput. Use Player.addListener and Player.Listener instead.
  • Remove SimpleExoPlayer.addAudioListener, removeAudioListener and AudioListener. Use Player.addListener and Player.Listener instead.
  • Remove SimpleExoPlayer.addVideoListener, removeVideoListener and VideoListener. Use Player.addListener and Player.Listener instead.
  • Remove DefaultHttpDataSourceFactory. Use DefaultHttpDataSource.Factory instead.
  • Remove SingleSampleMediaSource.createMediaSource(Uri, Format, long). Use SingleSampleMediaSource.createMediaSource(MediaItem.Subtitle, long) instead.
  • Remove HttpDataSource.Factory.getDefaultRequestProperties. Use HttpDataSource.Factory.setDefaultRequestProperties instead.
  • Remove GvrAudioProcessor and the GVR extension, which has been deprecated since 2.11.0.
  • Remove DownloadService.onDownloadChanged and DownloadService.onDownloadRemoved. Instead, use
    DownloadManager.addListener to register a listener directly to the DownloadManager returned through DownloadService.getDownloadManager.
  • Remove Player.getCurrentStaticMetadata, Player.Listener.onStaticMetadataChanged and
    Player.EVENT_STATIC_METADATA_CHANGED. Use Player.getMediaMetadata, Player.Listener.onMediaMetadataChanged and
    Player.EVENT_MEDIA_METADATA_CHANGED for convenient access to structured metadata, or access the raw static metadata directly from the TrackSelection#getFormat().
  • Remove ControlDispatcher and DefaultControlDispatcher. Operations can be customized by using a ForwardingPlayer, or when configuring the player (for example by using ExoPlayer.Builder.setSeekBackIncrementMs).

• Core Library:
  • Fix track selection in StyledPlayerControlView when using ForwardingPlayer.
  • Fix FlagSet#equals on API levels below 24.
  • Fix NullPointerException being thrown from CacheDataSource when reading a fully cached resource with DataSpec.position equal to the resource length.
  • Fix a bug when depending on ExoPlayer locally with a relative path (#9403).
  • Better handle invalid seek requests. Seeks to positions that are before the start or after the end of the media are now handled as seeks to the start and end respectively (8906).
  • Rename MimeTypes.AUDIO_DTS_UHD to MimeTypes.AUDIO_DTS_X and add required profile to its value (#9429).
• Extractors:
  • Support TS packets without PTS flag (#9294).
  • Fix issue decoding ID3 tags containing UTF-16 encoded strings (#9087).
• Video:
  • Request smaller decoder input buffers for Dolby Vision. This fixes an issue that could cause UHD Dolby Vision playbacks to fail on some devices, including Amazon Fire TV 4K.
• DRM:
  • Fix DefaultDrmSessionManager to correctly eagerly release preacquired DRM sessions when there's a shortage of DRM resources on the device.
• Downloads and caching:
  • Workaround platform issue that can cause a SecurityException to be thrown from Requirements.isInternetConnectivityValidated on devices running Android 11 (#9002).
• DASH:
  • Use identical cache keys for downloading and playing DASH segments (#9370).
  • Fix base URL selection and load error handling when base URLs are shared across adaptation sets.
• HLS:
  • Fix bug where the player would get stuck if all download attempts fail and would not raise an error to the application (#9390).
• RTSP:
  • Handle when additional spaces are in SDP's RTPMAP atrribute (#9379).
  • Handle partial URIs in RTP-Info headers (#9346).
  • Fix RTSP Session header handling (#9416).
  • Fix RTSP WWW-Authenticate header parsing (#9428).
• UI:
  • Use defStyleAttr when obtaining styled attributes in StyledPlayerView, PlayerView and PlayerControlView (#9024).
  • Fix accessibility focus in PlayerControlView (#9111).
  • Fix issue that StyledPlayerView and PlayerView don't update UI when available player commands change.
• Cast extension:
  • Implement CastPlayer.setPlaybackParameters(PlaybackParameters) to support setting the playback speed (#6784).

• Core Library:
  • Add MediaCodecAdapter.needsReconfiguration method.
  • Add getSeekBackIncrement, seekBack, getSeekForwardIncrement, seekForward, getMaxSeekToPreviousPosition, seekToPrevious and seekToNext methods to Player.
  • Rename Player methods:
    • hasPrevious to hasPreviousWindow.
    • previous to seekToPreviousWindow.
    • hasNext to hasNextWindow.
    • next to seekToNextWindow.
  • Rename Player commands:
    • COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM to COMMAND_SEEK_IN_CURRENT_WINDOW.
    • COMMAND_SEEK_TO_NEXT_MEDIA_ITEM to COMMAND_SEEK_TO_NEXT_WINDOW.
    • COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM to COMMAND_SEEK_TO_PREVIOUS_WINDOW.
    • COMMAND_SEEK_TO_MEDIA_ITEM to COMMAND_SEEK_TO_WINDOW.
    • COMMAND_GET_MEDIA_ITEMS to COMMAND_GET_TIMELINE.
  • Rename Player.EventFlags IntDef to Player.Event.
  • Make Player depend on the new PlaybackException class instead of ExoPlaybackException:
    • Player.getPlayerError now returns a PlaybackException.
    • Player.Listener.onPlayerError now receives a PlaybackException.
    • Add a new listener method Player.Listener.onPlayerErrorChanged, which is equivalent to onPlayerError except that it is also called when the player error becomes null.
    • Player implementations like ExoPlayer may use PlaybackException subclasses (like ExoPlaybackException), so users can downcast the PlaybackException instance to obtain implementation-specific fields (like ExoPlaybackException.rendererIndex).
  • PlaybackException introduces an errorCode which identifies the cause of the failure in order to simplify error handling (#1611).
  • Add a DefaultMediaDescriptionAdapter for the PlayerNotificationManager, that makes use of the Player MediaMetadata to populate the notification fields.
  • Add @FallbackType to LoadErrorHandlingPolicy to support customization of the exclusion duration for locations and tracks.
  • Change interface of LoadErrorHandlingPolicy to support configuring the behavior of track and location fallback. Location fallback is currently only supported for DASH manifests with multiple base URLs.
  • Restrict use of AudioTrack.isDirectPlaybackSupported to TVs, to avoid listing audio offload encodings as supported for passthrough mode on mobile devices (#9239).
• Extractors:
  • Add support for DTS-UHD in MP4 (#9163).
• Text:
  • TTML: Inherit the rubyPosition value from a containing <span ruby="container"> element.
  • WebVTT: Add support for CSS font-size property (#8964).
• Ad playback:
  • Support changing ad break positions in the player logic (#5067).
  • Support resuming content with an offset after an ad group.
• UI:
  • Add setUseRewindAction and setUseFastForwardAction to PlayerNotificationManager, and setUseFastForwardActionInCompactView and setUseRewindActionInCompactView to show the actions in compact view mode.
  • Remove rewind_increment and fastforward_increment attributes from PlayerControlView and StyledPlayerControlView. These increments can be customized by configuring the Player (see setSeekBackIncrementMs and setSeekForwardIncrementMs in SimpleExoPlayer.Builder), or by using a ForwardingPlayer that overrides getSeekBackIncrement, seekBack, getSeekForwardIncrement and seekForward. The rewind and fast forward buttons can be disabled by using a ForwardingPlayer that removes COMMAND_SEEK_BACK and COMMAND_SEEK_FORWARD from the available commands.
  • Update DefaultControlDispatcher getRewindIncrementMs and getFastForwardIncrementMs to take the player as parameter.
• DASH:
  • Add support for multiple base URLs and DVB attributes in the manifest. Apps that are using DefaultLoadErrorHandlingPolicy with such manifests have base URL fallback automatically enabled (#771, #7654).
• HLS:
  • Fix issue that could cause some playbacks to be stuck buffering (#8850, #9153).
  • Report audio track type in AnalyticsListener.onDownstreamFormatChanged() for audio-only playlists, so that the PlaybackStatsListener can derive audio format-related information (#9175).
• RTSP:
  • Use standard RTSP header names (#9182).
  • Handle an extra semicolon in SDP fmtp attribute (#9247).
  • Fix handling of special characters in the RTSP session ID (#9254).
• SmoothStreaming:
  • Propagate StreamIndex element Name attribute value as Format label (#9252).
• Cronet extension:
  • Add CronetDataSource.Factory.setRequestPriority to allow setting the priority of requests made by CronetDataSource instances.
• OkHttp extension:
  • Switch to OkHttp 4.9.1. This increases the extension's minimum SDK version requirement from 16 to 21.
• Remove deprecated symbols:
  • Remove CastPlayer specific playlist manipulation methods. Use setMediaItems, addMediaItems, removeMediaItem and moveMediaItem instead.
  • Remove Format.create methods. Use Format.Builder instead.
  • Remove MediaSource.getTag. Use MediaSource.getMediaItem and MediaItem.PlaybackProperties.tag instead.
  • Remove PlaybackPreparer. UI components that previously had setPlaybackPreparer methods will now call Player.prepare by default. If this behavior is sufficient, use of PlaybackPreparer can be removed from application code without replacement. For custom preparation logic, use a ForwardingPlayer that implements custom preparation logic in prepare.
  • Remove Player.Listener.onTimelineChanged(Timeline, Object, int). Use Player.Listener.onTimelineChanged(Timeline, int) instead. The manifest can be accessed using Player.getCurrentManifest.
  • Remove Player.getCurrentTag. Use Player.getCurrentMediaItem and MediaItem.PlaybackProperties.tag instead.
  • Remove Player.getPlaybackError. Use Player.getPlayerError instead.
  • Remove PlayerNotificationManager constructors and createWith methods. Use PlayerNotificationManager.Builder instead.
  • Remove PlayerNotificationManager.setNotificationListener. Use PlayerNotificationManager.Builder.setNotificationListener instead.
  • Remove PlayerNotificationManager setUseNavigationActions and setUseNavigationActionsInCompactView. Use setUseNextAction, setUsePreviousAction, setUseNextActionInCompactView and setUsePreviousActionInCompactView instead.
  • Remove setRewindIncrementMs and setFastForwardIncrementMs from UI components. These increments can be customized by configuring the Player (see setSeekBackIncrementMs and setSeekForwardIncrementMs in SimpleExoPlayer.Builder), or by using a ForwardingPlayer that overrides getSeekBackIncrement, seekBack, getSeekForwardIncrement and seekForward. The rewind and fast forward buttons can be disabled by using a ForwardingPlayer that removes COMMAND_SEEK_BACK and COMMAND_SEEK_FORWARD from the available commands.
  • Remove Timeline.getWindow(int, Window, boolean). Use Timeline.getWindow(int, Window) instead, which will always set tags.

• Core Library:
  • Explicitly mark several methods on SimpleExoPlayer as @Deprecated. These methods are all overrides and are already deprecated on Player and the respective ExoPlayer component classes (since 2.14.0).
• Video:
  • Fix IncorrectContextUseViolation strict mode warning on Android 11 (#8246).
• Audio:
  • Fix track selection for E-AC-3 streams.
  • Use AudioTrack.isDirectPlaybackSupported to check for encoded audio passthrough capability from API 29 onwards, instead of using the HDMI audio plug intent (#6500).
• Extractors:
  • Fix issue where a trun atom could be associated with the wrong track in an FMP4 stream (#9056). The fix removes a previous workaround to handle content in which the track_ID is set incorrectly (#4083). Such content is malformed and should be re-encoded.
  • Improve support for truncated Ogg streams (#7608).
  • Add support for MP4 H263 atom type (#9158).
  • Fix issue around TS synchronization when reading a file's duration (#9100).
• HLS:
  • Fix issue where playback of a live event could become stuck rather than transitioning to STATE_ENDED when the event ends (#9067).
  • Fix issue where a new initialization segment, as specified by an EXT-X-MAP tag in a media playlist, would not be loaded when encountered during playback (#9004).
  • Forward the FRAME-RATE value from the master playlist to renditions (#8960).
  • Fix issue where HLS events would start at positions greater than specified by an EXT-X-START tag when placed in a playlist (#9037).
• Ad playback:
  • Use the content URI when auto-generating an ad ID (in addition to the media ID and ad tag URI) (#9106.
• DRM:
  • Allow repeated provisioning in DefaultDrmSession(Manager).
  • Fix a crash due to DefaultDrmSessionManager.release() incorrectly releasing too many keep-alive DefaultDrmSession references, resulting in DefaultDrmSession.release() throwing an IllegalStateException (#9193).
• Metadata:
  • Fix handling of emsg messages with an unset duration (#9123).
• UI:
  • Add PendingIntent.FLAG_IMMUTABLE flag when creating a broadcast intent in PlayerNotificationManager. This is required to avoid an error on Android 12.
  • Fix focusability of StyledPlayerView and StyledPlayerControlView popup menus on API levels prior to 26 (#9061).
  • Fix progress bar flickering immediately after the user seeks (#9049).
  • Fix StyledPlayerView and StyledPlayerControlView popup menu items not expanding to occupy the full width of the popup (#9086).
  • Don't propagate AttributeSet from SubtitleView constructor into CanvasSubtitleOutput. Just passing the Context is enough, and ensures programmatic changes to the SubtitleView will propagate down.
• RTSP:
  • Fix session description (SDP) parsing to use a HashMap-like behaviour for duplicated attributes (#9014).
  • Allow using absolute URI in the control attribute in a media description (#9183).
  • Allow the timeout to be customised via RtspMediaSource.Factory.setTimeoutMs.

• Core Library:
  • Fix gradle config to allow specifying a relative path for exoplayerRoot when depending on ExoPlayer locally
    (#8927).
  • Update MediaItem.Builder javadoc to discourage calling setters that will be (currently) ignored if another setter is not also called.
• Extractors:
  • Add support for MPEG-H 3D Audio in MP4 extractors (#8860).
• Video:
  • Fix bug that could cause CodecException: Error 0xffffffff to be thrown from MediaCodec.native_setSurface in use cases that involve both swapping the output Surface and a mixture of secure and non-secure content being played (#8776).
• HLS:
  • Use the PRECISE attribute in EXT-X-START to select the default start position.
  • Fix a bug where skipping into spliced-in chunks triggered an assertion error (#8937).
• DRM:
  • Keep secure MediaCodec instances initialized when disabling (but not resetting) MediaCodecRenderer. This helps re-use secure decoders in more contexts, which avoids the 'black flash' caused by detaching a Surface from a secure decoder on some devices (#8842). It will also result in DRM license refresh network requests while the player is stopped if Player#setForegroundMode is true.
  • Fix issue where offline keys were unnecessarily (and incorrectly) restored into a session before being released. This call sequence is explicitly disallowed in OEMCrypto v16.
• UI:
  • Keep subtitle language features embedded (e.g. rubies & tate-chu-yoko) in Cue.text even when SubtitleView#setApplyEmbeddedStyles() is false.
  • Fix NullPointerException in StyledPlayerView that could occur after calling StyledPlayerView.setPlayer(null) (#8985).
• RTSP:
  • Add support for RTSP basic and digest authentication (#8941).
  • Enable using repeat mode and playlist with RTSP (#8994).
  • Add RtspMediaSource.Factory option to set the RTSP user agent.
  • Add RtspMediaSource.Factory option to force using TCP for streaming.
• GL demo app:
  • Fix texture transformation to avoid green bars shown on some videos (#8992).

• Core Library:
  • Move Player components to ExoPlayer. For example Player.VideoComponent is now ExoPlayer.VideoComponent.
  • The most used methods of Player's audio, video, text and metadata components have been added directly to Player.
  • Add Player.getAvailableCommands, Player.isCommandAvailable and Listener.onAvailableCommandsChanged to query which commands that can be executed on the player.
  • Add a Player.Listener interface to receive all player events. Component listeners and EventListener have been deprecated.
  • Add Player.getMediaMetadata, which returns a combined and structured MediaMetadata object. Changes to metadata are reported to Listener.onMediaMetadataChanged.
  • Player.setPlaybackParameters no longer accepts null, use PlaybackParameters.DEFAULT instead.
  • Report information about the old and the new playback positions to Listener.onPositionDiscontinuity. Add DISCONTINUITY_REASON_SKIP and DISCONTINUITY_REASON_REMOVE as discontinuity reasons, and rename DISCONTINUITY_REASON_PERIOD_TRANSITION to DISCONTINUITY_REASON_AUTO_TRANSITION. Remove DISCONTINUITY_REASON_AD_INSERTION, for which DISCONTINUITY_REASON_AUTO_TRANSITION is used instead (#6163, #4768).
  • Deprecate ExoPlayer.Builder. Use SimpleExoPlayer.Builder instead.
  • Move Player.getRendererCount and Player.getRendererType to ExoPlayer.
  • Use an empty string instead of the URI if the media ID is not explicitly set with MediaItem.Builder.setMediaId(String).
  • Remove MediaCodecRenderer.configureCodec() and add MediaCodecRenderer.getMediaCodecConfiguration(). The new method is called just before the MediaCodec is created and returns the parameters needed to create and configure the MediaCodec instance. Applications can override MediaCodecRenderer.onCodecInitialized() to be notified after a MediaCodec is initialized, or they can inject a custom MediaCodecAdapter.Factory if they want to control how the MediaCodec is configured.
  • Promote AdaptiveTrackSelection.AdaptationCheckpoint to public visibility to allow Kotlin subclasses of AdaptiveTrackSelection.Factory (#8830).
  • Fix bug when transitions from content to ad periods called onMediaItemTransition by mistake.
  • AdsLoader.AdViewProvider and AdsLoader.OverlayInfo have been renamed com.google.android.exoplayer2.ui.AdViewProvider and com.google.android.exoplayer2.ui.AdOverlayInfo respectively.
  • CaptionStyleCompat has been moved to the com.google.android.exoplayer2.ui package.
  • DebugTextViewHelper has been moved from the ui package to the util package.
• RTSP:
  • Initial support for RTSP playbacks (#55).
• Downloads and caching:
  • Fix CacheWriter to correctly handle cases where the request DataSpec extends beyond the end of the underlying resource. Caching will now succeed in this case, with data up to the end of the resource being cached. This behaviour is enabled by default, and so the allowShortContent parameter has been removed (#7326).
  • Fix CacheWriter to correctly handle DataSource.close failures, for which it cannot be assumed that data was successfully written to the cache.
• DRM:
  • Prepare DRM sessions (and fetch keys) ahead of the playback position (#4133).
  • Only dispatch DRM session acquire and release events once per period when playing content that uses the same encryption keys for both audio & video tracks. Previously, separate acquire and release events were dispatched for each track in each period.
  • Include the session state in DRM session-acquired listener methods.
• UI:
  • Add PlayerNotificationManager.Builder, with the ability to specify which group the notification should belong to.
  • Remove setUseSensorRotation from PlayerView and StyledPlayerView. Instead, cast the view returned by getVideoSurfaceView to SphericalGLSurfaceView, and then call setUseSensorRotation on the SphericalGLSurfaceView directly.
• Analytics:
  • Add onAudioCodecError and onVideoCodecError to AnalyticsListener.
• Video:
  • Add Player.getVideoSize() to retrieve the current size of the video stream. Add Listener.onVideoSizeChanged(VideoSize) and deprecate Listener.onVideoSizeChanged(int, int, int, float).
• Audio:
  • Report unexpected audio discontinuities to AnalyticsListener.onAudioSinkError (#6384).
  • Allow forcing offload for gapless content even if gapless playback is not supported.
  • Allow fall back from DTS-HD to DTS when playing via passthrough.
• Text:
  • Fix overlapping lines when using SubtitleView.VIEW_TYPE_WEB.
  • Parse SSA/ASS underline & strikethrough info in Style: lines (#8435).
  • Ensure TTML tts:textAlign is correctly propagated from <p> nodes to child nodes.
  • Support TTML ebutts:multiRowAlign attributes.
• Allow the use of Android platform extractors through MediaParser:
  • Supported on API 30+:
  • You can use platform extractors for progressive media by passing MediaParserExtractorAdapter.FACTORY when creating a ProgressiveMediaSource.Factory.
  • You can use platform extractors for HLS by passing MediaParserHlsMediaChunkExtractor.FACTORY when creating a HlsMediaSource.Factory.
  • You can use platform extractors for DASH by passing a DefaultDashChunkSource that uses MediaParserChunkExtractor.FACTORY when creating a DashMediaSource.Factory.
• Cast extension:
  • Trigger onMediaItemTransition event for all reasons except MEDIA_ITEM_TRANSITION_REASON_REPEAT.
• MediaSession extension:
  • Remove dependency on exoplayer-core, relying only exoplayer-common instead. To achieve this, TimelineQueueEditor uses a new MediaDescriptionConverter interface, and no longer relies on ConcatenatingMediaSource.
• Remove deprecated symbols:
  • Remove ExoPlayerFactory. Use SimpleExoPlayer.Builder instead.
  • Remove Player.DefaultEventListener. Use Player.Listener instead.
  • Remove ExtractorMediaSource. Use ProgressiveMediaSource instead.
  • Remove DefaultMediaSourceEventListener. Use MediaSourceEventListener instead.
  • Remove DashManifest constructor. Use the remaining constructor with programInformation and serviceDescription set to null instead.
  • Remove CryptoInfo.getFrameworkCryptoInfoV16. Use CryptoInfo.getFrameworkCryptoInfo instead.
  • Remove NotificationUtil.createNotificationChannel(Context, String, int, int). Use createNotificationChannel(Context, String, int, int, int) instead.
  • Remove PlayerNotificationManager.setNotificationListener. Use PlayerNotificationManager.Builder.setNotificationListener instead.
  • Remove PlayerNotificationManager.NotificationListener onNotificationStarted(int, Notification) and onNotificationCancelled(int). Use onNotificationPosted(int, Notification, boolean) and onNotificationCancelled(int, boolean) instead.
  • Remove DownloadNotificationUtil. Use DownloadNotificationHelper instead.
  • Remove extension-jobdispatcher module. Use the extension-workmanager module instead.

• Published via the Google Maven repository (i.e., google()) rather than JCenter.
• Core:
  • Reset playback speed when live playback speed control becomes unused (#8664).
  • Fix playback position issue when re-preparing playback after a BehindLiveWindowException (#8675).
  • Assume Dolby Vision content is encoded as H264 when calculating maximum codec input size (#8705).
• UI:
  • Fix StyledPlayerView scrubber not reappearing correctly in some cases (#8646).
  • Fix measurement of StyledPlayerView and StyledPlayerControlView when wrap_content is used (#8726).
  • Fix StyledPlayerControlView to stay in full mode (rather than minimal mode) when possible (#8763).
• DASH:
  • Parse forced_subtitle role from DASH manifests (#8781).
• HLS:
  • Fix bug of ignoring EXT-X-START when setting the live target offset (#8764).
  • Fix incorrect application of byte ranges to EXT-X-MAP tags (#8783).
  • Fix issue that could cause playback to become stuck if corresponding EXT-X-DISCONTINUITY tags in different media playlists occur at different positions in time (#8372).
  • Fix issue that could cause playback of on-demand content to not start in cases where the media playlists referenced by the master playlist have different starting EXT-X-PROGRAM-DATE-TIME tags.
  • Fix container type detection for segments with incorrect file extension or HTTP Content-Type (#8733).
• Extractors:
  • Add support for GContainer and GContainerItem XMP namespace prefixes in JPEG motion photo parsing.
  • Allow JFIF APP0 marker segment preceding Exif APP1 segment in JpegExtractor.
• Text:
  • Parse SSA/ASS bold & italic info in Style: lines (#8435).
  • Don't display subtitles after the end position of the current media period (if known). This ensures sideloaded subtitles respect the end point of ClippingMediaPeriod and prevents content subtitles from continuing to be displayed over mid-roll ads (#5317, #8456).
  • Fix CEA-708 priority handling to sort cues in the order defined by the spec (#8704).
  • Support TTML textEmphasis attributes, used for Japanese boutens.
  • Support TTML shear attributes.
• Metadata:
  • Ensure that timed metadata near the end of a period is not dropped (#8710).
• Cast extension:
  • Fix onPositionDiscontinuity event so that it is not triggered with reason DISCONTINUITY_REASON_PERIOD_TRANSITION after a seek to another media item and so that it is not triggered after a timeline change.
• IMA extension:
  • Fix error caused by AdPlaybackState ad group times being cleared, which can occur if the ImaAdsLoader is released while an ad is pending loading (#8693).
  • Upgrade IMA SDK dependency to 3.23.0, fixing an issue with NullPointerExceptions within WebView callbacks (#8447).
• FFmpeg extension: Fix playback failure when switching to TrueHD tracks during playback (#8616).