java.lang.Object
- com.google.android.exoplayer2.BasePlayer
- - com.google.android.exoplayer2.SimpleBasePlayer

All Implemented Interfaces:

Player

Direct Known Subclasses:

LegacyMediaPlayerWrapper
```
public abstract class SimpleBasePlayer
extends BasePlayer
```
A base implementation for Player that reduces the number of methods to implement to a minimum.
Implementation notes:
- Subclasses must override getState() to populate the current player state on request.
- The SimpleBasePlayer.State should set the available commands to indicate which Player methods are supported.
- All setter-like player methods (for example, setPlayWhenReady(boolean)) forward to overridable methods (for example, handleSetPlayWhenReady(boolean)) that can be used to handle these requests. These methods return a ListenableFuture to indicate when the request has been handled and is fully reflected in the values returned from getState(). This class will automatically request a state update once the request is done. If the state changes can be handled synchronously, these methods can return Guava's Futures.immediateVoidFuture().
- Subclasses can manually trigger state updates with invalidateState(), for example if something changes independent of Player method calls.
This base class handles various aspects of the player implementation to simplify the subclass:
- The SimpleBasePlayer.State can only be created with allowed combinations of state values, avoiding any invalid player states.
- Only functionality that is declared as available needs to be implemented. Other methods are automatically ignored.
- Listener handling and informing listeners of state changes is handled automatically.
- The base class provides a framework for asynchronous handling of method calls. It changes the visible playback state immediately to the most likely outcome to ensure the user-visible state changes look like synchronous operations. The state is then updated again once the asynchronous method calls have been fully handled.

Nested Class Summary

Nested Classes
Modifier and Type Class Description

protected static class SimpleBasePlayer.State
An immutable state description of the player.
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Player
  Player.Command, Player.Commands, Player.DiscontinuityReason, Player.Event, Player.Events, Player.Listener, Player.MediaItemTransitionReason, Player.PlaybackSuppressionReason, Player.PlayWhenReadyChangeReason, Player.PositionInfo, Player.RepeatMode, Player.TimelineChangeReason

Field Summary
- Fields inherited from class com.google.android.exoplayer2.BasePlayer
  window
- Fields inherited from interface com.google.android.exoplayer2.Player
  COMMAND_ADJUST_DEVICE_VOLUME, COMMAND_CHANGE_MEDIA_ITEMS, COMMAND_GET_AUDIO_ATTRIBUTES, COMMAND_GET_CURRENT_MEDIA_ITEM, COMMAND_GET_DEVICE_VOLUME, COMMAND_GET_MEDIA_ITEMS_METADATA, COMMAND_GET_TEXT, COMMAND_GET_TIMELINE, COMMAND_GET_TRACKS, COMMAND_GET_VOLUME, COMMAND_INVALID, COMMAND_PLAY_PAUSE, COMMAND_PREPARE, COMMAND_SEEK_BACK, COMMAND_SEEK_FORWARD, COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM, COMMAND_SEEK_IN_CURRENT_WINDOW, COMMAND_SEEK_TO_DEFAULT_POSITION, COMMAND_SEEK_TO_MEDIA_ITEM, COMMAND_SEEK_TO_NEXT, COMMAND_SEEK_TO_NEXT_MEDIA_ITEM, COMMAND_SEEK_TO_NEXT_WINDOW, COMMAND_SEEK_TO_PREVIOUS, COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM, COMMAND_SEEK_TO_PREVIOUS_WINDOW, COMMAND_SEEK_TO_WINDOW, COMMAND_SET_DEVICE_VOLUME, COMMAND_SET_MEDIA_ITEM, COMMAND_SET_MEDIA_ITEMS_METADATA, COMMAND_SET_REPEAT_MODE, COMMAND_SET_SHUFFLE_MODE, COMMAND_SET_SPEED_AND_PITCH, COMMAND_SET_TRACK_SELECTION_PARAMETERS, COMMAND_SET_VIDEO_SURFACE, COMMAND_SET_VOLUME, COMMAND_STOP, DISCONTINUITY_REASON_AUTO_TRANSITION, DISCONTINUITY_REASON_INTERNAL, DISCONTINUITY_REASON_REMOVE, DISCONTINUITY_REASON_SEEK, DISCONTINUITY_REASON_SEEK_ADJUSTMENT, DISCONTINUITY_REASON_SKIP, EVENT_AUDIO_ATTRIBUTES_CHANGED, EVENT_AUDIO_SESSION_ID, EVENT_AVAILABLE_COMMANDS_CHANGED, EVENT_CUES, EVENT_DEVICE_INFO_CHANGED, EVENT_DEVICE_VOLUME_CHANGED, EVENT_IS_LOADING_CHANGED, EVENT_IS_PLAYING_CHANGED, EVENT_MAX_SEEK_TO_PREVIOUS_POSITION_CHANGED, EVENT_MEDIA_ITEM_TRANSITION, EVENT_MEDIA_METADATA_CHANGED, EVENT_METADATA, EVENT_PLAY_WHEN_READY_CHANGED, EVENT_PLAYBACK_PARAMETERS_CHANGED, EVENT_PLAYBACK_STATE_CHANGED, EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED, EVENT_PLAYER_ERROR, EVENT_PLAYLIST_METADATA_CHANGED, EVENT_POSITION_DISCONTINUITY, EVENT_RENDERED_FIRST_FRAME, EVENT_REPEAT_MODE_CHANGED, EVENT_SEEK_BACK_INCREMENT_CHANGED, EVENT_SEEK_FORWARD_INCREMENT_CHANGED, EVENT_SHUFFLE_MODE_ENABLED_CHANGED, EVENT_SKIP_SILENCE_ENABLED_CHANGED, EVENT_SURFACE_SIZE_CHANGED, EVENT_TIMELINE_CHANGED, EVENT_TRACK_SELECTION_PARAMETERS_CHANGED, EVENT_TRACKS_CHANGED, EVENT_VIDEO_SIZE_CHANGED, EVENT_VOLUME_CHANGED, MEDIA_ITEM_TRANSITION_REASON_AUTO, MEDIA_ITEM_TRANSITION_REASON_PLAYLIST_CHANGED, MEDIA_ITEM_TRANSITION_REASON_REPEAT, MEDIA_ITEM_TRANSITION_REASON_SEEK, PLAY_WHEN_READY_CHANGE_REASON_AUDIO_BECOMING_NOISY, PLAY_WHEN_READY_CHANGE_REASON_AUDIO_FOCUS_LOSS, PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM, PLAY_WHEN_READY_CHANGE_REASON_REMOTE, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST, PLAYBACK_SUPPRESSION_REASON_NONE, PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS, REPEAT_MODE_ALL, REPEAT_MODE_OFF, REPEAT_MODE_ONE, STATE_BUFFERING, STATE_ENDED, STATE_IDLE, STATE_READY, TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED, TIMELINE_CHANGE_REASON_SOURCE_UPDATE

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`SimpleBasePlayer(Looper applicationLooper)`	Creates the base class.
`protected`	`SimpleBasePlayer(Looper applicationLooper, Clock clock)`	Creates the base class.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`addListener(Player.Listener listener)`	Registers a listener to receive all events from the player.
`void`	`addMediaItems(int index, List<MediaItem> mediaItems)`	Adds a list of media items at the given index of the playlist.
`void`	`clearVideoSurface()`	Clears any `Surface`, `SurfaceHolder`, `SurfaceView` or `TextureView` currently set on the player.
`void`	`clearVideoSurface(Surface surface)`	Clears the `Surface` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoSurfaceHolder(SurfaceHolder surfaceHolder)`	Clears the `SurfaceHolder` that holds the `Surface` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoSurfaceView(SurfaceView surfaceView)`	Clears the `SurfaceView` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoTextureView(TextureView textureView)`	Clears the `TextureView` onto which video is being rendered if it matches the one passed.
`void`	`decreaseDeviceVolume()`	Decreases the volume of the device.
`Looper`	`getApplicationLooper()`	Returns the `Looper` associated with the application thread that's used to access the player and on which player events are received.
`AudioAttributes`	`getAudioAttributes()`	Returns the attributes for audio playback.
`Player.Commands`	`getAvailableCommands()`	Returns the player's currently available `Player.Commands`.
`long`	`getBufferedPosition()`	Returns an estimate of the position in the current content or ad up to which data is buffered, in milliseconds.
`long`	`getContentBufferedPosition()`	If `Player.isPlayingAd()` returns `true`, returns an estimate of the content position in the current content up to which data is buffered, in milliseconds.
`long`	`getContentPosition()`	If `Player.isPlayingAd()` returns `true`, returns the content position that will be played once all ads in the ad group have finished playing, in milliseconds.
`int`	`getCurrentAdGroupIndex()`	If `Player.isPlayingAd()` returns true, returns the index of the ad group in the period currently being played.
`int`	`getCurrentAdIndexInAdGroup()`	If `Player.isPlayingAd()` returns true, returns the index of the ad in its ad group.
`CueGroup`	`getCurrentCues()`	Returns the current `CueGroup`.
`int`	`getCurrentMediaItemIndex()`	Returns the index of the current `MediaItem` in the `timeline`, or the prospective index if the `current timeline` is empty.
`int`	`getCurrentPeriodIndex()`	Returns the index of the period currently being played.
`long`	`getCurrentPosition()`	Returns the playback position in the current content or ad, in milliseconds, or the prospective position in milliseconds if the `current timeline` is empty.
`Timeline`	`getCurrentTimeline()`	Returns the current `Timeline`.
`Tracks`	`getCurrentTracks()`	Returns the current tracks.
`DeviceInfo`	`getDeviceInfo()`	Gets the device information.
`int`	`getDeviceVolume()`	Gets the current volume of the device.
`long`	`getDuration()`	Returns the duration of the current content or ad in milliseconds, or `C.TIME_UNSET` if the duration is not known.
`long`	`getMaxSeekToPreviousPosition()`	Returns the maximum position for which `Player.seekToPrevious()` seeks to the previous `MediaItem`, in milliseconds.
`MediaMetadata`	`getMediaMetadata()`	Returns the current combined `MediaMetadata`, or `MediaMetadata.EMPTY` if not supported.
`protected SimpleBasePlayer.State`	`getPlaceholderState(SimpleBasePlayer.State suggestedPlaceholderState)`	Returns the placeholder state used while a player method is handled asynchronously.
`PlaybackParameters`	`getPlaybackParameters()`	Returns the currently active playback parameters.
`int`	`getPlaybackState()`	Returns the current `playback state` of the player.
`int`	`getPlaybackSuppressionReason()`	Returns the reason why playback is suppressed even though `Player.getPlayWhenReady()` is `true`, or `Player.PLAYBACK_SUPPRESSION_REASON_NONE` if playback is not suppressed.
`PlaybackException`	`getPlayerError()`	Returns the error that caused playback to fail.
`MediaMetadata`	`getPlaylistMetadata()`	Returns the playlist `MediaMetadata`, as set by `Player.setPlaylistMetadata(MediaMetadata)`, or `MediaMetadata.EMPTY` if not supported.
`boolean`	`getPlayWhenReady()`	Whether playback will proceed when `Player.getPlaybackState()` == `Player.STATE_READY`.
`int`	`getRepeatMode()`	Returns the current `Player.RepeatMode` used for playback.
`long`	`getSeekBackIncrement()`	Returns the `Player.seekBack()` increment.
`long`	`getSeekForwardIncrement()`	Returns the `Player.seekForward()` increment.
`boolean`	`getShuffleModeEnabled()`	Returns whether shuffling of media items is enabled.
`protected abstract SimpleBasePlayer.State`	`getState()`	Returns the current `SimpleBasePlayer.State` of the player.
`Size`	`getSurfaceSize()`	Gets the size of the surface on which the video is rendered.
`long`	`getTotalBufferedDuration()`	Returns an estimate of the total buffered duration from the current position, in milliseconds.
`TrackSelectionParameters`	`getTrackSelectionParameters()`	Returns the parameters constraining the track selection.
`VideoSize`	`getVideoSize()`	Gets the size of the video.
`float`	`getVolume()`	Returns the audio volume, with 0 being silence and 1 being unity gain (signal unchanged).
`protected ListenableFuture<?>`	`handleSetPlayWhenReady(boolean playWhenReady)`	Handles calls to set `SimpleBasePlayer.State.playWhenReady`.
`void`	`increaseDeviceVolume()`	Increases the volume of the device.
`protected void`	`invalidateState()`	Invalidates the current state.
`boolean`	`isDeviceMuted()`	Gets whether the device is muted or not.
`boolean`	`isLoading()`	Whether the player is currently loading the source.
`boolean`	`isPlayingAd()`	Returns whether the player is currently playing an ad.
`void`	`moveMediaItems(int fromIndex, int toIndex, int newIndex)`	Moves the media item range to the new index.
`void`	`prepare()`	Prepares the player.
`void`	`release()`	Releases the player.
`void`	`removeListener(Player.Listener listener)`	Unregister a listener registered through `Player.addListener(Listener)`.
`void`	`removeMediaItems(int fromIndex, int toIndex)`	Removes a range of media items from the playlist.
`void`	`seekTo(int mediaItemIndex, long positionMs)`	Seeks to a position specified in milliseconds in the specified `MediaItem`.
`void`	`setDeviceMuted(boolean muted)`	Sets the mute state of the device.
`void`	`setDeviceVolume(int volume)`	Sets the volume of the device.
`void`	`setMediaItems(List<MediaItem> mediaItems, boolean resetPosition)`	Clears the playlist and adds the specified `MediaItems`.
`void`	`setMediaItems(List<MediaItem> mediaItems, int startIndex, long startPositionMs)`	Clears the playlist and adds the specified `MediaItems`.
`void`	`setPlaybackParameters(PlaybackParameters playbackParameters)`	Attempts to set the playback parameters.
`void`	`setPlaylistMetadata(MediaMetadata mediaMetadata)`	Sets the playlist `MediaMetadata`.
`void`	`setPlayWhenReady(boolean playWhenReady)`	Sets whether playback should proceed when `Player.getPlaybackState()` == `Player.STATE_READY`.
`void`	`setRepeatMode(int repeatMode)`	Sets the `Player.RepeatMode` to be used for playback.
`void`	`setShuffleModeEnabled(boolean shuffleModeEnabled)`	Sets whether shuffling of media items is enabled.
`void`	`setTrackSelectionParameters(TrackSelectionParameters parameters)`	Sets the parameters constraining the track selection.
`void`	`setVideoSurface(Surface surface)`	Sets the `Surface` onto which video will be rendered.
`void`	`setVideoSurfaceHolder(SurfaceHolder surfaceHolder)`	Sets the `SurfaceHolder` that holds the `Surface` onto which video will be rendered.
`void`	`setVideoSurfaceView(SurfaceView surfaceView)`	Sets the `SurfaceView` onto which video will be rendered.
`void`	`setVideoTextureView(TextureView textureView)`	Sets the `TextureView` onto which video will be rendered.
`void`	`setVolume(float volume)`	Sets the audio volume, valid values are between 0 (silence) and 1 (unity gain, signal unchanged), inclusive.
`void`	`stop()`	Stops playback without resetting the playlist.
`void`	`stop(boolean reset)`

Methods inherited from class com.google.android.exoplayer2.BasePlayer
addMediaItem, addMediaItem, addMediaItems, canAdvertiseSession, clearMediaItems, getBufferedPercentage, getContentDuration, getCurrentLiveOffset, getCurrentManifest, getCurrentMediaItem, getCurrentWindowIndex, getMediaItemAt, getMediaItemCount, getNextMediaItemIndex, getNextWindowIndex, getPreviousMediaItemIndex, getPreviousWindowIndex, hasNext, hasNextMediaItem, hasNextWindow, hasPrevious, hasPreviousMediaItem, hasPreviousWindow, isCommandAvailable, isCurrentMediaItemDynamic, isCurrentMediaItemLive, isCurrentMediaItemSeekable, isCurrentWindowDynamic, isCurrentWindowLive, isCurrentWindowSeekable, isPlaying, moveMediaItem, next, pause, play, previous, removeMediaItem, repeatCurrentMediaItem, seekBack, seekForward, seekTo, seekToDefaultPosition, seekToDefaultPosition, seekToNext, seekToNextMediaItem, seekToNextWindow, seekToPrevious, seekToPreviousMediaItem, seekToPreviousWindow, setMediaItem, setMediaItem, setMediaItem, setMediaItems, setPlaybackSpeed

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SimpleBasePlayer
```
protected SimpleBasePlayer(Looper applicationLooper)
```
    Creates the base class.
    
    Parameters:
    
    applicationLooper - The Looper that must be used for all calls to the player and that is used to call listeners on.
  - SimpleBasePlayer
```
protected SimpleBasePlayer(Looper applicationLooper,
                           Clock clock)
```
    Creates the base class.
    
    Parameters:
    
    applicationLooper - The Looper that must be used for all calls to the player and that is used to call listeners on.
    
    clock - The Clock that will be used by the player.
- Method Detail
  - addListener
```
public final void addListener(Player.Listener listener)
```
    Description copied from interface: Player
    
    Registers a listener to receive all events from the player.
    The listener's methods will be called on the thread associated with Player.getApplicationLooper().
    
    Parameters:
    
    listener - The listener to register.
  - removeListener
```
public final void removeListener(Player.Listener listener)
```
    Description copied from interface: Player
    
    Unregister a listener registered through Player.addListener(Listener). The listener will no longer receive events.
    
    Parameters:
    
    listener - The listener to unregister.
  - getApplicationLooper
```
public final Looper getApplicationLooper()
```
    Description copied from interface: Player
    
    Returns the Looper associated with the application thread that's used to access the player and on which player events are received.
  - getAvailableCommands
```
public final Player.Commands getAvailableCommands()
```
    Description copied from interface: Player
    
    Returns the player's currently available Player.Commands.
    The returned Player.Commands are not updated when available commands change. Use Player.Listener.onAvailableCommandsChanged(Commands) to get an update when the available commands change.
    Executing a command that is not available (for example, calling Player.seekToNextMediaItem() if Player.COMMAND_SEEK_TO_NEXT_MEDIA_ITEM is unavailable) will neither throw an exception nor generate a Player.getPlayerError() player error}.
    Player.COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM and Player.COMMAND_SEEK_TO_NEXT_MEDIA_ITEM are unavailable if there is no such MediaItem.
    
    Returns:
    
    The currently available Player.Commands.
    
    See Also:
    
    Player.Listener.onAvailableCommandsChanged(com.google.android.exoplayer2.Player.Commands)
  - setPlayWhenReady
```
public final void setPlayWhenReady(boolean playWhenReady)
```
    Description copied from interface: Player
    
    Sets whether playback should proceed when Player.getPlaybackState() == Player.STATE_READY.
    If the player is already in the ready state then this method pauses and resumes playback.
    
    Parameters:
    
    playWhenReady - Whether playback should proceed when ready.
  - getPlayWhenReady
```
public final boolean getPlayWhenReady()
```
    Description copied from interface: Player
    
    Whether playback will proceed when Player.getPlaybackState() == Player.STATE_READY.
    
    Returns:
    
    Whether playback will proceed when ready.
    
    See Also:
    
    Player.Listener.onPlayWhenReadyChanged(boolean, int)
  - setMediaItems
```
public final void setMediaItems(List<MediaItem> mediaItems,
                                boolean resetPosition)
```
    Description copied from interface: Player
    
    Clears the playlist and adds the specified MediaItems.
    
    Parameters:
    
    mediaItems - The new MediaItems.
    
    resetPosition - Whether the playback position should be reset to the default position in the first Timeline.Window. If false, playback will start from the position defined by Player.getCurrentMediaItemIndex() and Player.getCurrentPosition().
  - setMediaItems
```
public final void setMediaItems(List<MediaItem> mediaItems,
                                int startIndex,
                                long startPositionMs)
```
    Description copied from interface: Player
    
    Clears the playlist and adds the specified MediaItems.
    
    Parameters:
    
    mediaItems - The new MediaItems.
    
    startIndex - The MediaItem index to start playback from. If C.INDEX_UNSET is passed, the current position is not reset.
    
    startPositionMs - The position in milliseconds to start playback from. If C.TIME_UNSET is passed, the default position of the given MediaItem is used. In any case, if startIndex is set to C.INDEX_UNSET, this parameter is ignored and the position is not reset at all.
  - addMediaItems
```
public final void addMediaItems(int index,
                                List<MediaItem> mediaItems)
```
    Description copied from interface: Player
    
    Adds a list of media items at the given index of the playlist.
    
    Parameters:
    
    index - The index at which to add the media items. If the index is larger than the size of the playlist, the media items are added to the end of the playlist.
    
    mediaItems - The MediaItems to add.
  - moveMediaItems
```
public final void moveMediaItems(int fromIndex,
                                 int toIndex,
                                 int newIndex)
```
    Description copied from interface: Player
    
    Moves the media item range to the new index.
    
    Parameters:
    
    fromIndex - The start of the range to move.
    
    toIndex - The first item not to be included in the range (exclusive).
    
    newIndex - The new index of the first media item of the range. If the new index is larger than the size of the remaining playlist after removing the range, the range is moved to the end of the playlist.
  - removeMediaItems
```
public final void removeMediaItems(int fromIndex,
                                   int toIndex)
```
    Description copied from interface: Player
    
    Removes a range of media items from the playlist.
    
    Parameters:
    
    fromIndex - The index at which to start removing media items.
    
    toIndex - The index of the first item to be kept (exclusive). If the index is larger than the size of the playlist, media items to the end of the playlist are removed.
  - prepare
```
public final void prepare()
```
    Description copied from interface: Player
    
    Prepares the player.
    This will move the player out of idle state and the player will start loading media and acquire resources needed for playback.
  - getPlaybackState
```
public final int getPlaybackState()
```
    Description copied from interface: Player
    
    Returns the current playback state of the player.
    
    Returns:
    
    The current playback state.
    
    See Also:
    
    Player.Listener.onPlaybackStateChanged(int)
  - getPlaybackSuppressionReason
```
public final int getPlaybackSuppressionReason()
```
    Description copied from interface: Player
    
    Returns the reason why playback is suppressed even though Player.getPlayWhenReady() is true, or Player.PLAYBACK_SUPPRESSION_REASON_NONE if playback is not suppressed.
    
    Returns:
    
    The current playback suppression reason.
    
    See Also:
    
    Player.Listener.onPlaybackSuppressionReasonChanged(int)
  - getPlayerError
```
@Nullable
public final PlaybackException getPlayerError()
```
    Description copied from interface: Player
    
    Returns the error that caused playback to fail. This is the same error that will have been reported via Player.Listener.onPlayerError(PlaybackException) at the time of failure. It can be queried using this method until the player is re-prepared.
    Note that this method will always return null if Player.getPlaybackState() is not Player.STATE_IDLE.
    
    Returns:
    
    The error, or null.
    
    See Also:
    
    Player.Listener.onPlayerError(PlaybackException)
  - setRepeatMode
```
public final void setRepeatMode(int repeatMode)
```
    Description copied from interface: Player
    
    Sets the Player.RepeatMode to be used for playback.
    
    Parameters:
    
    repeatMode - The repeat mode.
  - getRepeatMode
```
public final int getRepeatMode()
```
    Description copied from interface: Player
    
    Returns the current Player.RepeatMode used for playback.
    
    Returns:
    
    The current repeat mode.
    
    See Also:
    
    Player.Listener.onRepeatModeChanged(int)
  - setShuffleModeEnabled
```
public final void setShuffleModeEnabled(boolean shuffleModeEnabled)
```
    Description copied from interface: Player
    
    Sets whether shuffling of media items is enabled.
    
    Parameters:
    
    shuffleModeEnabled - Whether shuffling is enabled.
  - getShuffleModeEnabled
```
public final boolean getShuffleModeEnabled()
```
    Description copied from interface: Player
    
    Returns whether shuffling of media items is enabled.
    
    See Also:
    
    Player.Listener.onShuffleModeEnabledChanged(boolean)
  - isLoading
```
public final boolean isLoading()
```
    Description copied from interface: Player
    
    Whether the player is currently loading the source.
    
    Returns:
    
    Whether the player is currently loading the source.
    
    See Also:
    
    Player.Listener.onIsLoadingChanged(boolean)
  - seekTo
```
public final void seekTo(int mediaItemIndex,
                         long positionMs)
```
    Description copied from interface: Player
    
    Seeks to a position specified in milliseconds in the specified MediaItem.
    
    Parameters:
    
    mediaItemIndex - The index of the MediaItem.
    
    positionMs - The seek position in the specified MediaItem, or C.TIME_UNSET to seek to the media item's default position.
  - getSeekBackIncrement
```
public final long getSeekBackIncrement()
```
    Description copied from interface: Player
    
    Returns the Player.seekBack() increment.
    
    Returns:
    
    The seek back increment, in milliseconds.
    
    See Also:
    
    Player.Listener.onSeekBackIncrementChanged(long)
  - getSeekForwardIncrement
```
public final long getSeekForwardIncrement()
```
    Description copied from interface: Player
    
    Returns the Player.seekForward() increment.
    
    Returns:
    
    The seek forward increment, in milliseconds.
    
    See Also:
    
    Player.Listener.onSeekForwardIncrementChanged(long)
  - getMaxSeekToPreviousPosition
```
public final long getMaxSeekToPreviousPosition()
```
    Description copied from interface: Player
    
    Returns the maximum position for which Player.seekToPrevious() seeks to the previous MediaItem, in milliseconds.
    
    Returns:
    
    The maximum seek to previous position, in milliseconds.
    
    See Also:
    
    Player.Listener.onMaxSeekToPreviousPositionChanged(long)
  - setPlaybackParameters
```
public final void setPlaybackParameters(PlaybackParameters playbackParameters)
```
    Description copied from interface: Player
    
    Attempts to set the playback parameters. Passing PlaybackParameters.DEFAULT resets the player to the default, which means there is no speed or pitch adjustment.
    Playback parameters changes may cause the player to buffer. Player.Listener.onPlaybackParametersChanged(PlaybackParameters) will be called whenever the currently active playback parameters change.
    
    Parameters:
    
    playbackParameters - The playback parameters.
  - getPlaybackParameters
```
public final PlaybackParameters getPlaybackParameters()
```
    Description copied from interface: Player
    
    Returns the currently active playback parameters.
    
    See Also:
    
    Player.Listener.onPlaybackParametersChanged(PlaybackParameters)
  - stop
```
public final void stop()
```
    Description copied from interface: Player
    
    Stops playback without resetting the playlist. Use Player.pause() rather than this method if the intention is to pause playback.
    Calling this method will cause the playback state to transition to Player.STATE_IDLE and the player will release the loaded media and resources required for playback. The player instance can still be used by calling Player.prepare() again, and Player.release() must still be called on the player if it's no longer required.
    Calling this method does not clear the playlist, reset the playback position or the playback error.
  - stop
```
public final void stop(boolean reset)
```
  - release
```
public final void release()
```
    Description copied from interface: Player
    
    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.
  - getCurrentTracks
```
public final Tracks getCurrentTracks()
```
    Description copied from interface: Player
    
    Returns the current tracks.
    
    See Also:
    
    Player.Listener.onTracksChanged(Tracks)
  - getTrackSelectionParameters
```
public final TrackSelectionParameters getTrackSelectionParameters()
```
    Description copied from interface: Player
    
    Returns the parameters constraining the track selection.
    
    See Also:
    
    }
  - setTrackSelectionParameters
```
public final void setTrackSelectionParameters(TrackSelectionParameters parameters)
```
    Description copied from interface: Player
    Sets the parameters constraining the track selection.
    Unsupported parameters will be silently ignored.
    Use Player.getTrackSelectionParameters() to retrieve the current parameters. For example, the following snippet restricts video to SD whilst keep other track selection parameters unchanged:
    player.setTrackSelectionParameters( player.getTrackSelectionParameters() .buildUpon() .setMaxVideoSizeSd() .build())
  - getMediaMetadata
```
public final MediaMetadata getMediaMetadata()
```
    Description copied from interface: Player
    
    Returns the current combined MediaMetadata, or MediaMetadata.EMPTY if not supported.
    This MediaMetadata is a combination of the MediaItem metadata, the static metadata in the media's Format, and any timed metadata that has been parsed from the media and output via Player.Listener.onMetadata(Metadata). If a field is populated in the MediaItem.mediaMetadata, it will be prioritised above the same field coming from static or timed metadata.
  - getPlaylistMetadata
```
public final MediaMetadata getPlaylistMetadata()
```
    Description copied from interface: Player
    
    Returns the playlist MediaMetadata, as set by Player.setPlaylistMetadata(MediaMetadata), or MediaMetadata.EMPTY if not supported.
  - setPlaylistMetadata
```
public final void setPlaylistMetadata(MediaMetadata mediaMetadata)
```
    Description copied from interface: Player
    
    Sets the playlist MediaMetadata.
  - getCurrentTimeline
```
public final Timeline getCurrentTimeline()
```
    Description copied from interface: Player
    
    Returns the current Timeline. Never null, but may be empty.
    
    See Also:
    
    Player.Listener.onTimelineChanged(Timeline, int)
  - getCurrentPeriodIndex
```
public final int getCurrentPeriodIndex()
```
    Description copied from interface: Player
    
    Returns the index of the period currently being played.
  - getCurrentMediaItemIndex
```
public final int getCurrentMediaItemIndex()
```
    Description copied from interface: Player
    
    Returns the index of the current MediaItem in the timeline, or the prospective index if the current timeline is empty.
  - getDuration
```
public final long getDuration()
```
    Description copied from interface: Player
    
    Returns the duration of the current content or ad in milliseconds, or C.TIME_UNSET if the duration is not known.
  - getCurrentPosition
```
public final long getCurrentPosition()
```
    Description copied from interface: Player
    
    Returns the playback position in the current content or ad, in milliseconds, or the prospective position in milliseconds if the current timeline is empty.
  - getBufferedPosition
```
public final long getBufferedPosition()
```
    Description copied from interface: Player
    
    Returns an estimate of the position in the current content or ad up to which data is buffered, in milliseconds.
  - getTotalBufferedDuration
```
public final long getTotalBufferedDuration()
```
    Description copied from interface: Player
    
    Returns an estimate of the total buffered duration from the current position, in milliseconds. This includes pre-buffered data for subsequent ads and media items.
  - isPlayingAd
```
public final boolean isPlayingAd()
```
    Description copied from interface: Player
    
    Returns whether the player is currently playing an ad.
  - getCurrentAdGroupIndex
```
public final int getCurrentAdGroupIndex()
```
    Description copied from interface: Player
    
    If Player.isPlayingAd() returns true, returns the index of the ad group in the period currently being played. Returns C.INDEX_UNSET otherwise.
  - getCurrentAdIndexInAdGroup
```
public final int getCurrentAdIndexInAdGroup()
```
    Description copied from interface: Player
    
    If Player.isPlayingAd() returns true, returns the index of the ad in its ad group. Returns C.INDEX_UNSET otherwise.
  - getContentPosition
```
public final long getContentPosition()
```
    Description copied from interface: Player
    
    If Player.isPlayingAd() returns true, returns the content position that will be played once all ads in the ad group have finished playing, in milliseconds. If there is no ad playing, the returned position is the same as that returned by Player.getCurrentPosition().
  - getContentBufferedPosition
```
public final long getContentBufferedPosition()
```
    Description copied from interface: Player
    
    If Player.isPlayingAd() returns true, returns an estimate of the content position in the current content up to which data is buffered, in milliseconds. If there is no ad playing, the returned position is the same as that returned by Player.getBufferedPosition().
  - getAudioAttributes
```
public final AudioAttributes getAudioAttributes()
```
    Description copied from interface: Player
    
    Returns the attributes for audio playback.
  - setVolume
```
public final void setVolume(float volume)
```
    Description copied from interface: Player
    
    Sets the audio volume, valid values are between 0 (silence) and 1 (unity gain, signal unchanged), inclusive.
    
    Parameters:
    
    volume - Linear output gain to apply to all audio channels.
  - getVolume
```
public final float getVolume()
```
    Description copied from interface: Player
    
    Returns the audio volume, with 0 being silence and 1 being unity gain (signal unchanged).
    
    Returns:
    
    The linear gain applied to all audio channels.
  - clearVideoSurface
```
public final void clearVideoSurface()
```
    Description copied from interface: Player
    
    Clears any Surface, SurfaceHolder, SurfaceView or TextureView currently set on the player.
  - clearVideoSurface
```
public final void clearVideoSurface(@Nullable
                                    Surface surface)
```
    Description copied from interface: Player
    
    Clears the Surface onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Parameters:
    
    surface - The surface to clear.
  - setVideoSurface
```
public final void setVideoSurface(@Nullable
                                  Surface surface)
```
    Description copied from interface: Player
    
    Sets the Surface onto which video will be rendered. The caller is responsible for tracking the lifecycle of the surface, and must clear the surface by calling setVideoSurface(null) if the surface is destroyed.
    If the surface is held by a SurfaceView, TextureView or SurfaceHolder then it's recommended to use Player.setVideoSurfaceView(SurfaceView), Player.setVideoTextureView(TextureView) or Player.setVideoSurfaceHolder(SurfaceHolder) rather than this method, since passing the holder allows the player to track the lifecycle of the surface automatically.
    
    Parameters:
    
    surface - The Surface.
  - setVideoSurfaceHolder
```
public final void setVideoSurfaceHolder(@Nullable
                                        SurfaceHolder surfaceHolder)
```
    Description copied from interface: Player
    
    Sets the SurfaceHolder that holds the Surface onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    The thread that calls the SurfaceHolder.Callback methods must be the thread associated with Player.getApplicationLooper().
    
    Parameters:
    
    surfaceHolder - The surface holder.
  - clearVideoSurfaceHolder
```
public final void clearVideoSurfaceHolder(@Nullable
                                          SurfaceHolder surfaceHolder)
```
    Description copied from interface: Player
    
    Clears the SurfaceHolder that holds the Surface onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Parameters:
    
    surfaceHolder - The surface holder to clear.
  - setVideoSurfaceView
```
public final void setVideoSurfaceView(@Nullable
                                      SurfaceView surfaceView)
```
    Description copied from interface: Player
    
    Sets the SurfaceView onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    The thread that calls the SurfaceHolder.Callback methods must be the thread associated with Player.getApplicationLooper().
    
    Parameters:
    
    surfaceView - The surface view.
  - clearVideoSurfaceView
```
public final void clearVideoSurfaceView(@Nullable
                                        SurfaceView surfaceView)
```
    Description copied from interface: Player
    
    Clears the SurfaceView onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Parameters:
    
    surfaceView - The texture view to clear.
  - setVideoTextureView
```
public final void setVideoTextureView(@Nullable
                                      TextureView textureView)
```
    Description copied from interface: Player
    
    Sets the TextureView onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    The thread that calls the TextureView.SurfaceTextureListener methods must be the thread associated with Player.getApplicationLooper().
    
    Parameters:
    
    textureView - The texture view.
  - clearVideoTextureView
```
public final void clearVideoTextureView(@Nullable
                                        TextureView textureView)
```
    Description copied from interface: Player
    
    Clears the TextureView onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Parameters:
    
    textureView - The texture view to clear.
  - getVideoSize
```
public final VideoSize getVideoSize()
```
    Description copied from interface: Player
    
    Gets the size of the video.
    The video's width and height are 0 if there is no video or its size has not been determined yet.
    
    See Also:
    
    Player.Listener.onVideoSizeChanged(VideoSize)
  - getSurfaceSize
```
public final Size getSurfaceSize()
```
    Description copied from interface: Player
    
    Gets the size of the surface on which the video is rendered.
    
    See Also:
    
    Player.Listener.onSurfaceSizeChanged(int, int)
  - getCurrentCues
```
public final CueGroup getCurrentCues()
```
    Description copied from interface: Player
    
    Returns the current CueGroup.
  - getDeviceInfo
```
public final DeviceInfo getDeviceInfo()
```
    Description copied from interface: Player
    
    Gets the device information.
  - getDeviceVolume
```
public final int getDeviceVolume()
```
    Description copied from interface: Player
    
    Gets the current volume of the device.
    For devices with local playback, the volume returned by this method varies according to the current stream type. The stream type is determined by AudioAttributes.usage which can be converted to stream type with Util.getStreamTypeForAudioUsage(int).
    For devices with remote playback, the volume of the remote device is returned.
  - isDeviceMuted
```
public final boolean isDeviceMuted()
```
    Description copied from interface: Player
    
    Gets whether the device is muted or not.
  - setDeviceVolume
```
public final void setDeviceVolume(int volume)
```
    Description copied from interface: Player
    
    Sets the volume of the device.
    
    Parameters:
    
    volume - The volume to set.
  - increaseDeviceVolume
```
public final void increaseDeviceVolume()
```
    Description copied from interface: Player
    
    Increases the volume of the device.
  - decreaseDeviceVolume
```
public final void decreaseDeviceVolume()
```
    Description copied from interface: Player
    
    Decreases the volume of the device.
  - setDeviceMuted
```
public final void setDeviceMuted(boolean muted)
```
    Description copied from interface: Player
    
    Sets the mute state of the device.
  - invalidateState
```
protected final void invalidateState()
```
    Invalidates the current state.
    Triggers a call to getState() and informs listeners if the state changed.
    Note that this may not have an immediate effect while there are still player methods being handled asynchronously. The state will be invalidated automatically once these pending synchronous operations are finished and there is no need to call this method again.
  - getState
```
@ForOverride
protected abstract SimpleBasePlayer.State getState()
```
    Returns the current SimpleBasePlayer.State of the player.
    The SimpleBasePlayer.State should include all available commands indicating which player methods are allowed to be called.
    Note that this method won't be called while asynchronous handling of player methods is in progress. This means that the implementation doesn't need to handle state changes caused by these asynchronous operations until they are done and can return the currently known state directly. The placeholder state used while these asynchronous operations are in progress can be customized by overriding getPlaceholderState(State) if required.
  - getPlaceholderState
```
@ForOverride
protected SimpleBasePlayer.State getPlaceholderState(SimpleBasePlayer.State suggestedPlaceholderState)
```
    Returns the placeholder state used while a player method is handled asynchronously.
    The suggestedPlaceholderState already contains the most likely state update, for example setting SimpleBasePlayer.State.playWhenReady to true if player.setPlayWhenReady(true) is called, and an implementations only needs to override this method if it can determine a more accurate placeholder state.
    
    Parameters:
    
    suggestedPlaceholderState - The suggested placeholder SimpleBasePlayer.State, including the most likely outcome of handling all pending asynchronous operations.
    
    Returns:
    
    The placeholder SimpleBasePlayer.State to use while asynchronous operations are pending.
  - handleSetPlayWhenReady
```
@ForOverride
protected ListenableFuture<?> handleSetPlayWhenReady(boolean playWhenReady)
```
    Handles calls to set SimpleBasePlayer.State.playWhenReady.
    Will only be called if Player.COMMAND_PLAY_PAUSE is available.
    
    Parameters:
    
    playWhenReady - The requested SimpleBasePlayer.State.playWhenReady
    
    Returns:
    
    A ListenableFuture indicating the completion of all immediate SimpleBasePlayer.State changes caused by this call.
    
    See Also:
    
    Player.setPlayWhenReady(boolean), Player.play(), Player.pause()

Class SimpleBasePlayer

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Player

Field Summary

Fields inherited from class com.google.android.exoplayer2.BasePlayer

Fields inherited from interface com.google.android.exoplayer2.Player

Constructor Summary

Method Summary

Methods inherited from class com.google.android.exoplayer2.BasePlayer

Methods inherited from class java.lang.Object

Constructor Detail

SimpleBasePlayer

SimpleBasePlayer

Method Detail

addListener

removeListener

getApplicationLooper

getAvailableCommands

setPlayWhenReady

getPlayWhenReady

setMediaItems

setMediaItems

addMediaItems

moveMediaItems

removeMediaItems

prepare

getPlaybackState

getPlaybackSuppressionReason

getPlayerError

setRepeatMode

getRepeatMode

setShuffleModeEnabled

getShuffleModeEnabled

isLoading

seekTo

getSeekBackIncrement

getSeekForwardIncrement

getMaxSeekToPreviousPosition

setPlaybackParameters

getPlaybackParameters

stop

stop

release

getCurrentTracks

getTrackSelectionParameters

setTrackSelectionParameters

getMediaMetadata

getPlaylistMetadata

setPlaylistMetadata

getCurrentTimeline

getCurrentPeriodIndex

getCurrentMediaItemIndex

getDuration

getCurrentPosition

getBufferedPosition

getTotalBufferedDuration

isPlayingAd

getCurrentAdGroupIndex

getCurrentAdIndexInAdGroup

getContentPosition

getContentBufferedPosition

getAudioAttributes

setVolume

getVolume

clearVideoSurface

clearVideoSurface

setVideoSurface

setVideoSurfaceHolder

clearVideoSurfaceHolder

setVideoSurfaceView

clearVideoSurfaceView

setVideoTextureView

clearVideoTextureView

getVideoSize

getSurfaceSize

getCurrentCues

getDeviceInfo

getDeviceVolume

isDeviceMuted

setDeviceVolume