Releases: androidx/media
Releases · androidx/media
1.0.0-beta01
1.0.0-beta01 (2022-06-16)
This release corresponds to the ExoPlayer 2.18.0 release.
- Core library:
- Enable support for Android platform diagnostics via
MediaMetricsManager
. ExoPlayer will forward playback events and performance data to the platform, which helps to provide system performance and debugging information on the device. This data may also be collected by Google if sharing usage and diagnostics data is enabled by the user of the device. Apps can opt-out of contributing to platform diagnostics for ExoPlayer withExoPlayer.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
toMediaSource.Factory.setDrmSessionManagerProvider
andMediaSource.Factory.setLoadErrorHandlingPolicy
. Instances ofDefaultDrmSessionManagerProvider
andDefaultLoadErrorHandlingPolicy
can be passed explicitly if required. - Add
MediaItem.RequestMetadata
to represent metadata needed to play media when the exactLocalConfiguration
is not known. Also removeMediaMetadata.mediaUrl
as this is now included inRequestMetadata
. - Add
Player.Command.COMMAND_SET_MEDIA_ITEM
to enable players to allow setting a single item.
- Enable support for Android platform diagnostics via
- Track selection:
- Flatten
TrackSelectionOverrides
class intoTrackSelectionParameters
, and promoteTrackSelectionOverride
to a top level class. - Rename
TracksInfo
toTracks
andTracksInfo.TrackGroupInfo
toTracks.Group
.Player.getCurrentTracksInfo
andPlayer.Listener.onTracksInfoChanged
have also been renamed toPlayer.getCurrentTracks
andPlayer.Listener.onTracksChanged
. This includes 'un-deprecating' thePlayer.Listener.onTracksChanged
method name, but with different parameter types. - Change
DefaultTrackSelector.buildUponParameters
andDefaultTrackSelector.Parameters.buildUpon
to returnDefaultTrackSelector.Parameters.Builder
instead of the deprecatedDefaultTrackSelector.ParametersBuilder
. - Add
DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities
which is enabled by default. When enabled, theDefaultTrackSelector
will prefer audio tracks whose channel count does not exceed the device output capabilities. On handheld devices, theDefaultTrackSelector
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, theDefaultTrackSelector
will monitor for changes in the Spatializer properties and trigger a new track selection upon these. Devices with atelevision
UI mode are excluded from these constraints and the format with the highest channel count will be preferred. To enable this feature, theDefaultTrackSelector
instance must be constructed with aContext
.
- Flatten
- Video:
- Rename
DummySurface
toPlaceholderSurface
. - Add AV1 support to the
MediaCodecVideoRenderer.getCodecMaxInputSize
.
- Rename
- Audio:
- Use LG AC3 audio decoder advertising non-standard MIME type.
- Change the return type of
AudioAttributes.getAudioAttributesV21()
fromandroid.media.AudioAttributes
to a newAudioAttributesV21
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 maskAudioFormat.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 returnCueGroup
instead ofList<Cue>
. - SSA: Support
OutlineColour
style setting whenBorderStyle == 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.
- Change
- Extractors:
- Matroska: Parse
DiscardPadding
for Opus tracks. - MP4: Parse bitrates from
esds
boxes. - Ogg: Allow duplicate Opus ID and comment headers (#10038).
- Matroska: Parse
- UI:
- Fix delivery of events to
OnClickListener
s set onPlayerView
, in the case thatuseController=false
(#9605). Also fix delivery of events toOnLongClickListener
for all view configurations. - Fix incorrectly treating a sequence of touch events that exit the bounds of
PlayerView
beforeACTION_UP
as a click (#9861). - Fix
PlayerView
accessibility issue where tapping might toggle playback rather than hiding the controls (#8627). - Rewrite
TrackSelectionView
andTrackSelectionDialogBuilder
to work with thePlayer
interface rather thanExoPlayer
. This allows the views to be used with otherPlayer
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).
- Fix delivery of events to
- DASH:
- Parse channel count from DTS
AudioChannelConfiguration
elements. This re-enables audio passthrough for DTS streams (#10159). - Disallow passing
null
toDashMediaSource.Factory.setCompositeSequenceableLoaderFactory
. Instances ofDefaultCompositeSequenceableLoaderFactory
can be passed explicitly if required.
- Parse channel count from DTS
- HLS:
- Fallback to chunkful preparation if the playlist CODECS attribute does not contain the audio codec (#10065).
- Disallow passing
null
toHlsMediaSource.Factory.setCompositeSequenceableLoaderFactory
,HlsMediaSource.Factory.setPlaylistParserFactory
, andHlsMediaSource.Factory.setPlaylistTrackerFactory
. Instances ofDefaultCompositeSequenceableLoaderFactory
,DefaultHlsPlaylistParserFactory
, or a reference toDefaultHlsPlaylistTracker.FACTORY
can be passed explicitly if required.
- Smooth Streaming:
- Disallow passing
null
toSsMediaSource.Factory.setCompositeSequenceableLoaderFactory
. Instances ofDefaultCompositeSequenceableLoaderFactory
can be passed explicitly if required.
- Disallow passing
- 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).
- Session:
- Replace
MediaSession.MediaItemFiller
withMediaSession.Callback.onAddMediaItems
to allow asynchronous resolution of requests. - Support
setMediaItems(s)
methods whenMediaController
connects to a legacy media session. - Remove
MediaController.setMediaUri
andMediaSession.Callback.onSetMediaUri
. The same functionality can be achieved by usingMediaController.setMediaItem
andMediaSession.Callback.onAddMediaItems
. - Forward legacy
MediaController
calls to play media toMediaSession.Callback.onAddMediaItems
instead ofonSetMediaUri
. - Add
MediaNotification.Provider
andDefaultMediaNotificationProvider
to provide customization of the notification. - Add
BitmapLoader
andSimpleBitmapLoader
for downloading artwork images. - Add
MediaSession.setCustomLayout()
to provide backwards compatibility with the legacy session. - Add
MediaSession.setSessionExtras()
to provide feature parity with legacy session. - Rename
MediaSession.MediaSessionCallback
toMediaSession.Callback
,MediaLibrarySession.MediaLibrarySessionCallback
toMediaLibrarySession.Callback
andMediaSession.Builder.setSessionCallback
tosetCallback
. - Fix NPE in
MediaControllerImplLegacy
([#59](https://github.com/androidx/media/...
- Replace
1.0.0-alpha03
This release corresponds to the ExoPlayer 2.17.1 release.
- Audio:
- Fix error checking audio capabilities for Dolby Atmos (E-AC3-JOC) in HLS.
- Extractors:
- FMP4: Fix issue where emsg sample metadata could be output in the wrong order for streams containing both v0 and v1 emsg atoms (#9996).
- Text:
- Fix the interaction of
SingleSampleMediaSource.Factory.setTrackId
andMediaItem.SubtitleConfiguration.Builder.setId
to prioritise theSubtitleConfiguration
field and fall back to theFactory
value if it's not set (#10016).
- Fix the interaction of
- Ad playback:
- Fix audio underruns between ad periods in live HLS SSAI streams.
1.0.0-alpha02
This release corresponds to the ExoPlayer 2.17.0 release.
- Core Library:
- Add protected method
DefaultRenderersFactory.getCodecAdapterFactory()
so that subclasses ofDefaultRenderersFactory
that overridebuildVideoRenderers()
orbuildAudioRenderers()
can access the codec adapter factory and pass it toMediaCodecRenderer
instances they create. - Propagate ICY header fields
name
andgenre
toMediaMetadata.station
andMediaMetadata.genre
respectively so that they reach the app viaPlayer.Listener.onMediaMetadataChanged()
(#9677). - Remove null keys from
DefaultHttpDataSource#getResponseHeaders
. - Sleep and retry when creating a
MediaCodec
instance fails. This works around an issue that occurs on some devices when switching a surface from a secure codec to another codec (#8696). - Add
MediaCodecAdapter.getMetrics()
to allow users obtain metrics data fromMediaCodec
(#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
toqueuedInputBufferCount
. - Make
SimpleExoPlayer.renderers
private. Renderers can be accessed viaExoPlayer.getRenderer
. - Updated some
AnalyticsListener.EventFlags
constant values to match values inPlayer.EventFlags
. - Split
AnalyticsCollector
into an interface and default implementation to allow it to be stripped by R8 if an app doesn't need it.
- Add protected method
- Track selection:
- Support preferred video role flags in track selection (#9402).
- Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation (#9519).
- Update video and audio track selection logic to only choose formats for adaptive selections that have the same level of decoder and hardware support (#9565).
- Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders (#4835).
- Prefer audio content preferences (for example, the "default" audio track or a track matching the system locale language) over technical track selection constraints (for example, preferred MIME type, or maximum channel count).
- Fix track selection issue where overriding one track group did not disable other track groups of the same type (#9675).
- Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly (#9649).
- Prohibit duplicate
TrackGroup
s in aTrackGroupArray
.TrackGroup
s can always be made distinguishable by setting anid
in theTrackGroup
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 explicitlyAudioCapabilities.DEFAULT_AUDIO_CAPABILITIES
instead ofnull
. - Allow customization of the
AudioTrack
buffer size calculation by injecting anAudioTrackBufferSizeProvider
toDefaultAudioSink
(#8891). - Retry
AudioTrack
creation if the requested buffer size was > 1MB. (#9712).
- Extractors:
- Text:
- Add a
MediaItem.SubtitleConfiguration.id
field which is propagated to theFormat.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.
- Add a
- DRM:
- Remove
playbackLooper
fromDrmSessionManager.(pre)acquireSession
. When aDrmSessionManager
is used by an app in a customMediaSource
, theplaybackLooper
needs to be passed toDrmSessionManager.setPlayer
instead.
- Remove
- 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:
- DASH:
- Add parsed essential and supplemental properties to the
Representation
(#9579). - Support the
forced-subtitle
track role (#9727). - Stop interpreting the
main
track role asC.SELECTION_FLAG_DEFAULT
. - Fix base URL exclusion logic for manifests that do not declare the DVB namespace (#9856).
- Support relative
MPD.Location
URLs (#9939).
- Add parsed essential and supplemental properties to the
- HLS:
- Correctly populate
Format.label
for audio only HLS streams (#9608). - Use chunkless preparation by default to improve start up time. If your renditions contain muxed closed-caption tracks that are not declared in the master playlist, you should add them to the master playlist to be available for playback, or turn off chunkless preparation with
HlsMediaSource.Factory.setAllowChunklessPreparation(false)
. - Support key-frame accurate seeking in HLS (#2882).
- Correctly populate
- RTSP:
- Transformer:
- Increase required min API version to 21.
TransformationException
is now used to describe errors that occur during a transformation.- Add
TransformationRequest
for specifying the transformation options. - Allow multiple listeners to be registered.
- Fix Transformer being stuck when the codec output is partially read.
- Fix potential NPE in
Transformer.getProgress
when releasing the muxer throws. - Add a demo app for applying transformations.
- MediaSession extension:
- By default,
MediaSessionConnector
now clears the playlist on stop. Apps that want the playlist to be retained can callsetClearMediaItemsOnStop(false)
on the connector.
- By default,
- Cast extension:
- FFmpeg extension:
- Make
build_ffmpeg.sh
depend on LLVM's bin utils instead of GNU's (#9933).
- Make
- Android 12 compatibility:
- Upgrade the Cast extension to depend on
com.google.android.gms:play-services-cast-framework:20.1.0
. Earlier
versions ofplay-services-cast-framework
are not compatible with apps targeting Android 12, and will crash with anIllegalArgumentException
when creatingPendingIntent
s (#9528).
- Upgrade the Cast extension to depend on
- Remove deprecated symbols:
- Remove
Player.EventListener
. UsePlayer.Listener
instead. - Remove
MediaSourceFactory#setDrmSessionManager
, `MediaSourceFactory#setDrmH...
- Remove