# ExoPlayer Artifact: [androidx.media3:media3-exoplayer](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/exoplayer/ExoPlayer.java+class:androidx.media3.exoplayer.ExoPlayer) *** ** * ** *** ``` public interface ExoPlayer extends Player ```
Known direct subclasses [SimpleExoPlayer](https://developer.android.com/reference/androidx/media3/exoplayer/SimpleExoPlayer), [StubExoPlayer](https://developer.android.com/reference/androidx/media3/test/utils/StubExoPlayer) |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/SimpleExoPlayer` | **This class is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` instead.
| | `https://developer.android.com/reference/androidx/media3/test/utils/StubExoPlayer` | An abstract `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` implementation that throws `https://developer.android.com/reference/java/lang/UnsupportedOperationException.html` from every method. | *** ** * ** *** An extensible media player that plays `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`s. Instances can be obtained from `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder`. ## Player components ExoPlayer is designed to make few assumptions about (and hence impose few restrictions on) the type of the media being played, how and where it is stored, and how it is rendered. Rather than implementing the loading and rendering of media directly, ExoPlayer implementations delegate this work to components that are injected when a player is created or when it's prepared for playback. Components common to all ExoPlayer implementations are: - **`https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`** that define the media to be played, load the media, and from which the loaded media can be read. MediaSources are created from `https://developer.android.com/reference/androidx/media3/common/MediaItem` by the `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.Factory` injected into the player `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#setMediaSourceFactory(androidx.media3.exoplayer.source.MediaSource.Factory)`, or can be added directly by methods like `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource)`. The library provides a `https://developer.android.com/reference/androidx/media3/exoplayer/source/DefaultMediaSourceFactory` for progressive media files, DASH, SmoothStreaming and HLS, which also includes functionality for side-loading subtitle files and clipping media. - **`https://developer.android.com/reference/androidx/media3/exoplayer/Renderer`** s that render individual components of the media. The library provides default implementations for common media types (`https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoRenderer`, `https://developer.android.com/reference/androidx/media3/exoplayer/audio/MediaCodecAudioRenderer`, `https://developer.android.com/reference/androidx/media3/exoplayer/text/TextRenderer` and `https://developer.android.com/reference/androidx/media3/exoplayer/metadata/MetadataRenderer`). A Renderer consumes media from the MediaSource being played. Renderers are injected when the player is created. The number of renderers and their respective track types can be obtained by calling `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getRendererCount()` and `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getRendererType(int)`. - A **`https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector`** that selects tracks provided by the MediaSource to be consumed by each of the available Renderers. The library provides a default implementation (`https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/DefaultTrackSelector`) suitable for most use cases. A TrackSelector is injected when the player is created. - A **`https://developer.android.com/reference/androidx/media3/exoplayer/LoadControl`** that controls when the MediaSource buffers more media, and how much media is buffered. The library provides a default implementation (`https://developer.android.com/reference/androidx/media3/exoplayer/DefaultLoadControl`) suitable for most use cases. A LoadControl is injected when the player is created. An ExoPlayer can be built using the default components provided by the library, but may also be built using custom implementations if non-standard behaviors are required. For example a custom LoadControl could be injected to change the player's buffering strategy, or a custom Renderer could be injected to add support for a video codec not supported natively by Android. The concept of injecting components that implement pieces of player functionality is present throughout the library. The default component implementations listed above delegate work to further injected components. This allows many sub-components to be individually replaced with custom implementations. For example the default MediaSource implementations require one or more `https://developer.android.com/reference/androidx/media3/datasource/DataSource` factories to be injected via their constructors. By providing a custom factory it's possible to load data from a non-standard source, or through a different network stack. ## Threading model The figure below shows ExoPlayer's threading model. ![ExoPlayer's threading model](https://developer.android.com/static/images/reference/androidx/media3/exoplayer/exoplayer-threading-model.svg) - ExoPlayer instances must be accessed from a single application thread unless indicated otherwise. For the vast majority of cases this should be the application's main thread. Using the application's main thread is also a requirement when using ExoPlayer's UI components or the IMA extension. The thread on which an ExoPlayer instance must be accessed can be explicitly specified by passing a `https://developer.android.com/reference/android/os/Looper.html` when creating the player. If no `Looper` is specified, then the `Looper` of the thread that the player is created on is used, or if that thread does not have a `Looper`, the `Looper` of the application's main thread is used. In all cases the `Looper` of the thread from which the player must be accessed can be queried using `https://developer.android.com/reference/androidx/media3/common/Player#getApplicationLooper()`. - Registered listeners are called on the thread associated with `https://developer.android.com/reference/androidx/media3/common/Player#getApplicationLooper()`. Note that this means registered listeners are called on the same thread which must be used to access the player. - An internal playback thread is responsible for playback. Injected player components such as Renderers, MediaSources, TrackSelectors and LoadControls are called by the player on this thread. - When the application performs an operation on the player, for example a seek, a message is delivered to the internal playback thread via a message queue. The internal playback thread consumes messages from the queue and performs the corresponding operations. Similarly, when a playback event occurs on the internal playback thread, a message is delivered to the application thread via a second message queue. The application thread consumes messages from the queue, updating the application visible state and calling corresponding listener methods. - Injected player components may use additional background threads. For example a MediaSource may use background threads to load data. These are implementation specific. ## Summary | ### Nested types | |---| | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi public interface https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener` A listener for audio offload events. | | `public final class https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder` A builder for `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` instances. | | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi public class https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration` Configuration options for preloading playlist items. | | ### Constants | |---|---| | `default static final long` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#DEFAULT_DETACH_SURFACE_TIMEOUT_MS() = 2000` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_DETACH_SURFACE_TIMEOUT_MS()` instead.
| | `default static final long` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#DEFAULT_RELEASE_TIMEOUT_MS() = 500` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_RELEASE_TIMEOUT_MS()` instead.
| | `default static final int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#DEFAULT_STUCK_BUFFERING_DETECTION_TIMEOUT_MS() = 600000` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_BUFFERING_DETECTION_TIMEOUT_MS()` instead.
| | `default static final int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#DEFAULT_STUCK_PLAYING_NOT_ENDING_TIMEOUT_MS() = 60000` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_PLAYING_NOT_ENDING_TIMEOUT_MS()` instead.
| | `default static final int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#DEFAULT_STUCK_SUPPRESSED_DETECTION_TIMEOUT_MS() = 600000` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_SUPPRESSED_DETECTION_TIMEOUT_MS()` instead.
| | ### Public methods | |---|---| | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addAnalyticsListener(androidx.media3.exoplayer.analytics.AnalyticsListener)(https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener listener)` Adds an `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener` to receive analytics events. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addAudioCodecParametersChangeListener(androidx.media3.exoplayer.CodecParametersChangeListener,java.util.List)( https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener, https://developer.android.com/reference/java/util/List.html keys )` Adds a listener for audio codec parameter changes. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addAudioOffloadListener(androidx.media3.exoplayer.ExoPlayer.AudioOffloadListener)(https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener listener)` Adds a listener to receive audio offload events. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addMediaSource(androidx.media3.exoplayer.source.MediaSource)(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource)` Adds a media source to the end of the playlist. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addMediaSource(int,androidx.media3.exoplayer.source.MediaSource)(int index, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource)` Adds a media source at the given index of the playlist. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addMediaSources(java.util.List)(https://developer.android.com/reference/java/util/List.html mediaSources)` Adds a list of media sources to the end of the playlist. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addMediaSources(int,java.util.List)(int index, https://developer.android.com/reference/java/util/List.html mediaSources)` Adds a list of media sources at the given index of the playlist. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addVideoCodecParametersChangeListener(androidx.media3.exoplayer.CodecParametersChangeListener,java.util.List)( https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener, https://developer.android.com/reference/java/util/List.html keys )` Adds a listener for video codec parameter changes. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)(https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener)` Adds a listener to receive video frame metadata events. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#clearAuxEffectInfo()()` Detaches any previously attached auxiliary audio effect from the underlying audio track. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#clearCameraMotionListener(androidx.media3.exoplayer.video.spherical.CameraMotionListener)(https://developer.android.com/reference/androidx/media3/exoplayer/video/spherical/CameraMotionListener listener)` Clears the listener which receives camera motion events if it matches the one passed. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [clearVideoFrameMetadataListener](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#clearVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener))(https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` instead.
| | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)(https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage.Target target)` Creates a message that can be sent to a `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage.Target`. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsCollector` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getAnalyticsCollector()()` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsCollector` used for collecting analytics events. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getAudioDecoderCounters()()` Returns `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` for audio, or null if no audio is being played. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getAudioFormat()()` Returns the audio format currently being played, or null if no audio is being played. | | `abstract https://developer.android.com/reference/androidx/media3/common/util/Clock` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getClock()()` Returns the `https://developer.android.com/reference/androidx/media3/common/util/Clock` used for playback. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [getCurrentTrackGroups](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getCurrentTrackGroups())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()`.
| | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectionArray` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [getCurrentTrackSelections](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getCurrentTrackSelections())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()`.
| | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getPauseAtEndOfMediaItems()()` Returns whether the player pauses playback at the end of each media item. | | `abstract https://developer.android.com/reference/android/os/Looper.html` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getPlaybackLooper()()` Returns the `https://developer.android.com/reference/android/os/Looper.html` associated with the playback thread. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getPlayerError()()` Equivalent to `https://developer.android.com/reference/androidx/media3/common/Player#getPlayerError()`, except the exception is guaranteed to be an `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException`. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getPreloadConfiguration()()` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration`. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getRenderer(int)(int index)` Returns the renderer at the given index. | | `abstract int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getRendererCount()()` Returns the number of renderers. | | `abstract int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://developer.android.com/reference/androidx/media3/common/C.TrackType https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getRendererType(int)(int index)` Returns the track type that the renderer at a given index handles. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/ScrubbingModeParameters` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getScrubbingModeParameters()()` Gets the parameters that control behavior in `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)`. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getSecondaryRenderer(int)(int index)` Returns the secondary renderer at the given index. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getSeekParameters()()` Returns the currently active `https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters` of the player. | | `abstract https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getShuffleOrder()()` Returns the shuffle order. | | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getSkipSilenceEnabled()()` Returns whether skipping silences in the audio stream is enabled. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getTrackSelector()()` Returns the track selector that this player uses, or null if track selection is not supported. | | `abstract int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getVideoChangeFrameRateStrategy()()` Returns the `https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy`. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getVideoDecoderCounters()()` Returns `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` for video, or null if no video is being played. | | `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getVideoFormat()()` Returns the video format currently being played, or null if no video is being played. | | `abstract int` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi @https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getVideoScalingMode()()` Returns the `https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode`. | | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#isReleased()()` Returns whether `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#release()` has been called on the player. | | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#isScrubbingModeEnabled()()` Returns whether the player is optimized for scrubbing (many frequent seeks). | | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#isSleepingForOffload()()` Returns whether the player has paused its main loop to save power in offload scheduling mode. | | `abstract boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#isTunnelingEnabled()()` Returns whether [tunneling](https://source.android.com/devices/tv/multimedia-tunneling) is enabled for the currently selected tracks. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [prepare](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource))(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource)` and `https://developer.android.com/reference/androidx/media3/common/Player#prepare()` instead.
| | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [prepare](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource,boolean,boolean))( https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource, boolean resetPosition, boolean resetState )` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource,boolean)` and `https://developer.android.com/reference/androidx/media3/common/Player#prepare()` instead.
| | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#release()()` Releases the player. | | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeAnalyticsListener(androidx.media3.exoplayer.analytics.AnalyticsListener)(https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener listener)` Removes an `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeAudioCodecParametersChangeListener(androidx.media3.exoplayer.CodecParametersChangeListener)( https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener )` Removes a listener for audio codec parameter changes. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeAudioOffloadListener(androidx.media3.exoplayer.ExoPlayer.AudioOffloadListener)(https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener listener)` Removes a listener of audio offload events. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoCodecParametersChangeListener(androidx.media3.exoplayer.CodecParametersChangeListener)( https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener )` Removes a listener for video codec parameter changes. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)(https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener)` Removes a listener to receive video frame metadata events. | | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#replaceMediaItem(int,androidx.media3.common.MediaItem)(int index, https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem)` Replaces the media item at the given index of the playlist. | | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#replaceMediaItems(int,int,java.util.List)( int fromIndex, int toIndex, https://developer.android.com/reference/java/util/List.html mediaItems )` Replaces the media items at the given range of the playlist. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setAudioCodecParameters(androidx.media3.exoplayer.CodecParameters)(https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters)` Sets a collection of parameters on the underlying audio codecs. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setAudioSessionId(int)(int audioSessionId)` Sets the ID of the audio session to attach to the underlying `https://developer.android.com/reference/android/media/AudioTrack.html`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setAuxEffectInfo(androidx.media3.common.AuxEffectInfo)(https://developer.android.com/reference/androidx/media3/common/AuxEffectInfo auxEffectInfo)` Sets information on an auxiliary audio effect to attach to the underlying audio track. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setCameraMotionListener(androidx.media3.exoplayer.video.spherical.CameraMotionListener)(https://developer.android.com/reference/androidx/media3/exoplayer/video/spherical/CameraMotionListener listener)` Sets a listener of camera motion events. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setEnforceAdPlaybackOnTimelineRefresh(boolean)( boolean enforceAdPlaybackOnTimelineRefresh )` Sets whether to enforce ad playback on timeline refresh. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setForegroundMode(boolean)(boolean foregroundMode)` Sets whether the player is allowed to keep holding limited resources such as video decoders, even when in the idle state. | | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setHandleAudioBecomingNoisy(boolean)(boolean handleAudioBecomingNoisy)` Sets whether the player should pause automatically when audio is rerouted from a headset to device speakers. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setImageOutput(androidx.media3.exoplayer.image.ImageOutput)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageOutput imageOutput)` Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageOutput` where rendered images will be forwarded. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMaxSeekToPreviousPositionMs(long)( @https://developer.android.com/reference/androidx/annotation/IntRange(from = 0) long maxSeekToPreviousPositionMs )` Sets the maximum position for which `https://developer.android.com/reference/androidx/media3/common/Player#seekToPrevious()` seeks to the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource)(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource)` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` and resets the position to the default position. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource,boolean)(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource, boolean resetPosition)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource,long)(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource, long startPositionMs)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSources(java.util.List)(https://developer.android.com/reference/java/util/List.html mediaSources)` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` and resets the position to the default position. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSources(java.util.List,boolean)(https://developer.android.com/reference/java/util/List.html mediaSources, boolean resetPosition)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSources(java.util.List,int,long)( https://developer.android.com/reference/java/util/List.html mediaSources, int startMediaItemIndex, long startPositionMs )` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPauseAtEndOfMediaItems(boolean)(boolean pauseAtEndOfMediaItems)` Sets whether to pause playback at the end of each media item. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPreferredAudioDevice(android.media.AudioDeviceInfo)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/AudioDeviceInfo.html audioDeviceInfo)` Sets the preferred audio device. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPreloadConfiguration(androidx.media3.exoplayer.ExoPlayer.PreloadConfiguration)( https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration preloadConfiguration )` Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration` to configure playlist preloading. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPriority(int)(@https://developer.android.com/reference/androidx/media3/common/C.Priority int priority)` Sets the `https://developer.android.com/reference/androidx/media3/common/C.Priority` for this player. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPriorityTaskManager(androidx.media3.common.PriorityTaskManager)( @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager priorityTaskManager )` Sets a `https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager`, or null to clear a previously set priority task manager. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)(boolean scrubbingModeEnabled)` Sets whether to optimize the player for scrubbing (many frequent seeks). | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeParameters(androidx.media3.exoplayer.ScrubbingModeParameters)( https://developer.android.com/reference/androidx/media3/exoplayer/ScrubbingModeParameters scrubbingModeParameters )` Sets the parameters that control behavior in `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setSeekBackIncrementMs(long)(@https://developer.android.com/reference/androidx/annotation/IntRange(from = 1) long seekBackIncrementMs)` Sets the `https://developer.android.com/reference/androidx/media3/common/Player#seekBack()` increment. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setSeekForwardIncrementMs(long)(@https://developer.android.com/reference/androidx/annotation/IntRange(from = 1) long seekForwardIncrementMs)` Sets the `https://developer.android.com/reference/androidx/media3/common/Player#seekForward()` increment. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setSeekParameters(androidx.media3.exoplayer.SeekParameters)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters seekParameters)` Sets the parameters that control how seek operations are performed. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setShuffleOrder(androidx.media3.exoplayer.source.ShuffleOrder)(https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder shuffleOrder)` Sets the shuffle order. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setSkipSilenceEnabled(boolean)(boolean skipSilenceEnabled)` Sets whether skipping silences in the audio stream is enabled. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoChangeFrameRateStrategy(int)( @https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy int videoChangeFrameRateStrategy )` Sets a `https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy` that will be used by the player when provided with a video output `https://developer.android.com/reference/android/view/Surface.html`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoCodecParameters(androidx.media3.exoplayer.CodecParameters)(https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters)` Sets a collection of parameters on the underlying video codecs. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoEffects(java.util.List)(https://developer.android.com/reference/java/util/List.html videoEffects)` Sets a `https://developer.android.com/reference/java/util/List.html` of `https://developer.android.com/reference/androidx/media3/common/Effect` that will be applied to each video frame. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [setVideoFrameMetadataListener](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener))(https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` and `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` instead.
| | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoScalingMode(int)(@https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode int videoScalingMode)` Sets the `https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode`. | | `abstract void` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVirtualDeviceId(int)(int virtualDeviceId)` Sets the virtual device id to be used for playback. | | `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setWakeMode(int)(@https://developer.android.com/reference/androidx/media3/common/C.WakeMode int wakeMode)` Sets how the player should keep the device awake for playback when the screen is off. | ### Inherited Constants From [androidx.media3.common.Player](https://developer.android.com/reference/androidx/media3/common/Player) `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_ADJUST_DEVICE_VOLUME() = 26` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS() = 34` Command to increase and decrease the device volume and mute it with volume flags. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_CHANGE_MEDIA_ITEMS() = 20` Command to change the `https://developer.android.com/reference/androidx/media3/common/MediaItem` in the playlist. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_AUDIO_ATTRIBUTES() = 21` Command to get the player current `https://developer.android.com/reference/androidx/media3/common/AudioAttributes`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_CURRENT_MEDIA_ITEM() = 16` Command to get information about the currently playing `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_DEVICE_VOLUME() = 23` Command to get the device volume and whether it is muted. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_MEDIA_ITEMS_METADATA() = 18` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_METADATA()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_METADATA() = 18` Command to get metadata related to the playlist and current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_TEXT() = 28` Command to get the text that should currently be displayed by the player. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_TIMELINE() = 17` Command to get the information about the current timeline. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_TRACKS() = 30` Command to get details of the current track selection. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_GET_VOLUME() = 22` Command to get the player volume. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_INVALID() = -1` Represents an invalid `https://developer.android.com/reference/androidx/media3/common/Player.Command`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_PLAY_PAUSE() = 1` Command to start, pause or resume playback. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_PREPARE() = 2` Command to prepare the player. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_RELEASE() = 32` Command to release the player. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_BACK() = 11` Command to seek back by a fixed increment inside the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_FORWARD() = 12` Command to seek forward by a fixed increment inside the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM() = 5` Command to seek anywhere inside the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_IN_CURRENT_WINDOW() = 5` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_DEFAULT_POSITION() = 4` Command to seek to the default position of the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_MEDIA_ITEM() = 10` Command to seek anywhere in any `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_NEXT() = 9` Command to seek to a later position in the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` or the default position of the next `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_NEXT_MEDIA_ITEM() = 8` Command to seek to the default position of the next `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_NEXT_WINDOW() = 8` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_NEXT_MEDIA_ITEM()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_PREVIOUS() = 7` Command to seek to an earlier position in the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` or the default position of the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM() = 6` Command to seek to the default position of the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_PREVIOUS_WINDOW() = 6` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM()` instead.
`default static final int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_WINDOW() = 10` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SEEK_TO_MEDIA_ITEM()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_AUDIO_ATTRIBUTES() = 35` Command to set the player's audio attributes. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_DEVICE_VOLUME() = 25` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS() = 33` Command to set the device volume with volume flags. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_MEDIA_ITEM() = 31` Command to set a `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_MEDIA_ITEMS_METADATA() = 19` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_PLAYLIST_METADATA()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_PLAYLIST_METADATA() = 19` Command to set the playlist metadata. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_REPEAT_MODE() = 15` Command to set the repeat mode. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_SHUFFLE_MODE() = 14` Command to enable shuffling. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_SPEED_AND_PITCH() = 13` Command to set the playback speed and pitch. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_TRACK_SELECTION_PARAMETERS() = 29` Command to set the player's track selection parameters. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_VIDEO_SURFACE() = 27` Command to set and clear the surface on which to render the video. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_SET_VOLUME() = 24` Command to set the player volume. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#COMMAND_STOP() = 3` Command to stop playback. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_AUTO_TRANSITION() = 0` Automatic playback transition from one period in the timeline to the next. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_INTERNAL() = 5` Discontinuity introduced internally (e.g. by the source). `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_REMOVE() = 4` Discontinuity caused by the removal of the current period from the `https://developer.android.com/reference/androidx/media3/common/Timeline`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_SEEK() = 1` Seek within the current period or to another period. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_SEEK_ADJUSTMENT() = 2` Seek adjustment due to being unable to seek to the requested position or because the seek was permitted to be inexact. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_SILENCE_SKIP() = 6` Discontinuity introduced by a skipped silence. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#DISCONTINUITY_REASON_SKIP() = 3` Discontinuity introduced by a skipped period (for instance a skipped ad). `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_AUDIO_ATTRIBUTES_CHANGED() = 20` `https://developer.android.com/reference/androidx/media3/common/Player#getAudioAttributes()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_AUDIO_SESSION_ID() = 21` The audio session id was set. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_AVAILABLE_COMMANDS_CHANGED() = 13` `https://developer.android.com/reference/androidx/media3/common/Player#isCommandAvailable(int)` changed for at least one `https://developer.android.com/reference/androidx/media3/common/Player.Command`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_CUES() = 27` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentCues()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_DEVICE_INFO_CHANGED() = 29` `https://developer.android.com/reference/androidx/media3/common/Player#getDeviceInfo()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_DEVICE_VOLUME_CHANGED() = 30` `https://developer.android.com/reference/androidx/media3/common/Player#getDeviceVolume()` or `https://developer.android.com/reference/androidx/media3/common/Player#isDeviceMuted()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_IS_LOADING_CHANGED() = 3` `https://developer.android.com/reference/androidx/media3/common/Player#isLoading()` ()} changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_IS_PLAYING_CHANGED() = 7` `https://developer.android.com/reference/androidx/media3/common/Player#isPlaying()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_MAX_SEEK_TO_PREVIOUS_POSITION_CHANGED() = 18` `https://developer.android.com/reference/androidx/media3/common/Player#getMaxSeekToPreviousPosition()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_MEDIA_ITEM_TRANSITION() = 1` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItem()` changed or the player started repeating the current item. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_MEDIA_METADATA_CHANGED() = 14` `https://developer.android.com/reference/androidx/media3/common/Player#getMediaMetadata()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_METADATA() = 28` Metadata associated with the current playback time changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAYBACK_PARAMETERS_CHANGED() = 12` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackParameters()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAYBACK_STATE_CHANGED() = 4` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackState()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED() = 6` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAYER_ERROR() = 10` `https://developer.android.com/reference/androidx/media3/common/Player#getPlayerError()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAYLIST_METADATA_CHANGED() = 15` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaylistMetadata()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_PLAY_WHEN_READY_CHANGED() = 5` `https://developer.android.com/reference/androidx/media3/common/Player#getPlayWhenReady()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_POSITION_DISCONTINUITY() = 11` A position discontinuity occurred. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_RENDERED_FIRST_FRAME() = 26` A frame is rendered for the first time since setting the surface, or since the renderer was reset, or since the stream being rendered was changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_REPEAT_MODE_CHANGED() = 8` `https://developer.android.com/reference/androidx/media3/common/Player#getRepeatMode()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_SEEK_BACK_INCREMENT_CHANGED() = 16` `https://developer.android.com/reference/androidx/media3/common/Player#getSeekBackIncrement()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_SEEK_FORWARD_INCREMENT_CHANGED() = 17` `https://developer.android.com/reference/androidx/media3/common/Player#getSeekForwardIncrement()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_SHUFFLE_MODE_ENABLED_CHANGED() = 9` `https://developer.android.com/reference/androidx/media3/common/Player#getShuffleModeEnabled()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_SKIP_SILENCE_ENABLED_CHANGED() = 23` Skipping silences in the audio stream is enabled or disabled. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_SURFACE_SIZE_CHANGED() = 24` The size of the surface onto which the video is being rendered changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_TIMELINE_CHANGED() = 0` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_TRACKS_CHANGED() = 2` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_TRACK_SELECTION_PARAMETERS_CHANGED() = 19` `https://developer.android.com/reference/androidx/media3/common/Player#getTrackSelectionParameters()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_VIDEO_SIZE_CHANGED() = 25` `https://developer.android.com/reference/androidx/media3/common/Player#getVideoSize()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#EVENT_VOLUME_CHANGED() = 22` `https://developer.android.com/reference/androidx/media3/common/Player#getVolume()` changed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#MEDIA_ITEM_TRANSITION_REASON_AUTO() = 1` Playback has automatically transitioned to the next media item. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#MEDIA_ITEM_TRANSITION_REASON_PLAYLIST_CHANGED() = 3` The current media item has changed because of a change in the playlist. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#MEDIA_ITEM_TRANSITION_REASON_REPEAT() = 0` The media item has been repeated. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#MEDIA_ITEM_TRANSITION_REASON_SEEK() = 2` A seek to another media item has occurred. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_NONE() = 0` Playback is not suppressed. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_SCRUBBING() = 4` Playback is suppressed because the player is currently scrubbing. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS() = 1` Playback is suppressed due to transient audio focus loss. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT() = 3` Playback is suppressed due to attempt to play on an unsuitable audio output (e.g. attempt to play on built-in speaker on a Wear OS device). `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_ROUTE() = 2` **This field is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT()` instead.
`default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_AUDIO_BECOMING_NOISY() = 3` Playback has been paused to avoid becoming noisy. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_AUDIO_FOCUS_LOSS() = 2` Playback has been paused because of a loss of audio focus. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM() = 5` Playback has been paused at the end of a media item. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_REMOTE() = 4` Playback has been started or paused because of a remote change. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_SUPPRESSED_TOO_LONG() = 6` Playback has been paused because playback has been `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()` too long. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST() = 1` Playback has been started or paused by a call to `https://developer.android.com/reference/androidx/media3/common/Player#setPlayWhenReady(boolean)`. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#REPEAT_MODE_ALL() = 2` Repeats the entire timeline infinitely. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#REPEAT_MODE_OFF() = 0` Normal playback without repetition. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#REPEAT_MODE_ONE() = 1` Repeats the currently playing `https://developer.android.com/reference/androidx/media3/common/MediaItem` infinitely during ongoing playback. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#STATE_BUFFERING() = 2` The player is not able to immediately play the media, but is doing work toward being able to do so. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#STATE_ENDED() = 4` The player has finished playing the media. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#STATE_IDLE() = 1` The player is idle, meaning it holds only limited resources. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#STATE_READY() = 3` The player is able to immediately play from its current position. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED() = 0` Timeline changed as a result of a change of the playlist items or the order of the items. `default static final int` `https://developer.android.com/reference/androidx/media3/common/Player#TIMELINE_CHANGE_REASON_SOURCE_UPDATE() = 1` Timeline changed as a result of a source update (e.g. result of a dynamic update by the played media). ### Inherited methods From [androidx.media3.common.Player](https://developer.android.com/reference/androidx/media3/common/Player) `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#addListener(androidx.media3.common.Player.Listener)(https://developer.android.com/reference/androidx/media3/common/Player.Listener listener)` Registers a listener to receive all events from the player. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#addMediaItem(androidx.media3.common.MediaItem)(https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem)` Adds a media item to the end of the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#addMediaItem(int,androidx.media3.common.MediaItem)(int index, https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem)` Adds a media item at the given index of the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#addMediaItems(java.util.List)(https://developer.android.com/reference/java/util/List.html mediaItems)` Adds a list of media items to the end of the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#addMediaItems(int,java.util.List)(int index, https://developer.android.com/reference/java/util/List.html mediaItems)` Adds a list of media items at the given index of the playlist. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#canAdvertiseSession()()` Returns whether the player can be used to advertise a media session. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearMediaItems()()` Clears the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearVideoSurface()()` Clears any `https://developer.android.com/reference/android/view/Surface.html`, `https://developer.android.com/reference/android/view/SurfaceHolder.html`, `https://developer.android.com/reference/android/view/SurfaceView.html` or `https://developer.android.com/reference/android/view/TextureView.html` currently set on the player. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearVideoSurface(android.view.Surface)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/Surface.html surface)` Clears the `https://developer.android.com/reference/android/view/Surface.html` onto which video is being rendered if it matches the one passed. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearVideoSurfaceHolder(android.view.SurfaceHolder)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/SurfaceHolder.html surfaceHolder)` Clears the `https://developer.android.com/reference/android/view/SurfaceHolder.html` that holds the `https://developer.android.com/reference/android/view/Surface.html` onto which video is being rendered if it matches the one passed. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearVideoSurfaceView(android.view.SurfaceView)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/SurfaceView.html surfaceView)` Clears the `https://developer.android.com/reference/android/view/SurfaceView.html` onto which video is being rendered if it matches the one passed. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#clearVideoTextureView(android.view.TextureView)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/TextureView.html textureView)` Clears the `https://developer.android.com/reference/android/view/TextureView.html` onto which video is being rendered if it matches the one passed. `abstract void` `[decreaseDeviceVolume](https://developer.android.com/reference/androidx/media3/common/Player#decreaseDeviceVolume())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#decreaseDeviceVolume(int)` instead.
`abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#decreaseDeviceVolume(int)(@https://developer.android.com/reference/androidx/media3/common/C.VolumeFlags int flags)` Decreases the volume of the device. `abstract https://developer.android.com/reference/android/os/Looper.html` `https://developer.android.com/reference/androidx/media3/common/Player#getApplicationLooper()()` Returns the `https://developer.android.com/reference/android/os/Looper.html` associated with the application thread that's used to access the player and on which player events are received. `abstract https://developer.android.com/reference/androidx/media3/common/AudioAttributes` `https://developer.android.com/reference/androidx/media3/common/Player#getAudioAttributes()()` Returns the attributes for audio playback. `default int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#getAudioSessionId()()` Returns the audio session identifier, or `https://developer.android.com/reference/androidx/media3/common/C#AUDIO_SESSION_ID_UNSET()` if not set. `abstract https://developer.android.com/reference/androidx/media3/common/Player.Commands` `https://developer.android.com/reference/androidx/media3/common/Player#getAvailableCommands()()` Returns the player's currently available `https://developer.android.com/reference/androidx/media3/common/Player.Commands`. `abstract @https://developer.android.com/reference/androidx/annotation/IntRange(from = 0, to = 100) int` `https://developer.android.com/reference/androidx/media3/common/Player#getBufferedPercentage()()` Returns an estimate of the percentage in the current content or ad up to which data is buffered, or 0 if no estimate is available. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getBufferedPosition()()` Returns an estimate of the position in the current content or ad up to which data is buffered, in milliseconds. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getContentBufferedPosition()()` If `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()` returns `true`, returns an estimate of the content position in the current content up to which data is buffered, in milliseconds. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getContentDuration()()` If `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()` returns `true`, returns the duration of the current content in milliseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if the duration is not known. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getContentPosition()()` If `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()` returns `true`, returns the content position that will be played once all ads in the ad group have finished playing, in milliseconds. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentAdGroupIndex()()` If `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()` returns true, returns the index of the ad group in the period currently being played. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentAdIndexInAdGroup()()` If `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()` returns true, returns the index of the ad in its ad group. `abstract https://developer.android.com/reference/androidx/media3/common/text/CueGroup` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentCues()()` Returns the current `https://developer.android.com/reference/androidx/media3/common/text/CueGroup`. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentLiveOffset()()` Returns the offset of the current playback position from the live edge in milliseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if the current `https://developer.android.com/reference/androidx/media3/common/MediaItem``https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemLive()` or the offset is unknown. `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#getCurrentManifest()()` Returns the current manifest. `abstract @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/MediaItem` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItem()()` Returns the currently playing `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItemIndex()()` Returns the index of the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` in the `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()`, or the prospective index if the `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()` is empty. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentPeriodIndex()()` Returns the index of the period currently being played. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentPosition()()` Returns the playback position in the current content or ad, in milliseconds, or the prospective position in milliseconds if the `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()` is empty. `abstract https://developer.android.com/reference/androidx/media3/common/Timeline` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()()` Returns the current `https://developer.android.com/reference/androidx/media3/common/Timeline`. `abstract https://developer.android.com/reference/androidx/media3/common/Tracks` `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()()` Returns the current tracks. `abstract int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [getCurrentWindowIndex](https://developer.android.com/reference/androidx/media3/common/Player#getCurrentWindowIndex())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItemIndex()` instead.
`abstract https://developer.android.com/reference/androidx/media3/common/DeviceInfo` `https://developer.android.com/reference/androidx/media3/common/Player#getDeviceInfo()()` Gets the device information. `abstract @https://developer.android.com/reference/androidx/annotation/IntRange(from = 0) int` `https://developer.android.com/reference/androidx/media3/common/Player#getDeviceVolume()()` Gets the current volume of the device. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getDuration()()` Returns the duration of the current content or ad in milliseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if the duration is not known. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getMaxSeekToPreviousPosition()()` Returns the maximum position for which `https://developer.android.com/reference/androidx/media3/common/Player#seekToPrevious()` seeks to the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`, in milliseconds. `abstract https://developer.android.com/reference/androidx/media3/common/MediaItem` `https://developer.android.com/reference/androidx/media3/common/Player#getMediaItemAt(int)(int index)` Returns the `https://developer.android.com/reference/androidx/media3/common/MediaItem` at the given index. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getMediaItemCount()()` Returns the number of `https://developer.android.com/reference/androidx/media3/common/MediaItem` in the playlist. `abstract https://developer.android.com/reference/androidx/media3/common/MediaMetadata` `https://developer.android.com/reference/androidx/media3/common/Player#getMediaMetadata()()` Returns the current combined `https://developer.android.com/reference/androidx/media3/common/MediaMetadata`, or `https://developer.android.com/reference/androidx/media3/common/MediaMetadata#EMPTY()` if not supported. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getNextMediaItemIndex()()` Returns the index of the `https://developer.android.com/reference/androidx/media3/common/MediaItem` that will be played if `https://developer.android.com/reference/androidx/media3/common/Player#seekToNextMediaItem()` is called, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [getNextWindowIndex](https://developer.android.com/reference/androidx/media3/common/Player#getNextWindowIndex())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#getNextMediaItemIndex()` instead.
`abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#getPlayWhenReady()()` Whether playback will proceed when `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackState()` == `https://developer.android.com/reference/androidx/media3/common/Player#STATE_READY()`. `abstract https://developer.android.com/reference/androidx/media3/common/PlaybackParameters` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackParameters()()` Returns the currently active playback parameters. `abstract int` `@https://developer.android.com/reference/androidx/media3/common/Player.State https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackState()()` Returns the current `https://developer.android.com/reference/androidx/media3/common/Player.State` of the player. `abstract int` `@https://developer.android.com/reference/androidx/media3/common/Player.PlaybackSuppressionReason https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()()` Returns the reason why playback is suppressed even though `https://developer.android.com/reference/androidx/media3/common/Player#getPlayWhenReady()` is ` true`, or `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_NONE()` if playback is not suppressed. `abstract https://developer.android.com/reference/androidx/media3/common/MediaMetadata` `https://developer.android.com/reference/androidx/media3/common/Player#getPlaylistMetadata()()` Returns the playlist `https://developer.android.com/reference/androidx/media3/common/MediaMetadata`, as set by `https://developer.android.com/reference/androidx/media3/common/Player#setPlaylistMetadata(androidx.media3.common.MediaMetadata)`, or `https://developer.android.com/reference/androidx/media3/common/MediaMetadata#EMPTY()` if not supported. `abstract int` `https://developer.android.com/reference/androidx/media3/common/Player#getPreviousMediaItemIndex()()` Returns the index of the `https://developer.android.com/reference/androidx/media3/common/MediaItem` that will be played if `https://developer.android.com/reference/androidx/media3/common/Player#seekToPreviousMediaItem()` is called, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract int` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [getPreviousWindowIndex](https://developer.android.com/reference/androidx/media3/common/Player#getPreviousWindowIndex())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#getPreviousMediaItemIndex()` instead.
`abstract int` `@https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode https://developer.android.com/reference/androidx/media3/common/Player#getRepeatMode()()` Returns the current `https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode` used for playback. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getSeekBackIncrement()()` Returns the `https://developer.android.com/reference/androidx/media3/common/Player#seekBack()` increment. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getSeekForwardIncrement()()` Returns the `https://developer.android.com/reference/androidx/media3/common/Player#seekForward()` increment. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#getShuffleModeEnabled()()` Returns whether shuffling of media items is enabled. `abstract https://developer.android.com/reference/androidx/media3/common/util/Size` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/Player#getSurfaceSize()()` Gets the size of the surface on which the video is rendered. `abstract long` `https://developer.android.com/reference/androidx/media3/common/Player#getTotalBufferedDuration()()` Returns an estimate of the total buffered duration from the current position, in milliseconds. `abstract https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters` `https://developer.android.com/reference/androidx/media3/common/Player#getTrackSelectionParameters()()` Returns the parameters constraining the track selection. `abstract https://developer.android.com/reference/androidx/media3/common/VideoSize` `https://developer.android.com/reference/androidx/media3/common/Player#getVideoSize()()` Gets the size of the video. `abstract @https://developer.android.com/reference/androidx/annotation/FloatRange(from = 0, to = 1.0) float` `https://developer.android.com/reference/androidx/media3/common/Player#getVolume()()` Returns the audio volume, with 0 being silence and 1 being unity gain (signal unchanged). `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#hasNextMediaItem()()` Returns whether a next `https://developer.android.com/reference/androidx/media3/common/MediaItem` exists, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#hasPreviousMediaItem()()` Returns whether a previous media item exists, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract void` `[increaseDeviceVolume](https://developer.android.com/reference/androidx/media3/common/Player#increaseDeviceVolume())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#increaseDeviceVolume(int)` instead.
`abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#increaseDeviceVolume(int)(@https://developer.android.com/reference/androidx/media3/common/C.VolumeFlags int flags)` Increases the volume of the device. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isCommandAvailable(int)(@https://developer.android.com/reference/androidx/media3/common/Player.Command int command)` Returns whether the provided `https://developer.android.com/reference/androidx/media3/common/Player.Command` is available. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemDynamic()()` Returns whether the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` is dynamic (may change when the `https://developer.android.com/reference/androidx/media3/common/Timeline` is updated), or `false` if the `https://developer.android.com/reference/androidx/media3/common/Timeline` is empty. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemLive()()` Returns whether the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` is live, or `false` if the `https://developer.android.com/reference/androidx/media3/common/Timeline` is empty. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemSeekable()()` Returns whether the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` is seekable, or `false` if the `https://developer.android.com/reference/androidx/media3/common/Timeline` is empty. `abstract boolean` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [isCurrentWindowDynamic](https://developer.android.com/reference/androidx/media3/common/Player#isCurrentWindowDynamic())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemDynamic()` instead.
`abstract boolean` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [isCurrentWindowLive](https://developer.android.com/reference/androidx/media3/common/Player#isCurrentWindowLive())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemLive()` instead.
`abstract boolean` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi [isCurrentWindowSeekable](https://developer.android.com/reference/androidx/media3/common/Player#isCurrentWindowSeekable())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#isCurrentMediaItemSeekable()` instead.
`abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isDeviceMuted()()` Gets whether the device is muted or not. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isLoading()()` Whether the player is currently loading the source. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isPlaying()()` Returns whether the player is playing, i.e. `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentPosition()` is advancing. `abstract boolean` `https://developer.android.com/reference/androidx/media3/common/Player#isPlayingAd()()` Returns whether the player is currently playing an ad. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#moveMediaItem(int,int)(int currentIndex, int newIndex)` Moves the media item at the current index to the new index. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#moveMediaItems(int,int,int)(int fromIndex, int toIndex, int newIndex)` Moves the media item range to the new index. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#mute()()` Sets the audio volume to 0. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#pause()()` Pauses playback. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#play()()` Resumes playback as soon as `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackState()` == `https://developer.android.com/reference/androidx/media3/common/Player#STATE_READY()`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#prepare()()` Prepares the player. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#removeListener(androidx.media3.common.Player.Listener)(https://developer.android.com/reference/androidx/media3/common/Player.Listener listener)` Unregister a listener registered through `https://developer.android.com/reference/androidx/media3/common/Player#addListener(androidx.media3.common.Player.Listener)`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#removeMediaItem(int)(int index)` Removes the media item at the given index of the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#removeMediaItems(int,int)(int fromIndex, int toIndex)` Removes a range of media items from the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekBack()()` Seeks back in the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` by `https://developer.android.com/reference/androidx/media3/common/Player#getSeekBackIncrement()` milliseconds. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekForward()()` Seeks forward in the current `https://developer.android.com/reference/androidx/media3/common/MediaItem` by `https://developer.android.com/reference/androidx/media3/common/Player#getSeekForwardIncrement()` milliseconds. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekTo(long)(long positionMs)` Seeks to a position specified in milliseconds in the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekTo(int,long)(int mediaItemIndex, long positionMs)` Seeks to a position specified in milliseconds in the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToDefaultPosition()()` Seeks to the default position associated with the current `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToDefaultPosition(int)(int mediaItemIndex)` Seeks to the default position associated with the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToNext()()` Seeks to a later position in the current or next `https://developer.android.com/reference/androidx/media3/common/MediaItem` (if available). `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToNextMediaItem()()` Seeks to the default position of the next `https://developer.android.com/reference/androidx/media3/common/MediaItem`, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToPrevious()()` Seeks to an earlier position in the current or previous `https://developer.android.com/reference/androidx/media3/common/MediaItem` (if available). `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#seekToPreviousMediaItem()()` Seeks to the default position of the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`, which may depend on the current repeat mode and whether shuffle mode is enabled. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setAudioAttributes(androidx.media3.common.AudioAttributes,boolean)( https://developer.android.com/reference/androidx/media3/common/AudioAttributes audioAttributes, boolean handleAudioFocus )` Sets the attributes for audio playback, used by the underlying audio track. `abstract void` `[setDeviceMuted](https://developer.android.com/reference/androidx/media3/common/Player#setDeviceMuted(boolean))(boolean muted)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#setDeviceMuted(boolean,int)` instead.
`abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setDeviceMuted(boolean,int)(boolean muted, @https://developer.android.com/reference/androidx/media3/common/C.VolumeFlags int flags)` Sets the mute state of the device. `abstract void` `[setDeviceVolume](https://developer.android.com/reference/androidx/media3/common/Player#setDeviceVolume(int))(@https://developer.android.com/reference/androidx/annotation/IntRange(from = 0) int volume)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/Player#setDeviceVolume(int,int)` instead.
`abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setDeviceVolume(int,int)(@https://developer.android.com/reference/androidx/annotation/IntRange(from = 0) int volume, @https://developer.android.com/reference/androidx/media3/common/C.VolumeFlags int flags)` Sets the volume of the device with volume flags. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItem(androidx.media3.common.MediaItem)(https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem)` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem` and resets the position to the default position. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItem(androidx.media3.common.MediaItem,boolean)(https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem, boolean resetPosition)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItem(androidx.media3.common.MediaItem,long)(https://developer.android.com/reference/androidx/media3/common/MediaItem mediaItem, long startPositionMs)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItems(java.util.List)(https://developer.android.com/reference/java/util/List.html mediaItems)` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem` and resets the position to the default position. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItems(java.util.List,boolean)(https://developer.android.com/reference/java/util/List.html mediaItems, boolean resetPosition)` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setMediaItems(java.util.List,int,long)( https://developer.android.com/reference/java/util/List.html mediaItems, int startIndex, long startPositionMs )` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/common/MediaItem`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setPlayWhenReady(boolean)(boolean playWhenReady)` Sets whether playback should proceed when `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackState()` == `https://developer.android.com/reference/androidx/media3/common/Player#STATE_READY()`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setPlaybackParameters(androidx.media3.common.PlaybackParameters)(https://developer.android.com/reference/androidx/media3/common/PlaybackParameters playbackParameters)` Attempts to set the playback parameters. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setPlaybackSpeed(float)(@https://developer.android.com/reference/androidx/annotation/FloatRange(from = 0, fromInclusive = false) float speed)` Changes the rate at which playback occurs. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setPlaylistMetadata(androidx.media3.common.MediaMetadata)(https://developer.android.com/reference/androidx/media3/common/MediaMetadata mediaMetadata)` Sets the playlist `https://developer.android.com/reference/androidx/media3/common/MediaMetadata`. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setRepeatMode(int)(@https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode int repeatMode)` Sets the `https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode` to be used for playback. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setShuffleModeEnabled(boolean)(boolean shuffleModeEnabled)` Sets whether shuffling of media items is enabled. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setTrackSelectionParameters(androidx.media3.common.TrackSelectionParameters)(https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters)` Sets the parameters constraining the track selection. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setVideoSurface(android.view.Surface)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/Surface.html surface)` Sets the `https://developer.android.com/reference/android/view/Surface.html` onto which video will be rendered. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setVideoSurfaceHolder(android.view.SurfaceHolder)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/SurfaceHolder.html surfaceHolder)` Sets the `https://developer.android.com/reference/android/view/SurfaceHolder.html` that holds the `https://developer.android.com/reference/android/view/Surface.html` onto which video will be rendered. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setVideoSurfaceView(android.view.SurfaceView)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/SurfaceView.html surfaceView)` Sets the `https://developer.android.com/reference/android/view/SurfaceView.html` onto which video will be rendered. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setVideoTextureView(android.view.TextureView)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/view/TextureView.html textureView)` Sets the `https://developer.android.com/reference/android/view/TextureView.html` onto which video will be rendered. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#setVolume(float)(@https://developer.android.com/reference/androidx/annotation/FloatRange(from = 0, to = 1.0) float volume)` Sets the audio volume, valid values are between 0 (silence) and 1 (unity gain, signal unchanged), inclusive. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#stop()()` Stops playback without resetting the playlist. `abstract void` `https://developer.android.com/reference/androidx/media3/common/Player#unmute()()` If the audio volume is 0, sets the audio volume to a non-zero value decided by the Player to be the most appropriate. ## Constants ### DEFAULT_DETACH_SURFACE_TIMEOUT_MS ``` @UnstableApi default static final long DEFAULT_DETACH_SURFACE_TIMEOUT_MS = 2000 ``` > [!CAUTION] > **This field is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_DETACH_SURFACE_TIMEOUT_MS()` instead. ### DEFAULT_RELEASE_TIMEOUT_MS ``` @UnstableApi default static final long DEFAULT_RELEASE_TIMEOUT_MS = 500 ``` > [!CAUTION] > **This field is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_RELEASE_TIMEOUT_MS()` instead. ### DEFAULT_STUCK_BUFFERING_DETECTION_TIMEOUT_MS ``` @UnstableApi default static final int DEFAULT_STUCK_BUFFERING_DETECTION_TIMEOUT_MS = 600000 ``` > [!CAUTION] > **This field is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_BUFFERING_DETECTION_TIMEOUT_MS()` instead. ### DEFAULT_STUCK_PLAYING_NOT_ENDING_TIMEOUT_MS ``` @UnstableApi default static final int DEFAULT_STUCK_PLAYING_NOT_ENDING_TIMEOUT_MS = 60000 ``` > [!CAUTION] > **This field is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_PLAYING_NOT_ENDING_TIMEOUT_MS()` instead. ### DEFAULT_STUCK_SUPPRESSED_DETECTION_TIMEOUT_MS ``` @UnstableApi default static final int DEFAULT_STUCK_SUPPRESSED_DETECTION_TIMEOUT_MS = 600000 ``` > [!CAUTION] > **This field is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#DEFAULT_STUCK_SUPPRESSED_DETECTION_TIMEOUT_MS()` instead. ## Public methods ### addAnalyticsListener ``` abstract void addAnalyticsListener(AnalyticsListener listener) ``` Adds an `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener` to receive analytics events. This method can be called from any thread. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener listener` | The listener to be added. | ### addAudioCodecParametersChangeListener ``` @UnstableApi abstract void addAudioCodecParametersChangeListener(     CodecParametersChangeListener listener,     List keys ) ``` Adds a listener for audio codec parameter changes. The listener will be called on the application thread. Upon registration, the listener will be immediately called with the last known values for the subscribed keys. The default `https://developer.android.com/reference/android/media/MediaCodec.html` based renderers only support this feature on API level 29 and above. **Note:** When used with `https://developer.android.com/reference/android/media/MediaCodec.html`, observing vendor-specific parameter changes requires API level 31 or higher. On API levels 29 and 30, any requested vendor-specific keys will be ignored. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener` to add. | | `https://developer.android.com/reference/java/util/List.html keys` | The list of parameter keys to subscribe to. | ### addAudioOffloadListener ``` @UnstableApi abstract void addAudioOffloadListener(ExoPlayer.AudioOffloadListener listener) ``` Adds a listener to receive audio offload events. This method can be called from any thread. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener listener` | The listener to register. | ### addMediaSource ``` @UnstableApi abstract void addMediaSource(MediaSource mediaSource) ``` Adds a media source to the end of the playlist. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` to add. | ### addMediaSource ``` @UnstableApi abstract void addMediaSource(int index, MediaSource mediaSource) ``` Adds a media source at the given index of the playlist. | Parameters | |---|---| | `int index` | The index at which to add the source. | | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` to add. | ### addMediaSources ``` @UnstableApi abstract void addMediaSources(List mediaSources) ``` Adds a list of media sources to the end of the playlist. | Parameters | |---|---| | `https://developer.android.com/reference/java/util/List.html mediaSources` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` to add. | ### addMediaSources ``` @UnstableApi abstract void addMediaSources(int index, List mediaSources) ``` Adds a list of media sources at the given index of the playlist. | Parameters | |---|---| | `int index` | The index at which to add the media sources. | | `https://developer.android.com/reference/java/util/List.html mediaSources` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` to add. | ### addVideoCodecParametersChangeListener ``` @UnstableApi abstract void addVideoCodecParametersChangeListener(     CodecParametersChangeListener listener,     List keys ) ``` Adds a listener for video codec parameter changes. The listener will be called on the application thread. Upon registration, the listener will be immediately called with the last known values for the subscribed keys. The default `https://developer.android.com/reference/android/media/MediaCodec.html` based renderers only support this feature on API level 29 and above. **Note:** When used with `https://developer.android.com/reference/android/media/MediaCodec.html`, observing vendor-specific parameter changes requires API level 31 or higher. On API levels 29 and 30, any requested vendor-specific keys will be ignored. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener` to add. | | `https://developer.android.com/reference/java/util/List.html keys` | The list of parameter keys to subscribe to. | ### addVideoFrameMetadataListener ``` @UnstableApi abstract void addVideoFrameMetadataListener(VideoFrameMetadataListener listener) ``` Adds a listener to receive video frame metadata events. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener` | The listener to add. | ### clearAuxEffectInfo ``` @UnstableApi abstract void clearAuxEffectInfo() ``` Detaches any previously attached auxiliary audio effect from the underlying audio track. ### clearCameraMotionListener ``` @UnstableApi abstract void clearCameraMotionListener(CameraMotionListener listener) ``` Clears the listener which receives camera motion events if it matches the one passed. Else does nothing. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/spherical/CameraMotionListener listener` | The listener to clear. | ### clearVideoFrameMetadataListener ``` @UnstableApi abstract void [clearVideoFrameMetadataListener](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#clearVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener))(VideoFrameMetadataListener listener) ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` instead. Clears the listener which receives video frame metadata events. Calling this method is equivalent to calling `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)`. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener` | The listener to clear. | ### createMessage ``` @UnstableApi abstract PlayerMessage createMessage(PlayerMessage.Target target) ``` Creates a message that can be sent to a `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage.Target`. By default, the message will be delivered immediately without blocking on the playback thread. The default `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage#getType()` is 0 and the default `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage#getPayload()` is null. If a position is specified with `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage#setPosition(long)`, the message will be delivered at this position in the current media item defined by `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItemIndex()`. Alternatively, the message can be sent at a specific mediaItem using `https://developer.android.com/reference/androidx/media3/exoplayer/PlayerMessage#setPosition(int,long)`. ### getAnalyticsCollector ``` @UnstableApi abstract AnalyticsCollector getAnalyticsCollector() ``` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsCollector` used for collecting analytics events. ### getAudioDecoderCounters ``` @UnstableApi abstract @Nullable DecoderCounters getAudioDecoderCounters() ``` Returns `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` for audio, or null if no audio is being played. ### getAudioFormat ``` @UnstableApi abstract @Nullable Format getAudioFormat() ``` Returns the audio format currently being played, or null if no audio is being played. ### getClock ``` @UnstableApi abstract Clock getClock() ``` Returns the `https://developer.android.com/reference/androidx/media3/common/util/Clock` used for playback. This method can be called from any thread. ### getCurrentTrackGroups ``` @UnstableApi abstract TrackGroupArray [getCurrentTrackGroups](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getCurrentTrackGroups())() ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()`. Returns the available track groups. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/common/Player.Listener#onTracksChanged(androidx.media3.common.Tracks)` | | ### getCurrentTrackSelections ``` @UnstableApi abstract TrackSelectionArray [getCurrentTrackSelections](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#getCurrentTrackSelections())() ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTracks()`. Returns the current track selections for each renderer, which may include `null` elements if some renderers do not have any selected tracks. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/common/Player.Listener#onTracksChanged(androidx.media3.common.Tracks)` | | ### getPauseAtEndOfMediaItems ``` @UnstableApi abstract boolean getPauseAtEndOfMediaItems() ``` Returns whether the player pauses playback at the end of each media item. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPauseAtEndOfMediaItems(boolean)` | | ### getPlaybackLooper ``` @UnstableApi abstract Looper getPlaybackLooper() ``` Returns the `https://developer.android.com/reference/android/os/Looper.html` associated with the playback thread. This method may be called from any thread. ### getPlayerError ``` abstract @Nullable ExoPlaybackException getPlayerError() ``` Equivalent to `https://developer.android.com/reference/androidx/media3/common/Player#getPlayerError()`, except the exception is guaranteed to be an `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException`. ### getPreloadConfiguration ``` @UnstableApi abstract ExoPlayer.PreloadConfiguration getPreloadConfiguration() ``` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration`. ### getRenderer ``` @UnstableApi abstract Renderer getRenderer(int index) ``` Returns the renderer at the given index. | Parameters | |---|---| | `int index` | The index of the renderer. | | Returns | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` | The renderer at this index. | ### getRendererCount ``` @UnstableApi abstract int getRendererCount() ``` Returns the number of renderers. ### getRendererType ``` @UnstableApi @C.TrackType abstract int getRendererType(int index) ``` Returns the track type that the renderer at a given index handles. For example, a video renderer will return `https://developer.android.com/reference/androidx/media3/common/C#TRACK_TYPE_VIDEO()`, an audio renderer will return `https://developer.android.com/reference/androidx/media3/common/C#TRACK_TYPE_AUDIO()` and a text renderer will return `https://developer.android.com/reference/androidx/media3/common/C#TRACK_TYPE_TEXT()`. | Parameters | |---|---| | `int index` | The index of the renderer. | | Returns | |---|---| | `int` | The `https://developer.android.com/reference/androidx/media3/common/C.TrackType` that the renderer handles. | ### getScrubbingModeParameters ``` @UnstableApi abstract ScrubbingModeParameters getScrubbingModeParameters() ``` Gets the parameters that control behavior in `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)`. ### getSecondaryRenderer ``` @UnstableApi abstract @Nullable Renderer getSecondaryRenderer(int index) ``` Returns the secondary renderer at the given index. | Parameters | |---|---| | `int index` | The index of the secondary renderer. | | Returns | |---|---| | `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` | The secondary renderer at this index, or null if there is no secondary renderer at this index. | ### getSeekParameters ``` @UnstableApi abstract SeekParameters getSeekParameters() ``` Returns the currently active `https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters` of the player. ### getShuffleOrder ``` @UnstableApi abstract ShuffleOrder getShuffleOrder() ``` Returns the shuffle order. The `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder` returned will have the same length as the current playlist (`https://developer.android.com/reference/androidx/media3/common/Player#getMediaItemCount()`). ### getSkipSilenceEnabled ``` @UnstableApi abstract boolean getSkipSilenceEnabled() ``` Returns whether skipping silences in the audio stream is enabled. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/common/Player.Listener#onSkipSilenceEnabledChanged(boolean)` | | ### getTrackSelector ``` @UnstableApi abstract @Nullable TrackSelector getTrackSelector() ``` Returns the track selector that this player uses, or null if track selection is not supported. ### getVideoChangeFrameRateStrategy ``` @UnstableApi @C.VideoChangeFrameRateStrategy abstract int getVideoChangeFrameRateStrategy() ``` Returns the `https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy`. ### getVideoDecoderCounters ``` @UnstableApi abstract @Nullable DecoderCounters getVideoDecoderCounters() ``` Returns `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` for video, or null if no video is being played. ### getVideoFormat ``` @UnstableApi abstract @Nullable Format getVideoFormat() ``` Returns the video format currently being played, or null if no video is being played. ### getVideoScalingMode ``` @UnstableApi @C.VideoScalingMode abstract int getVideoScalingMode() ``` Returns the `https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode`. ### isReleased ``` @UnstableApi abstract boolean isReleased() ``` Returns whether `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#release()` has been called on the player. This method is allowed to be called after `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#release()`. ### isScrubbingModeEnabled ``` @UnstableApi abstract boolean isScrubbingModeEnabled() ``` Returns whether the player is optimized for scrubbing (many frequent seeks). See `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)`. ### isSleepingForOffload ``` @UnstableApi abstract boolean isSleepingForOffload() ``` Returns whether the player has paused its main loop to save power in offload scheduling mode. Offload scheduling mode should save significant power when the phone is playing offload audio with the screen off. Offload scheduling is only enabled when playing an audio track in offload mode, which requires all the following: - Audio offload rendering is enabled through `https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters.Builder#setAudioOffloadPreferences(androidx.media3.common.TrackSelectionParameters.AudioOffloadPreferences)`. - An audio track is playing in a format that the device supports offloading (for example, MP3 or AAC). - The `https://developer.android.com/reference/androidx/media3/exoplayer/audio/AudioSink` is playing with an offload `https://developer.android.com/reference/android/media/AudioTrack.html`. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener#onSleepingForOffloadChanged(boolean)` | | ### isTunnelingEnabled ``` @UnstableApi abstract boolean isTunnelingEnabled() ``` Returns whether [tunneling](https://source.android.com/devices/tv/multimedia-tunneling) is enabled for the currently selected tracks. | See also | |---|---| | `https://developer.android.com/reference/androidx/media3/common/Player.Listener#onTracksChanged(androidx.media3.common.Tracks)` | | ### prepare ``` @UnstableApi abstract void [prepare](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource))(MediaSource mediaSource) ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource)` and `https://developer.android.com/reference/androidx/media3/common/Player#prepare()` instead. ### prepare ``` @UnstableApi abstract void [prepare](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource,boolean,boolean))(     MediaSource mediaSource,     boolean resetPosition,     boolean resetState ) ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setMediaSource(androidx.media3.exoplayer.source.MediaSource,boolean)` and `https://developer.android.com/reference/androidx/media3/common/Player#prepare()` instead. ### release ``` abstract void release() ``` Releases the player. This method must be called when the player is no longer required. The player must not be used after calling this method. This method must only be called if #COMMAND_RELEASE is \* #getAvailableCommands() available. The exception to the above rule is `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#isReleased()` which can be called on a released player. ### removeAnalyticsListener ``` abstract void removeAnalyticsListener(AnalyticsListener listener) ``` Removes an `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener`. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsListener listener` | The listener to be removed. | ### removeAudioCodecParametersChangeListener ``` @UnstableApi abstract void removeAudioCodecParametersChangeListener(     CodecParametersChangeListener listener ) ``` Removes a listener for audio codec parameter changes. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener` to remove. | ### removeAudioOffloadListener ``` @UnstableApi abstract void removeAudioOffloadListener(ExoPlayer.AudioOffloadListener listener) ``` Removes a listener of audio offload events. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.AudioOffloadListener listener` | The listener to unregister. | ### removeVideoCodecParametersChangeListener ``` @UnstableApi abstract void removeVideoCodecParametersChangeListener(     CodecParametersChangeListener listener ) ``` Removes a listener for video codec parameter changes. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener listener` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParametersChangeListener` to remove. | ### removeVideoFrameMetadataListener ``` @UnstableApi abstract void removeVideoFrameMetadataListener(VideoFrameMetadataListener listener) ``` Removes a listener to receive video frame metadata events. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener` | The listener to remove. | ### replaceMediaItem ``` abstract void replaceMediaItem(int index, MediaItem mediaItem) ``` Replaces the media item at the given index of the playlist. Implementations of this method may attempt to seamlessly continue playback if the currently playing media item is replaced with a compatible one (e.g. same URL, only metadata has changed). This method must only be called if #COMMAND_CHANGE_MEDIA_ITEMS is \* #getAvailableCommands() available. ExoPlayer will keep the existing `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` for this `https://developer.android.com/reference/androidx/media3/common/MediaItem` if `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource#canUpdateMediaItem(androidx.media3.common.MediaItem)` by the `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. If the current item is replaced, this will also not interrupt the ongoing playback. ### replaceMediaItems ``` abstract void replaceMediaItems(     int fromIndex,     int toIndex,     List mediaItems ) ``` Replaces the media items at the given range of the playlist. Implementations of this method may attempt to seamlessly continue playback if the currently playing media item is replaced with a compatible one (e.g. same URL, only metadata has changed). This method must only be called if #COMMAND_CHANGE_MEDIA_ITEMS is \* #getAvailableCommands() available. Note that it is possible to replace a range with an arbitrary number of new items, so that the number of removed items defined by fromIndex} and toIndex} does not have to match the number of added items defined by mediaItems}. As result, it may also change the index of subsequent items not touched by this operation. ExoPlayer will keep the existing `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` instances for the new `https://developer.android.com/reference/androidx/media3/common/MediaItem` if `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource#canUpdateMediaItem(androidx.media3.common.MediaItem)` by all of these `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` instances. If the current item is replaced, this will also not interrupt the ongoing playback. ### setAudioCodecParameters ``` @UnstableApi abstract void setAudioCodecParameters(CodecParameters codecParameters) ``` Sets a collection of parameters on the underlying audio codecs. This method is asynchronous. The parameters will be applied to the audio renderers on the playback thread. The default `https://developer.android.com/reference/android/media/MediaCodec.html` based renderers only support this feature on API level 29 and above. If an underlying decoder does not support a parameter, it will be ignored. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters` to set. | ### setAudioSessionId ``` @UnstableApi abstract void setAudioSessionId(int audioSessionId) ``` Sets the ID of the audio session to attach to the underlying `https://developer.android.com/reference/android/media/AudioTrack.html`. The audio session ID can be generated using `https://developer.android.com/reference/androidx/media3/common/util/Util#generateAudioSessionId(android.content.Context)`. | Parameters | |---|---| | `int audioSessionId` | The audio session ID, or `https://developer.android.com/reference/androidx/media3/common/C#AUDIO_SESSION_ID_UNSET()` if it should be generated by the framework. | ### setAuxEffectInfo ``` @UnstableApi abstract void setAuxEffectInfo(AuxEffectInfo auxEffectInfo) ``` Sets information on an auxiliary audio effect to attach to the underlying audio track. ### setCameraMotionListener ``` @UnstableApi abstract void setCameraMotionListener(CameraMotionListener listener) ``` Sets a listener of camera motion events. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/spherical/CameraMotionListener listener` | The listener. | ### setEnforceAdPlaybackOnTimelineRefresh ``` @UnstableApi abstract void setEnforceAdPlaybackOnTimelineRefresh(     boolean enforceAdPlaybackOnTimelineRefresh ) ``` Sets whether to enforce ad playback on timeline refresh. If `true`, then an ad group resolved at or before the current playback position during a timeline refresh will be played. If `false`, then the resolved ad group will not play. The default is `true`. | Parameters | |---|---| | `boolean enforceAdPlaybackOnTimelineRefresh` | Whether to enforce ad playback on timeline refresh. | ### setForegroundMode ``` @UnstableApi abstract void setForegroundMode(boolean foregroundMode) ``` Sets whether the player is allowed to keep holding limited resources such as video decoders, even when in the idle state. By doing so, the player may be able to reduce latency when starting to play another piece of content for which the same resources are required. This mode should be used with caution, since holding limited resources may prevent other players of media components from acquiring them. It should only be enabled when *both* of the following conditions are true: - The application that owns the player is in the foreground. - The player is used in a way that may benefit from foreground mode. For this to be true, the same player instance must be used to play multiple pieces of content, and there must be gaps between the playbacks (i.e. `https://developer.android.com/reference/androidx/media3/common/Player#stop()` is called to halt one playback, and `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource)` is called some time later to start a new one). Note that foreground mode is *not* useful for switching between content without gaps between the playbacks. For this use case `https://developer.android.com/reference/androidx/media3/common/Player#stop()` does not need to be called, and simply calling `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#prepare(androidx.media3.exoplayer.source.MediaSource)` for the new media will cause limited resources to be retained even if foreground mode is not enabled. If foreground mode is enabled, it's the application's responsibility to disable it when the conditions described above no longer hold. | Parameters | |---|---| | `boolean foregroundMode` | Whether the player is allowed to keep limited resources even when in the idle state. | ### setHandleAudioBecomingNoisy ``` abstract void setHandleAudioBecomingNoisy(boolean handleAudioBecomingNoisy) ``` Sets whether the player should pause automatically when audio is rerouted from a headset to device speakers. See the [audio becoming noisy](https://developer.android.com/guide/topics/media-apps/volume-and-earphones#becoming-noisy) documentation for more information. | Parameters | |---|---| | `boolean handleAudioBecomingNoisy` | Whether the player should pause automatically when audio is rerouted from a headset to device speakers. | ### setImageOutput ``` @UnstableApi abstract void setImageOutput(@Nullable ImageOutput imageOutput) ``` Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageOutput` where rendered images will be forwarded. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageOutput imageOutput` | The `https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageOutput`. May be null to clear a previously set image output. | ### setMaxSeekToPreviousPositionMs ``` @UnstableApi abstract void setMaxSeekToPreviousPositionMs(     @IntRange(from = 0) long maxSeekToPreviousPositionMs ) ``` Sets the maximum position for which `https://developer.android.com/reference/androidx/media3/common/Player#seekToPrevious()` seeks to the previous `https://developer.android.com/reference/androidx/media3/common/MediaItem`. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 0) long maxSeekToPreviousPositionMs` | The maximum position, in milliseconds. | | Throws | |---|---| | `https://developer.android.com/reference/java/lang/IllegalArgumentException.html` | If `maxSeekToPreviousPositionMs` is negative. | ### setMediaSource ``` @UnstableApi abstract void setMediaSource(MediaSource mediaSource) ``` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` and resets the position to the default position. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | ### setMediaSource ``` @UnstableApi abstract void setMediaSource(MediaSource mediaSource, boolean resetPosition) ``` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `boolean resetPosition` | Whether the playback position should be reset to the default position. If false, playback will start from the position defined by `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItemIndex()` and `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentPosition()`. | ### setMediaSource ``` @UnstableApi abstract void setMediaSource(MediaSource mediaSource, long startPositionMs) ``` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource mediaSource` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `long startPositionMs` | The position in milliseconds to start playback from. If `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` is passed, the default position of the given media source is used. | ### setMediaSources ``` @UnstableApi abstract void setMediaSources(List mediaSources) ``` Clears the playlist, adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource` and resets the position to the default position. | Parameters | |---|---| | `https://developer.android.com/reference/java/util/List.html mediaSources` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | ### setMediaSources ``` @UnstableApi abstract void setMediaSources(List mediaSources, boolean resetPosition) ``` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | Parameters | |---|---| | `https://developer.android.com/reference/java/util/List.html mediaSources` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `boolean resetPosition` | Whether the playback position should be reset to the default position in the first `https://developer.android.com/reference/androidx/media3/common/Timeline.Window`. If false, playback will start from the position defined by `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentMediaItemIndex()` and `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentPosition()`. | ### setMediaSources ``` @UnstableApi abstract void setMediaSources(     List mediaSources,     int startMediaItemIndex,     long startPositionMs ) ``` Clears the playlist and adds the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | Parameters | |---|---| | `https://developer.android.com/reference/java/util/List.html mediaSources` | The new `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource`. | | `int startMediaItemIndex` | The media item index to start playback from. If `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` is passed, the current position is not reset. | | `long startPositionMs` | The position in milliseconds to start playback from. If `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` is passed, the default position of the given media source is used. In any case, if `startMediaItemIndex` is set to `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()`, this parameter is ignored and the position is not reset at all. | ### setPauseAtEndOfMediaItems ``` @UnstableApi abstract void setPauseAtEndOfMediaItems(boolean pauseAtEndOfMediaItems) ``` Sets whether to pause playback at the end of each media item. This means the player will pause at the end of each window in the current `https://developer.android.com/reference/androidx/media3/common/Player#getCurrentTimeline()`. Listeners will be informed by a call to `https://developer.android.com/reference/androidx/media3/common/Player.Listener#onPlayWhenReadyChanged(boolean,int)` with the reason `https://developer.android.com/reference/androidx/media3/common/Player#PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM()` when this happens. | Parameters | |---|---| | `boolean pauseAtEndOfMediaItems` | Whether to pause playback at the end of each media item. | ### setPreferredAudioDevice ``` @UnstableApi abstract void setPreferredAudioDevice(@Nullable AudioDeviceInfo audioDeviceInfo) ``` Sets the preferred audio device. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/AudioDeviceInfo.html audioDeviceInfo` | The preferred `https://developer.android.com/reference/android/media/AudioDeviceInfo.html`, or null to restore the default. | ### setPreloadConfiguration ``` @UnstableApi abstract void setPreloadConfiguration(     ExoPlayer.PreloadConfiguration preloadConfiguration ) ``` Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration` to configure playlist preloading. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.PreloadConfiguration preloadConfiguration` | The preload configuration. | ### setPriority ``` @UnstableApi abstract void setPriority(@C.Priority int priority) ``` Sets the `https://developer.android.com/reference/androidx/media3/common/C.Priority` for this player. The priority may influence resource allocation between multiple players or other components running in the same app. This priority is used for the `https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager`, if `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPriorityTaskManager(androidx.media3.common.PriorityTaskManager)`. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/media3/common/C.Priority int priority` | The `https://developer.android.com/reference/androidx/media3/common/C.Priority`. | ### setPriorityTaskManager ``` @UnstableApi abstract void setPriorityTaskManager(     @Nullable PriorityTaskManager priorityTaskManager ) ``` Sets a `https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager`, or null to clear a previously set priority task manager. The priority set via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setPriority(int)` (or `https://developer.android.com/reference/androidx/media3/common/C#PRIORITY_PLAYBACK()` will be set while the player is loading. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager priorityTaskManager` | The `https://developer.android.com/reference/androidx/media3/common/PriorityTaskManager`, or null to clear a previously set priority task manager. | ### setScrubbingModeEnabled ``` @UnstableApi abstract void setScrubbingModeEnabled(boolean scrubbingModeEnabled) ``` Sets whether to optimize the player for scrubbing (many frequent seeks). The player may consume more resources in this mode, so it should only be used for short periods of time in response to user interaction (e.g. dragging on a progress bar UI element). During scrubbing mode playback is `https://developer.android.com/reference/androidx/media3/common/Player#getPlaybackSuppressionReason()` with `https://developer.android.com/reference/androidx/media3/common/Player#PLAYBACK_SUPPRESSION_REASON_SCRUBBING()`. | Parameters | |---|---| | `boolean scrubbingModeEnabled` | Whether scrubbing mode should be enabled. | ### setScrubbingModeParameters ``` @UnstableApi abstract void setScrubbingModeParameters(     ScrubbingModeParameters scrubbingModeParameters ) ``` Sets the parameters that control behavior in `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setScrubbingModeEnabled(boolean)`. ### setSeekBackIncrementMs ``` @UnstableApi abstract void setSeekBackIncrementMs(@IntRange(from = 1) long seekBackIncrementMs) ``` Sets the `https://developer.android.com/reference/androidx/media3/common/Player#seekBack()` increment. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 1) long seekBackIncrementMs` | The seek back increment, in milliseconds. | | Throws | |---|---| | `https://developer.android.com/reference/java/lang/IllegalArgumentException.html` | If `seekBackIncrementMs` is non-positive. | ### setSeekForwardIncrementMs ``` @UnstableApi abstract void setSeekForwardIncrementMs(@IntRange(from = 1) long seekForwardIncrementMs) ``` Sets the `https://developer.android.com/reference/androidx/media3/common/Player#seekForward()` increment. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 1) long seekForwardIncrementMs` | The seek forward increment, in milliseconds. | | Throws | |---|---| | `https://developer.android.com/reference/java/lang/IllegalArgumentException.html` | If `seekForwardIncrementMs` is non-positive. | ### setSeekParameters ``` @UnstableApi abstract void setSeekParameters(@Nullable SeekParameters seekParameters) ``` Sets the parameters that control how seek operations are performed. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters seekParameters` | The seek parameters, or `null` to use the defaults. | ### setShuffleOrder ``` @UnstableApi abstract void setShuffleOrder(ShuffleOrder shuffleOrder) ``` Sets the shuffle order. The `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder` passed must have the same length as the current playlist (`https://developer.android.com/reference/androidx/media3/common/Player#getMediaItemCount()`). | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder shuffleOrder` | The shuffle order. | ### setSkipSilenceEnabled ``` @UnstableApi abstract void setSkipSilenceEnabled(boolean skipSilenceEnabled) ``` Sets whether skipping silences in the audio stream is enabled. | Parameters | |---|---| | `boolean skipSilenceEnabled` | Whether skipping silences in the audio stream is enabled. | ### setVideoChangeFrameRateStrategy ``` @UnstableApi abstract void setVideoChangeFrameRateStrategy(     @C.VideoChangeFrameRateStrategy int videoChangeFrameRateStrategy ) ``` Sets a `https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy` that will be used by the player when provided with a video output `https://developer.android.com/reference/android/view/Surface.html`. The strategy only applies if a `https://developer.android.com/reference/android/media/MediaCodec.html`-based video `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` is enabled. Applications wishing to use `https://developer.android.com/reference/android/view/Surface.html#CHANGE_FRAME_RATE_ALWAYS` should set the mode to `https://developer.android.com/reference/androidx/media3/common/C#VIDEO_CHANGE_FRAME_RATE_STRATEGY_OFF()` to disable calls to `https://developer.android.com/reference/android/view/Surface.html#setFrameRate(float, int)` from ExoPlayer, and should then call `https://developer.android.com/reference/android/view/Surface.html#setFrameRate(float, int)` directly from application code. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy int videoChangeFrameRateStrategy` | A `https://developer.android.com/reference/androidx/media3/common/C.VideoChangeFrameRateStrategy`. | ### setVideoCodecParameters ``` @UnstableApi abstract void setVideoCodecParameters(CodecParameters codecParameters) ``` Sets a collection of parameters on the underlying video codecs. This method is asynchronous. The parameters will be applied to the video renderers on the playback thread. The default `https://developer.android.com/reference/android/media/MediaCodec.html` based renderers only support this feature on API level 29 and above. If an underlying decoder does not support a parameter, it will be ignored. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters` | The `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters` to set. | ### setVideoEffects ``` @UnstableApi abstract void setVideoEffects(List videoEffects) ``` Sets a `https://developer.android.com/reference/java/util/List.html` of `https://developer.android.com/reference/androidx/media3/common/Effect` that will be applied to each video frame. If `https://developer.android.com/reference/androidx/media3/common/Player#setVideoSurface(android.view.Surface)`, the output resolution needs to be signaled by passing a `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)` to the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` with type `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIDEO_OUTPUT_RESOLUTION()` after calling this method. For `https://developer.android.com/reference/android/view/SurfaceView.html`, `https://developer.android.com/reference/android/view/TextureView.html` and `https://developer.android.com/reference/android/view/SurfaceHolder.html` output this happens automatically. Pass `https://developer.android.com/reference/androidx/media3/common/VideoFrameProcessor#REDRAW()` to force the effect pipeline to redraw the effects immediately. To accurately interleave redraws, listen to `https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener#onVideoFrameAboutToBeRendered(long,long,androidx.media3.common.Format,android.media.MediaFormat)` events. The following limitations exist for using `https://developer.android.com/reference/androidx/media3/common/Effect`: - The `androidx.media3:media3-effect` module must be available on the runtime classpath. `androidx.media3:media3-exoplayer` does not explicitly depend on the effect module, so apps must make sure it's available themselves. It must be the same version as the rest of the `androidx.media3` modules being used by the app. - This feature works only with the default `https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` and not custom or extension `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer`. - This feature does not work with `https://developer.android.com/reference/androidx/media3/common/Effect` that update the frame timestamps. - This feature does not work with DRM-protected content. - This method must be called at least once before calling `https://developer.android.com/reference/androidx/media3/common/Player#prepare()` (in order to set up the effects pipeline). The effects can be changed during playback by subsequent calls to this method after `https://developer.android.com/reference/androidx/media3/common/Player#prepare()`. | Parameters | |---|---| | `https://developer.android.com/reference/java/util/List.html videoEffects` | The `https://developer.android.com/reference/java/util/List.html` of `https://developer.android.com/reference/androidx/media3/common/Effect` to apply. | ### setVideoFrameMetadataListener ``` @UnstableApi abstract void [setVideoFrameMetadataListener](https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#setVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener))(VideoFrameMetadataListener listener) ``` > [!CAUTION] > **This method is deprecated.** > > Use `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` and `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` instead. Sets a listener to receive video frame metadata events. Calling this method is equivalent to calling `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#removeVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` for the listener previously set with this method (if any), and then calling `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#addVideoFrameMetadataListener(androidx.media3.exoplayer.video.VideoFrameMetadataListener)` with `listener` (if non-null). | Parameters | |---|---| | `https://developer.android.com/reference/androidx/media3/exoplayer/video/VideoFrameMetadataListener listener` | The listener. | ### setVideoScalingMode ``` @UnstableApi abstract void setVideoScalingMode(@C.VideoScalingMode int videoScalingMode) ``` Sets the `https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode`. The scaling mode only applies if a `https://developer.android.com/reference/android/media/MediaCodec.html`-based video `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` is enabled and if the output surface is owned by a `https://developer.android.com/reference/android/view/SurfaceView.html`. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode int videoScalingMode` | The `https://developer.android.com/reference/androidx/media3/common/C.VideoScalingMode`. | ### setVirtualDeviceId ``` @UnstableApi abstract void setVirtualDeviceId(int virtualDeviceId) ``` Sets the virtual device id to be used for playback. Note that the initial value is obtained from `https://developer.android.com/reference/android/content/Context.html#getDeviceId()` from the `https://developer.android.com/reference/android/content/Context.html` passed to `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer.Builder#Builder(android.content.Context)`. | Parameters | |---|---| | `int virtualDeviceId` | The `https://developer.android.com/reference/android/companion/virtual/VirtualDevice.html#getDeviceId()`, or `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` if unspecified. | ### setWakeMode ``` abstract void setWakeMode(@C.WakeMode int wakeMode) ``` Sets how the player should keep the device awake for playback when the screen is off. Enabling this feature requires the `https://developer.android.com/reference/android/Manifest.permission.html#WAKE_LOCK` permission. It should be used together with a foreground `https://developer.android.com/reference/android/app/Service.html` for use cases where playback occurs and the screen is off (e.g. background audio playback). It is not useful when the screen will be kept on during playback (e.g. foreground video playback). When enabled, the locks (`https://developer.android.com/reference/android/os/PowerManager.WakeLock.html` / `https://developer.android.com/reference/android/net/wifi/WifiManager.WifiLock.html`) will be held whenever the player is in the `https://developer.android.com/reference/androidx/media3/common/Player#STATE_READY()` or `https://developer.android.com/reference/androidx/media3/common/Player#STATE_BUFFERING()` states with `playWhenReady = true`. The locks held depends on the specified `https://developer.android.com/reference/androidx/media3/common/C.WakeMode`. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/media3/common/C.WakeMode int wakeMode` | The `https://developer.android.com/reference/androidx/media3/common/C.WakeMode` option to keep the device awake during playback. |