1.2.0-rc01

• ExoPlayer:
  • Add luma and chroma bitdepth to ColorInfo #491.
• Track Selection:
  • Add DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness to explicitly allow or disallow non-seamless adaptation. The default stays at its current behavior of true.
• Audio:
  • Fix DTS Express audio buffer underflow issue (#650).
  • Fix bug where the capabilities check for E-AC3-JOC throws an IllegalArgumentException (#677).
• Text:
  • Remove ExoplayerCuesDecoder. Text tracks with sampleMimeType = application/x-media3-cues are now directly handled by TextRenderer without needing a SubtitleDecoder instance.
• Session:
  • Do not set the queue of the framework session when COMMAND_GET_TIMELINE is not available for the media notification controller. With Android Auto as the client controller reading from the framework session, this has the effect that the queue button in the UI of Android Auto is not displayed ((#339).
  • Use DataSourceBitmapLoader by default instead of SimpleBitmapLoader (#271,#327).
  • Add MediaSession.Callback.onMediaButtonEvent(Intent) that allows apps to override the default media button event handling.
• HLS Extension:
  • Refresh the HLS live playlist with an interval calculated from the last load start time rather than the last load completed time (#663).
• DASH Extension:
  • Add experimental support for parsing subtitles during extraction. This has better support for merging overlapping subtitles, including resolving flickering when transitioning between subtitle segments. You can enable this using DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() (#288).
• Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
  • Fix bug publishing MIDI decoder artifact to Maven repository. The artifact is renamed to media3-exoplayer-midi (#734).
• Remove deprecated symbols:
  • Remove deprecated DownloadNotificationHelper.buildProgressNotification method, use a non deprecated method that takes a notMetRequirements parameter instead.

1.2.0-beta01

• Audio:
  • Add onAudioTrackInitialized and onAudioTrackReleased callbacks to AnalyticsListener, AudioRendererEventListener and AudioSink.Listener.
• Metadata:
  • MetadataDecoder.decode will no longer be called for "decode-only" samples as the implementation must return null anyway.
• Session:
  • Add session demo module for Automotive OS and enable session demo for Android Auto.
• DASH Extension:
  • Allow multiple of the same DASH identifier in segment template url.
• RTSP Extension:
  • Use RTSP Setup Response timeout value in time interval of sending keep-alive RTSP Options requests (#662).
• Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
  • Add DecoderOutputBuffer.shouldBeSkipped to directly mark output buffers that don't need to be presented. This is preferred over C.BUFFER_FLAG_DECODE_ONLY that will be deprecated.
  • Add Decoder.setOutputStartTimeUs and SimpleDecoder.isAtLeastOutputStartTimeUs to allow decoders to drop decode-only samples before the start time. This should be preferred to Buffer.isDecodeOnly that will be deprecated.

1.2.0-alpha02

• Common Library:
  • Upgrade androidx.annotation:annotation-experimental to 1.3.1. This also introduces a transitive dependency on the Kotlin standard library from media3-common. Apps can downgrade to remove this dependency if they want. Fixes https://issuetracker.google.com/251172715.
  • Move ExoPlayer.setAudioAttributes to the Player interface.
• ExoPlayer:
  • Add additional fields to Common Media Client Data (CMCD) logging: next object request (nor) and next range request (nrr)(#8699).
  • Add functionality to transmit Common Media Client Data (CMCD) data using query parameters (#553).
  • Fix ConcurrentModificationException in ExperimentalBandwidthMeter (#612).
  • Add MediaPeriodId parameter to CompositeMediaSource.getMediaTimeForChildMediaTime.
  • Support ClippingMediaSource (and other sources with period/window time offsets) in ConcatenatingMediaSource2 (#11226).
  • Change BaseRenderer.onStreamChanged() to also receive a MediaPeriodId argument.
• Transformer:
  • Changed frameRate and durationUs parameters of SampleConsumer.queueInputBitmap to TimestampIterator.
• Extractors:
  • Add BmpExtractor.
  • Add WebpExtractor.
  • Add HeifExtractor.
  • Add QuickTime classic
    support to Mp4Extractor.
• Audio:
  • Add support for Opus gapless metadata during offload playback.
  • Allow renderer recovery by disabling offload if failed at first write (#627).
  • Enable Offload Scheduling by default for audio-only offloaded playback.
  • Delete ExoPlayer.experimentalSetOffloadSchedulingEnabled and AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged.
  • Renamed onExperimentalSleepingForOffloadChanged as onSleepingForOffloadChanged and onExperimentalOffloadedPlayback as onOffloadedPlayback.
  • Move audio offload mode related TrackSelectionParameters interfaces
    and definitions to an inner AudioOffloadPreferences class.
• Effect:
  • Changed frameRate and durationUs parameters of VideoFrameProcessor.queueInputBitmap to TimestampIterator.
• IMA extension:
  • Fix bug where a multi-period DASH live stream that is not the first item in a playlist can throw an exception (#571).
  • Release StreamManager before calling AdsLoader.destroy()
  • Bump IMA SDK version to 3.31.0.
• Session:
  • Set the notifications foreground service behavior to FOREGROUND_SERVICE_IMMEDIATE in DefaultMediaNotificationProvider (#167).
  • Use only android.media.session.MediaSession.setMediaButtonBroadcastReceiver() above API 31 to avoid problems with deprecated API on Samsung devices (#167).
  • Use the media notification controller as proxy to set available commands and custom layout used to populate the notification and the platform session.
  • Convert media button events that are received by MediaSessionService.onStartCommand() within Media3 instead of routing them to the platform session and back to Media3. With this, the caller controller is always the media notification controller and apps can easily recognize calls coming from the notification in the same way on all supported API levels.
  • Fix bug where MediaController.getCurrentPosition() is not advancing when connected to a legacy MediaSessionCompat.
  • Add MediaLibrarySession.getSubscribedControllers(mediaId) for convenience.
  • Override MediaLibrarySession.Callback.onSubscribe() to assert the availability of the parent Id for which the controller subscribes. If successful, the subscription is accepted and notifyChildrenChanged() is called immediately to inform the browser (#561).
• RTSP Extension:
  • Fix a race condition that could lead to IndexOutOfBoundsException when falling back to TCP, or playback hanging in some situations.
  • Check state in RTSP setup when returning loading state of RtspMediaPeriod (#577).
  • Ignore custom Rtsp request methods in Options response public header (#613).
• Leanback extension:
  • Fix bug where disabling a surface can cause an ArithmeticException in Leanback code (#617).

1.2.0-alpha01

This release includes the following changes since 1.1.1 release:

• Common Library:
  • Add a @Nullable Throwable parameter to the methods in the Log.Logger interface. The message parameter to these methods no longer contains any information about the Throwable passed to the Log.{d,i,w,e}() methods, so implementations will need to manually append this information if desired (possibly using Logger.appendThrowableString(String, Throwable)).
  • Fix Kotlin compatibility issue where nullable generic type parameters and nullable array element types are not detected as nullable. Examples are TrackSelectorResult and SimpleDecoder method parameters (#6792).
  • Change default UI and notification behavior in Util.shouldShowPlayButton to show a "play" button while playback is temporarily suppressed (e.g. due to transient audio focus loss). The legacy behavior can be maintained by using PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) or MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) (#11213).
• ExoPlayer:
  • Fix seeking issues in AC4 streams caused by not identifying decode-only samples correctly (#11000).
  • Add suppression of playback on unsuitable audio output devices (e.g. the built-in speaker on Wear OS devices) when this feature is enabled via ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput. The playback suppression reason will be updated as Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT if playback is attempted when no suitable audio outputs are available, or if all suitable outputs are disconnected during playback. The suppression reason will be removed when a suitable output is connected.
  • Add MediaSource.canUpdateMediaItem and MediaSource.updateMediaItem to accept MediaItem updates after creation via Player.replaceMediaItem(s).
  • Allow MediaItem updates for all MediaSource classes provided by the library via Player.replaceMediaItem(s) ((#33),(#9978)).
  • Rename MimeTypes.TEXT_EXOPLAYER_CUES to MimeTypes.APPLICATION_MEDIA3_CUES.
  • Add PngExtractor that sends and reads a whole PNG file into the TrackOutput as one sample.
  • Enhance SequenceableLoader.continueLoading(long) method in the SequenceableLoader interface to SequenceableLoader.continueLoading(LoadingInfo loadingInfo). LoadingInfo contains additional parameters, including playbackSpeed and lastRebufferRealtimeMs in addition to the existing playbackPositionUs.
  • Enhance ChunkSource.getNextChunk(long, long, List, ChunkHolder) method in the ChunkSource interface to ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder).
  • Add additional fields to Common Media Client Data (CMCD) logging: buffer starvation (bs), deadline (dl), playback rate (pr) and startup (su) (#8699).
• Transformer:
  • Parse EXIF rotation data for image inputs.
  • Remove TransformationRequest.HdrMode annotation type and its associated constants. Use Composition.HdrMode and its associated constants instead.
  • Simplify the OverlaySettings to fix rotation issues.
• Extractors:
  • MPEG-TS: Ensure the last frame is rendered by passing the last access unit of a stream to the sample queue (#7909).
  • Fix typo when determining rotationDegrees. Changed projectionPosePitch to projectionPoseRoll (#461).
  • Remove the assumption that Extractor instances can be directly inspected with instanceof. If you want runtime access to the implementation details of an Extractor you must first call Extractor.getUnderlyingInstance.
• Audio:
  • Add support for 24/32-bit big-endian PCM in MP4 and Matroska, and parse PCM encoding for lpcm in MP4.
  • Add support for extracting Vorbis audio in MP4.
• Audio Offload:
  • Add AudioSink.getFormatOffloadSupport(Format) that retrieves level of offload support the sink can provide for the format through a DefaultAudioOffloadSupportProvider. It returns the new AudioOffloadSupport that contains isFormatSupported, isGaplessSupported, and isSpeedChangeSupported.
  • Add AudioSink.setOffloadMode() through which the offload configuration on the audio sink is configured. Default is AudioSink.OFFLOAD_MODE_DISABLED.
  • Offload can be enabled through setAudioOffloadPreference in TrackSelectionParameters. If the set preference is to enable, the device supports offload for the format, and the track selection is a single audio track, then audio offload will be enabled.
  • If audioOffloadModePreference is set to AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED, then the DefaultTrackSelector will only select an audio track and only if that track's format is supported in offload. If no audio track is supported in offload, then no track will be selected.
  • Disabling gapless support for offload when pre-API level 33 due to playback position issue after track transition.
  • Remove parameter enableOffload from DefaultRenderersFactory.buildAudioSink method signature.
  • Remove method DefaultAudioSink.Builder.setOffloadMode.
  • Remove intdef value DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED.
• Video:
  • Allow MediaCodecVideoRenderer to use a custom VideoFrameProcessor.Factory.
  • Fix bug where the first frame couldn't be rendered if the audio stream starts with negative timestamps (#291).
• Effect:
  • Add VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) queuing bitmap input by timestamp.
• UI:
  • Add a Player.Listener implementation for Wear OS devices that handles playback suppression due to Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT by launching a system dialog to allow a user to connect a suitable audio output (e.g. bluetooth headphones). The listener will auto-resume playback if a suitable device is connected within a configurable timeout (default is 5 minutes).
• Downloads:
  • Declare "data sync" foreground service type for DownloadService for Android 14 compatibility. When using this service, the app also needs to add dataSync as foregroundServiceType in the manifest and add the FOREGROUND_SERVICE_DATA_SYNC permission (#11239).
• MIDI extension:
  • Release the MIDI decoder module, which provides support for playback of standard MIDI files using the Jsyn library to synthesize audio.
• Test Utilities:
  • Make TestExoPlayerBuilder and FakeClock compatible with Espresso UI tests and Compose UI tests. This fixes a bug where playback advances non-deterministically during Espresso or Compose view interactions.
• Remove deprecated symbols:
  • Remove TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) and TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean). Use Composition.Builder.setHdrMode(int) and pass the Composition to Transformer.start(Composition, String) instead.

1.1.1

This release corresponds to the ExoPlayer 2.19.1 release.

This release includes the following changes since the 1.1.0 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.
• Session:
  • Add custom layout to the state of the controller and provide a getter to access it. When the custom layout changes, MediaController.Listener.onCustomLayoutChanged is called. Apps that want to send different custom layouts to different Media3 controller can do this in MediaSession.Callback.onConnect by using an AcceptedResultBuilder to make sure the custom layout is available to the controller when connection completes.
  • Fix cases where MediaLibraryServiceLegacyStub sent an error to a Result that didn't support this which produced an UnsupportedOperationException (#78).
  • Fix the way PlayerWrapper creates a VolumeProviderCompat by determining volumeControlType through both legacy commands (COMMAND_ADJUST_DEVICE_VOLUME and COMMAND_SET_DEVICE_VOLUME) and new commands (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS and COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS) (#554).

1.1.0

This release corresponds to the ExoPlayer 2.19.0 release.

This release contains the following changes since the 1.0.2 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.
• IMqA 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.
• Session:
  • Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling aPlayer method.
  • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset (#167).
  • Add default implementation to MediaSession.Callback.onAddMediaItems to allow requested MediaItems to be passed onto Player if they have LocalConfiguration (e.g. URI) (#282).
  • Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below (#410).
• UI:
  • Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
• RTSP Extension:
  • For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message (#302).
  • Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header (#11160).
• DASH Extension:
  • Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
  • Fix a bug where re-preparing a multi-period live Dash media source produced a IndexOutOfBoundsException (#10838).
• HLS Extension:
  • Add HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) to set a timeout for the loading thread to wait for the TimestampAdjuster to initialize. If the initialization doesn't complete before the timeout, a PlaybackException is thro...

1.1.0-rc01

This release includes the following changes since 1.1.0-beta01:

• ExoPlayer:
  • 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).
• Extractors:
  • FMP4: Fix issue where TimestampAdjuster initializes a wrong timestamp offset with metadata sample time from emsg atom (#356).

1.1.0-beta01

• Common Library:
  • Add Player.replaceMediaItem(s) as a shortcut to adding and removing items at the same position (#8046).
• ExoPlayer:
  • Add FilteringMediaSource that allows to filter available track types from a MediaSource.
  • 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)
• Extractors:
  • Ogg: Fix bug when seeking in files with a long duration (#391).
• Audio:
  • 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.
• 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).
• Session:
  • Add androidx.media3.session.MediaButtonReceiver to enable apps to implement playback resumption with media button events sent by, for example, a Bluetooth headset (#167).
• RTSP Extension:
  • Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header (#11160).
• Remove deprecated symbols:
  • 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.

1.0.2

This release corresponds to the ExoPlayer 2.18.7 release.

This release contains the following changes since the 1.0.1 release:

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

1.1.0-alpha01

• Core library:
  • Add suppression reason for unsuitable audio route and play when ready change reason for suppressed too long. (#15).
  • 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.
  • Deprecate Player.COMMAND_GET_MEDIA_ITEMS_METADATA and COMMAND_SET_MEDIA_ITEMS_METADATA. Use COMMAND_GET_METADATA and COMMAND_SET_PLAYLIST_METADATA instead.
  • 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).
  • Add Builder for DeviceInfo and deprecate existing constructor.
  • Add DeviceInfo.routingControllerId to specify the routing controller ID for remote playbacks.
  • Fix inconsistent behavior between ExoPlayer.setMediaItem(s) and addMediaItem(s) when called on an empty playlist.
• 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).
• Session:
  • Deprecate 4 volume-controlling methods in Player and add overloaded methods which allow users to specify volume flags:
    • void setDeviceVolume(int, int)
    • void increaseDeviceVolume(int)
    • void decreaseDeviceVolume(int)
    • void setDeviceMuted(boolean, int)
  • Fix issue where MediaController doesn't update its available commands when connected to a legacy MediaSessionCompat that updates its actions.
  • Add helper method MediaSession.getControllerForCurrentRequest to obtain information about the controller that is currently calling aPlayer method.
  • Fix bug that prevented the MediaLibraryService from returning null for a call from System UI to Callback.onGetLibraryRoot with params.isRecent == true on API 30 (#355).
  • Fix memory leak of MediaSessionService or MediaLibraryService (#346).
• UI:
  • Add Util methods shouldShowPlayButton and handlePlayPauseButtonAction to write custom UI elements with a play/pause button.
• 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.
• 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.
• Metadata:
  • Deprecate MediaMetadata.folderType in favor of isBrowsable and mediaType.
• 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)
• 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.
• Muxer:
  • Add a new muxer library which can be used to create an MP4 container file.
• DASH:
  • Remove the media time offset from MediaLoadData.startTimeMs and MediaLoadData.endTimeMs for multi period DASH streams.
• RTSP:
  • For MPEG4-LATM, use default profile-level-id value if absent in Describe Response SDP message (#302).
• IMA DAI extension:
• Text:
  • Fix a bug where a new ad group is inserted in live streams because the calculated content position in consecutive timelines varies slightly.
  • SSA: Add support for UTF-16 files if they start with a byte order mark (#319).
• 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.