# Release notes ### Unreleased changes * Common Library: * ExoPlayer: * Add luma and chroma bitdepth to `ColorInfo` [#491](https://github.com/androidx/media/pull/491). * Transformer: * Add support for flattening H.265/HEVC SEF slow motion videos. * Track Selection: * Add `DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness` to explicitly allow or disallow non-seamless adaptation. The default stays at its current behavior of `true`. * Extractors: * Audio: * Fix DTS Express audio buffer underflow issue ([#650](https://github.com/androidx/media/pull/650)). * Video: * Text: * Remove `ExoplayerCuesDecoder`. Text tracks with `sampleMimeType = application/x-media3-cues` are now directly handled by `TextRenderer` without needing a `SubtitleDecoder` instance. * Metadata: * DRM: * Effect: * Muxers: * IMA extension: * 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](https://github.com/androidx/media/issues/339)). * UI: * Downloads: * OkHttp Extension: * Cronet Extension: * RTMP Extension: * 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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/288)). * Smooth Streaming Extension: * RTSP Extension: * 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](https://github.com/androidx/media/issues/734)). * Leanback extension: * Cast Extension: * Test Utilities: * Remove deprecated symbols: * Remove deprecated `DownloadNotificationHelper.buildProgressNotification` method, use a non deprecated method that takes a `notMetRequirements` parameter instead. ## 1.2 ### 1.2.0-beta01 (2023-10-18) This release includes the following changes since the [1.2.0-alpha02 release](#120-alpha02-2023-09-29)): * 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. * Smooth Streaming Extension: * RTSP Extension: * Use RTSP Setup Response timeout value in time interval of sending keep-alive RTSP Options requests ([#662](https://github.com/androidx/media/issues/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 (2023-09-29) This release includes the following changes since the [1.2.0-alpha01 release](#120-alpha01-2023-08-17)): * 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](https://developer.android.com/guide/topics/media/exoplayer/shrinking#remove-kotlin-dep). 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](https://github.com/google/ExoPlayer/issues/8699)). * Add functionality to transmit Common Media Client Data (CMCD) data using query parameters ([#553](https://github.com/androidx/media/issues/553)). * Fix `ConcurrentModificationException` in `ExperimentalBandwidthMeter` ([#612](https://github.com/androidx/media/issues/612)). * Add `MediaPeriodId` parameter to `CompositeMediaSource.getMediaTimeForChildMediaTime`. * Support `ClippingMediaSource` (and other sources with period/window time offsets) in `ConcatenatingMediaSource2` ([#11226](https://github.com/google/ExoPlayer/issues/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](https://developer.apple.com/standards/qtff-2001.pdf) 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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/167)). * Use only `android.media.session.MediaSession.setMediaButtonBroadcastReceiver()` above API 31 to avoid problems with deprecated API on Samsung devices ([#167](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/577)). * Ignore custom Rtsp request methods in Options response public header ([#613](https://github.com/androidx/media/issues/613)). * Leanback extension: * Fix bug where disabling a surface can cause an `ArithmeticException` in Leanback code ([#617](https://github.com/androidx/media/issues/617)). ### 1.2.0-alpha01 (2023-08-17) This release includes the following changes since the [1.1.1 release](#111-2023-08-14)): * 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/11213)). * ExoPlayer: * Fix seeking issues in AC4 streams caused by not identifying decode-only samples correctly ([#11000](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/issues/33)),([#9978](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/7909)). * Fix typo when determining `rotationDegrees`. Changed `projectionPosePitch` to `projectionPoseRoll` ([#461](https://github.com/androidx/media/pull/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](https://github.com/androidx/media/issues/291)). * Effect: * Add `VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator)` queuing bitmap input by timestamp. * Change `VideoFrameProcessor.registerInputStream()` to be non-blocking. Apps must implement `VideoFrameProcessor.Listener#onInputStreamRegistered()`. * 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](https://github.com/google/ExoPlayer/issues/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.1.1 (2023-08-14) This release corresponds to the [ExoPlayer 2.19.1 release](https://github.com/google/ExoPlayer/releases/tag/r2.19.1). This release includes the following changes since the [1.1.0 release](#110-2023-07-05): * Common Library: * Remove accidentally added `multidex` dependency from all modules ([#499](https://github.com/androidx/media/issues/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](https://github.com/google/ExoPlayer/issues/8699)). * Audio: * Fix a bug where `Player.getState()` never transitioned to `STATE_ENDED` when playing very short files ([#538](https://github.com/androidx/media/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/554)). ### 1.1.0 (2023-07-05) This release corresponds to the [ExoPlayer 2.19.0 release](https://github.com/google/ExoPlayer/releases/tag/r2.19.0). This release contains the following changes since the [1.0.2 release](#102-2023-05-18): * Common Library: * Add suppression reason for unsuitable audio route and play when ready change reason for suppressed too long. ([#15](https://github.com/androidx/media/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/pull/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)` 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](https://github.com/androidx/media/issues/391)). * FMP4: Fix issue where `TimestampAdjuster` initializes a wrong timestamp offset with metadata sample time from emsg atom ([#356](https://github.com/androidx/media/issues/356)). * Audio: * Fix bug where some playbacks fail when tunneling is enabled and `AudioProcessors` are active, e.g. for gapless trimming ([#10847](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/pull/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](https://github.com/google/ExoPlayer/issues/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 a`Player` 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](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/282)). * Add "seek to previous" and "seek to next" command buttons on compact media notification view by default for Android 12 and below ([#410](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/302)). * Use base Uri for relative path resolution from the RTSP session if present in DESCRIBE response header ([#11160](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/issues//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. * Remove deprecated `MediaItem.PlaybackProperties`, use `MediaItem.LocalConfiguration` instead. Deprecated field `MediaItem.playbackProperties` is now of type `MediaItem.LocalConfiguration`. ### 1.1.0-rc01 (2023-06-21) Use the 1.1.0 [stable version](#110-2023-07-05). ### 1.1.0-beta01 (2023-06-07) Use the 1.1.0 [stable version](#110-2023-07-05). ### 1.1.0-alpha01 (2023-05-10) Use the 1.1.0 [stable version](#110-2023-07-05). ## 1.0 ### 1.0.2 (2023-05-18) This release corresponds to the [ExoPlayer 2.18.7 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.7). This release contains the following changes since the [1.0.1 release](#101-2023-04-18): * 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/issues/303)). * Text: * SSA: Add support for UTF-16 files if they start with a byte order mark ([#319](https://github.com/androidx/media/issues/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](https://github.com/androidx/media/issues/355)). * Fix memory leak of `MediaSessionService` or `MediaLibraryService` ([#346](https://github.com/androidx/media/issues/346)). * Fix bug where a combined `Timeline` and position update in a `MediaSession` may cause a `MediaController` to throw an `IllegalStateException`. ### 1.0.1 (2023-04-18) This release corresponds to the [ExoPlayer 2.18.6 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.6). * Core library: * Reset target live stream override when seeking to default position ([#11051](https://github.com/google/ExoPlayer/pull/11051)). * Fix bug where empty sample streams in the media could cause playback to be stuck. * Session: * Fix bug where multiple identical queue items published by a legacy `MediaSessionCompat` result in an exception in `MediaController` ([#290](https://github.com/androidx/media/issues/290)). * Add missing forwarding of `MediaSession.broadcastCustomCommand` to the legacy `MediaControllerCompat.Callback.onSessionEvent` ([#293](https://github.com/androidx/media/issues/293)). * Fix bug where calling `MediaSession.setPlayer` doesn't update the available commands. * Fix issue that `TrackSelectionOverride` instances sent from a `MediaController` are ignored if they reference a group with `Format.metadata` ([#296](https://github.com/androidx/media/issues/296)). * Fix issue where `Player.COMMAND_GET_CURRENT_MEDIA_ITEM` needs to be available to access metadata via the legacy `MediaSessionCompat`. * Fix issue where `MediaSession` instances on a background thread cause crashes when used in `MediaSessionService` ([#318](https://github.com/androidx/media/issues/318)). * Fix issue where a media button receiver was declared by the library without the app having intended this ([#314](https://github.com/androidx/media/issues/314)). * DASH: * Fix handling of empty segment timelines ([#11014](https://github.com/google/ExoPlayer/issues/11014)). * RTSP: * Retry with TCP if RTSP Setup with UDP fails with RTSP Error 461 UnsupportedTransport ([#11069](https://github.com/google/ExoPlayer/issues/11069)). ### 1.0.0 (2023-03-22) This release corresponds to the [ExoPlayer 2.18.5 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.5). There are no changes since 1.0.0-rc02. ### 1.0.0-rc02 (2023-03-02) This release corresponds to the [ExoPlayer 2.18.4 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.4). * Core library: * Fix network type detection on API 33 ([#10970](https://github.com/google/ExoPlayer/issues/10970)). * Fix `NullPointerException` when calling `ExoPlayer.isTunnelingEnabled` ([#10977](https://github.com/google/ExoPlayer/issues/10977)). * Downloads: * Make the maximum difference of the start time of two segments to be merged configurable in `SegmentDownloader` and subclasses ([#248](https://github.com/androidx/media/pull/248)). * Audio: * Fix broken gapless MP3 playback on Samsung devices ([#8594](https://github.com/google/ExoPlayer/issues/8594)). * Fix bug where playback speeds set immediately after disabling audio may be overridden by a previous speed change ([#10882](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/androidx/media/issues/245)). * RTSP: * Catch the IllegalArgumentException thrown in parsing of invalid RTSP Describe response messages ([#10971](https://github.com/google/ExoPlayer/issues/10971)). * Session: * Fix a bug where notification play/pause button doesn't update with player state ([#192](https://github.com/androidx/media/issues/192)). * 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. ### 1.0.0-rc01 (2023-02-16) This release corresponds to the [ExoPlayer 2.18.3 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.3). * 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/10776)). * Add parameter to `BasePlayer.seekTo` to also indicate the command used for seeking. * Use theme when loading drawables on API 21+ ([#220](https://github.com/androidx/media/issues/220)). * Add `ConcatenatingMediaSource2` that allows combining multiple media items into a single window ([#247](https://github.com/androidx/media/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/3752)). * UI: * Fix the deprecated `PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener)` to ensure visibility changes are passed to the registered listener ([#229](https://github.com/androidx/media/issues/229)). * Fix the ordering of the center player controls in `PlayerView` when using a right-to-left (RTL) layout ([#227](https://github.com/androidx/media/issues/227)). * Session: * Add abstract `SimpleBasePlayer` to help implement the `Player` interface for custom players. * Add helper method to convert platform session token to Media3 `SessionToken` ([#171](https://github.com/androidx/media/issues/171)). * Use `onMediaMetadataChanged` to trigger updates of the platform media session ([#219](https://github.com/androidx/media/issues/219)). * Add the media session as an argument of `getMediaButtons()` of the `DefaultMediaNotificationProvider` and use immutable lists for clarity ([#216](https://github.com/androidx/media/issues/216)). * Add `onSetMediaItems` callback listener to provide means to modify/set `MediaItem` list, starting index and position by session before setting onto Player ([#156](https://github.com/androidx/media/issues/156)). * Avoid double tap detection for non-Bluetooth media button events ([#233](https://github.com/androidx/media/issues/233)). * Make `QueueTimeline` more robust in case of a shady legacy session state ([#241](https://github.com/androidx/media/issues/241)). * Cast extension: * Bump Cast SDK version to 21.2.0. * IMA extension: * Map `PLAYER_STATE_LOADING` to `STATE_BUFFERING` ([#245](\(https://github.com/androidx/media/issues/245\)). * 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](https://github.com/google/ExoPlayer/issues/10884)). ### 1.0.0-beta03 (2022-11-22) This release corresponds to the [ExoPlayer 2.18.2 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.2). * Core library: * Add `ExoPlayer.isTunnelingEnabled` to check if tunneling is enabled for the currently selected tracks ([#2518](https://github.com/google/ExoPlayer/issues/2518)). * Add `WrappingMediaSource` to simplify wrapping a single `MediaSource` ([#7279](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` ([#180](https://github.com/androidx/media/issues/180)). * Send missing `onMediaItemTransition` callback when calling `seekToNext` or `seekToPrevious` in a single-item playlist ([#10667](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` ([#10758](https://github.com/google/ExoPlayer/issues/10758)). * Build: * Enforce minimum `compileSdkVersion` to avoid compilation errors ([#10684](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. ([#8944](https://github.com/google/ExoPlayer/issues/8944)). * Downloads: * Fix potential infinite loop in `ProgressiveDownloader` caused by simultaneous download and playback with the same `PriorityTaskManager` ([#10570](https://github.com/google/ExoPlayer/pull/10570)). * Make download notification appear immediately ([#183](https://github.com/androidx/media/pull/183)). * Limit parallel download removals to 1 to avoid excessive thread creation ([#10458](https://github.com/google/ExoPlayer/issues/10458)). * Video: * Try alternative decoder for Dolby Vision if display does not support it. ([#9794](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 ([#10057](https://github.com/google/ExoPlayer/issues/10057)). * Adds `AudioOffloadListener.onExperimentalOffloadedPlayback` for the AudioTrack offload state. ([#134](https://github.com/androidx/media/issues/134)). * Make `AudioTrackBufferSizeProvider` a public interface. * Add `ExoPlayer.setPreferredAudioDevice` to set the preferred audio output device ([#135](https://github.com/androidx/media/issues/135)). * Rename `androidx.media3.exoplayer.audio.AudioProcessor` to `androidx.media3.common.audio.AudioProcessor`. * Map 8-channel and 12-channel audio to the 7.1 and 7.1.4 channel masks respectively on all Android versions ([#10701](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 ([#10666](https://github.com/google/ExoPlayer/issues/10666)). * DASH: * Parse `EventStream.presentationTimeOffset` from manifests ([#10460](https://github.com/google/ExoPlayer/issues/10460)). * UI: * Use current overrides of the player as preset in `TrackSelectionDialogBuilder` ([#10429](https://github.com/google/ExoPlayer/issues/10429)). * Session: * Ensure commands are always executed in the correct order even if some require asynchronous resolution ([#85](https://github.com/androidx/media/issues/85)). * Add `DefaultMediaNotificationProvider.Builder` to build `DefaultMediaNotificationProvider` instances. The builder can configure the notification ID, the notification channel ID and the notification channel name used by the provider. Also, add method `DefaultMediaNotificationProvider.setSmallIcon(int)` to set the notifications small icon. ([#104](https://github.com/androidx/media/issues/104)). * Ensure commands sent before `MediaController.release()` are not dropped ([#99](https://github.com/androidx/media/issues/99)). * `SimpleBitmapLoader` can load bitmap from `file://` URIs ([#108](https://github.com/androidx/media/issues/108)). * Fix assertion that prevents `MediaController` to seek over an ad in a period ([#122](https://github.com/androidx/media/issues/122)). * When playback ends, the `MediaSessionService` is stopped from the foreground and a notification is shown to restart playback of the last played media item ([#112](https://github.com/androidx/media/issues/112)). * Don't start a foreground service with a pending intent for pause ([#167](https://github.com/androidx/media/issues/167)). * Manually hide the 'badge' associated with the notification created by `DefaultNotificationProvider` on API 26 and API 27 (the badge is automatically hidden on API 28+) ([#131](https://github.com/androidx/media/issues/131)). * Fix bug where a second binder connection from a legacy MediaSession to a Media3 MediaController causes IllegalStateExceptions ([#49](https://github.com/androidx/media/issues/49)). * RTSP: * Add H263 fragmented packet handling ([#119](https://github.com/androidx/media/pull/119)). * Add support for MP4A-LATM ([#162](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 ([#10510](https://github.com/google/ExoPlayer/issues/10510)). * Prevent skipping mid-roll ads when seeking to the end of the content ([#10685](https://github.com/google/ExoPlayer/issues/10685)). * Correctly calculate window duration for live streams with server-side inserted ads, for example IMA DAI ([#10764](https://github.com/google/ExoPlayer/issues/10764)). * FFmpeg extension: * Add newly required flags to link FFmpeg libraries with NDK 23.1.7779620 and above ([#9933](https://github.com/google/ExoPlayer/issues/9933)). * AV1 extension: * Update CMake version to avoid incompatibilities with the latest Android Studio releases ([#9933](https://github.com/google/ExoPlayer/issues/9933)). * Cast extension: * Implement `getDeviceInfo()` to be able to identify `CastPlayer` when controlling playback with a `MediaController` ([#142](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. ### 1.0.0-beta02 (2022-07-21) This release corresponds to the [ExoPlayer 2.18.1 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.1). * 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](https://github.com/google/ExoPlayer/issues/9889)). * For progressive media, only include selected tracks in buffered position ([#10361](https://github.com/google/ExoPlayer/issues/10361)). * Allow custom logger for all ExoPlayer log output ([#9752](https://github.com/google/ExoPlayer/issues/9752)). * Fix implementation of `setDataSourceFactory` in `DefaultMediaSourceFactory`, which was non-functional in some cases ([#116](https://github.com/androidx/media/issues/116)). * Extractors: * Fix parsing of H265 short term reference picture sets ([#10316](https://github.com/google/ExoPlayer/issues/10316)). * Fix parsing of bitrates from `esds` boxes ([#10381](https://github.com/google/ExoPlayer/issues/10381)). * DASH: * Parse ClearKey license URL from manifests ([#10246](https://github.com/google/ExoPlayer/issues/10246)). * UI: * Ensure TalkBack announces the currently active speed option in the playback controls menu ([#10298](https://github.com/google/ExoPlayer/issues/10298)). * RTSP: * Add VP8 fragmented packet handling ([#110](https://github.com/androidx/media/pull/110)). * Support frames/fragments in VP9 ([#115](https://github.com/androidx/media/pull/115)). * Leanback extension: * Listen to `playWhenReady` changes in `LeanbackAdapter` ([10420](https://github.com/google/ExoPlayer/issues/10420)). * Cast: * Use the `MediaItem` that has been passed to the playlist methods as `Window.mediaItem` in `CastTimeline` ([#25](https://github.com/androidx/media/issues/25), [#8212](https://github.com/google/ExoPlayer/issues/8212)). * Support `Player.getMetadata()` and `Listener.onMediaMetadataChanged()` with `CastPlayer` ([#25](https://github.com/androidx/media/issues/25)). ### 1.0.0-beta01 (2022-06-16) This release corresponds to the [ExoPlayer 2.18.0 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.0). * 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](https://support.google.com/accounts/answer/6078260) 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](https://github.com/google/ExoPlayer/issues/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](https://developer.android.com/reference/android/media/Spatializer) (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](https://developer.android.com/reference/android/media/Spatializer.OnSpatializerStateChangedListener) and trigger a new track selection upon these. Devices with a `television` [UI mode](https://developer.android.com/guide/topics/resources/providing-resources#UiModeQualifier) 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](https://github.com/google/ExoPlayer/issues/10204)). * Configure `AudioTrack` with channel mask `AudioFormat.CHANNEL_OUT_7POINT1POINT4` if the decoder outputs 12 channel PCM audio ([#10322](#https://github.com/google/ExoPlayer/pull/10322)). * DRM * Ensure the DRM session is always correctly updated when seeking immediately after a format change ([#10274](https://github.com/google/ExoPlayer/issues/10274)). * Text: * Change `Player.getCurrentCues()` to return `CueGroup` instead of `List`. * SSA: Support `OutlineColour` style setting when `BorderStyle == 3` (i.e. `OutlineColour` sets the background of the cue) ([#8435](https://github.com/google/ExoPlayer/issues/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: * Add support for AVI ([#2092](https://github.com/google/ExoPlayer/issues/2092)). * Matroska: Parse `DiscardPadding` for Opus tracks. * MP4: Parse bitrates from `esds` boxes. * Ogg: Allow duplicate Opus ID and comment headers ([#10038](https://github.com/google/ExoPlayer/issues/10038)). * UI: * Fix delivery of events to `OnClickListener`s set on `PlayerView`, in the case that `useController=false` ([#9605](https://github.com/google/ExoPlayer/issues/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 `PlayerView` before `ACTION_UP` as a click ([#9861](https://github.com/google/ExoPlayer/issues/9861)). * Fix `PlayerView` accessibility issue where tapping might toggle playback rather than hiding the controls ([#8627](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9432)). * DASH: * Parse channel count from DTS `AudioChannelConfiguration` elements. This re-enables audio passthrough for DTS streams ([#10159](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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 H263 ([#63](https://github.com/androidx/media/pull/63)). * Add RTP reader for MPEG4 ([#35](https://github.com/androidx/media/pull/35)). * Add RTP reader for HEVC ([#36](https://github.com/androidx/media/pull/36)). * Add RTP reader for AMR. Currently only mono-channel, non-interleaved AMR streams are supported. Compound AMR RTP payload is not supported. ([#46](https://github.com/androidx/media/pull/46)) * Add RTP reader for VP8 ([#47](https://github.com/androidx/media/pull/47)). * Add RTP reader for WAV ([#56](https://github.com/androidx/media/pull/56)). * Fix RTSP basic authorization header. ([#9544](https://github.com/google/ExoPlayer/issues/9544)). * Stop checking mandatory SDP fields as ExoPlayer doesn't need them ([#10049](https://github.com/google/ExoPlayer/issues/10049)). * Throw checked exception when parsing RTSP timing ([#10165](https://github.com/google/ExoPlayer/issues/10165)). * Add RTP reader for VP9 ([#47](https://github.com/androidx/media/pull/64)). * Add RTP reader for OPUS ([#53](https://github.com/androidx/media/pull/53)). * Session: * Replace `MediaSession.MediaItemFiller` with `MediaSession.Callback.onAddMediaItems` to allow asynchronous resolution of requests. * Support `setMediaItems(s)` methods when `MediaController` connects to a legacy media session. * Remove `MediaController.setMediaUri` and `MediaSession.Callback.onSetMediaUri`. The same functionality can be achieved by using `MediaController.setMediaItem` and `MediaSession.Callback.onAddMediaItems`. * Forward legacy `MediaController` calls to play media to `MediaSession.Callback.onAddMediaItems` instead of `onSetMediaUri`. * Add `MediaNotification.Provider` and `DefaultMediaNotificationProvider` to provide customization of the notification. * Add `BitmapLoader` and `SimpleBitmapLoader` 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` to `MediaSession.Callback`, `MediaLibrarySession.MediaLibrarySessionCallback` to `MediaLibrarySession.Callback` and `MediaSession.Builder.setSessionCallback` to `setCallback`. * Fix NPE in `MediaControllerImplLegacy` ([#59](https://github.com/androidx/media/pull/59)). * Update session position info on timeline change([#51](https://github.com/androidx/media/issues/51)). * Fix NPE in `MediaControllerImplBase` after releasing controller ([#74](https://github.com/androidx/media/issues/74)). * Fix `IndexOutOfBoundsException` when setting less media items than in the current playlist ([#86](https://github.com/androidx/media/issues/86)). * 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](https://github.com/google/ExoPlayer/issues/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. ### 1.0.0-alpha03 (2022-03-14) This release corresponds to the [ExoPlayer 2.17.1 release](https://github.com/google/ExoPlayer/releases/tag/r2.17.1). * 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/10016)). * Ad playback: * Fix audio underruns between ad periods in live HLS SSAI streams. ### 1.0.0-alpha02 (2022-03-02) This release corresponds to the [ExoPlayer 2.17.0 release](https://github.com/google/ExoPlayer/releases/tag/r2.17.0). * Core Library: * 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/8696)). * Add `MediaCodecAdapter.getMetrics()` to allow users obtain metrics data from `MediaCodec` ([#9766](https://github.com/google/ExoPlayer/issues/9766)). * Fix Maven dependency resolution ([#8353](https://github.com/google/ExoPlayer/issues/8353)). * Disable automatic speed adjustment for live streams that neither have low-latency features nor a user request setting the speed ([#9329](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9402)). * Update video track selection logic to take preferred MIME types and role flags into account when selecting multiple video tracks for adaptation ([#9519](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9565)). * Update video track selection logic to prefer more efficient codecs if multiple codecs are supported by primary, hardware-accelerated decoders ([#4835](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9675)). * Fix track selection issue where a mixture of non-empty and empty track overrides is not applied correctly ([#9649](https://github.com/google/ExoPlayer/issues/9649)). * Prohibit duplicate `TrackGroup`s in a `TrackGroupArray`. `TrackGroup`s 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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/8891)). * Retry `AudioTrack` creation if the requested buffer size was > 1MB ([#9712](https://github.com/google/ExoPlayer/issues/9712)). * Extractors: * WAV: Add support for RF64 streams ([#9543](https://github.com/google/ExoPlayer/issues/9543)). * Fix incorrect parsing of H.265 SPS NAL units ([#9719](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9673)). * Add basic support for WebVTT subtitles in Matroska containers ([#9886](https://github.com/google/ExoPlayer/issues/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)](https://support.google.com/admanager/answer/6147120) ([#8213](https://github.com/google/ExoPlayer/issues/8213)). * Add a method to `AdPlaybackState` to allow resetting an ad group so that it can be played again ([#9615](https://github.com/google/ExoPlayer/issues/9615)). * Enforce playback speed of 1.0 during ad playback ([#9018](https://github.com/google/ExoPlayer/issues/9018)). * Fix issue where an ad group that failed to load caused an immediate playback reset ([#9929](https://github.com/google/ExoPlayer/issues/9929)). * UI: * Fix the color of the numbers in `StyledPlayerView` rewind and fastforward buttons when using certain themes ([#9765](https://github.com/google/ExoPlayer/issues/9765)). * Correctly translate playback speed strings ([#9811](https://github.com/google/ExoPlayer/issues/9811)). * DASH: * Add parsed essential and supplemental properties to the `Representation` ([#9579](https://github.com/google/ExoPlayer/issues/9579)). * Support the `forced-subtitle` track role ([#9727](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/9856)). * Support relative `MPD.Location` URLs ([#9939](https://github.com/google/ExoPlayer/issues/9939)). * HLS: * Correctly populate `Format.label` for audio only HLS streams ([#9608](https://github.com/google/ExoPlayer/issues/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](https://github.com/google/ExoPlayer/issues/2882)). * RTSP: * Provide a client API to override the `SocketFactory` used for any server connection ([#9606](https://github.com/google/ExoPlayer/pull/9606)). * Prefer DIGEST authentication method over BASIC if both are present ([#9800](https://github.com/google/ExoPlayer/issues/9800)). * Handle when RTSP track timing is not available ([#9775](https://github.com/google/ExoPlayer/issues/9775)). * Ignore invalid RTP-Info header values ([#9619](https://github.com/google/ExoPlayer/issues/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. * 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](https://github.com/google/ExoPlayer/issues/9792)). * Support audio metadata including artwork with `DefaultMediaItemConverter` ([#9663](https://github.com/google/ExoPlayer/issues/9663)). * FFmpeg extension: * Make `build_ffmpeg.sh` depend on LLVM's bin utils instead of GNU's ([#9933](https://github.com/google/ExoPlayer/issues/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 `PendingIntent`s ([#9528](https://github.com/google/ExoPlayer/issues/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` ### 1.0.0-alpha01 AndroidX Media is the new home for media support libraries, including ExoPlayer. The first alpha contains early, functional implementations of libraries for implementing media use cases, including: * ExoPlayer, an application-level media player for Android that is easy to customize and extend. * Media session functionality, for exposing and controlling playbacks. This new session module uses the same `Player` interface as ExoPlayer. * UI components for building media playback user interfaces. * Modules wrapping functionality in other libraries for use with ExoPlayer, for example, ad insertion via the IMA SDK. ExoPlayer was previously hosted in a separate [ExoPlayer GitHub project](https://github.com/google/ExoPlayer). In AndroidX Media its package name is `androidx.media3.exoplayer`. We plan to continue to maintain and release the ExoPlayer GitHub project for a while to give apps time to migrate. AndroidX Media has replacements for all the ExoPlayer modules, except for the legacy media2 and mediasession extensions, which are together replaced by the new `media3-session` module. This provides direct integration between players and media sessions without needing to use an adapter/connector class.