SimpleExoPlayer (library-core API)

java.lang.Object
- com.google.android.exoplayer2.SimpleExoPlayer

All Implemented Interfaces:

ExoPlayer, Player, Player.TextComponent, Player.VideoComponent
```
public class SimpleExoPlayer
extends java.lang.Object
implements ExoPlayer, Player.VideoComponent, Player.TextComponent
```
An ExoPlayer implementation that uses default Renderer components. Instances can be obtained from ExoPlayerFactory.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface SimpleExoPlayer.VideoListener
Deprecated.
Use VideoListener.
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.ExoPlayer
  ExoPlayer.EventListener, ExoPlayer.ExoPlayerComponent, ExoPlayer.ExoPlayerMessage
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Player
  Player.DefaultEventListener, Player.DiscontinuityReason, Player.RepeatMode, Player.TextComponent, Player.TimelineChangeReason, Player.VideoComponent

Nested Classes
Modifier and Type	Class and Description
`static interface`	`SimpleExoPlayer.VideoListener` Deprecated. Use `VideoListener`.

Field Summary

Fields
Modifier and Type Field and Description

protected Renderer[] renderers
- Fields inherited from interface com.google.android.exoplayer2.ExoPlayer
  REPEAT_MODE_ALL, REPEAT_MODE_OFF, REPEAT_MODE_ONE, STATE_BUFFERING, STATE_ENDED, STATE_IDLE, STATE_READY
- Fields inherited from interface com.google.android.exoplayer2.Player
  DISCONTINUITY_REASON_AD_INSERTION, DISCONTINUITY_REASON_INTERNAL, DISCONTINUITY_REASON_PERIOD_TRANSITION, DISCONTINUITY_REASON_SEEK, DISCONTINUITY_REASON_SEEK_ADJUSTMENT, TIMELINE_CHANGE_REASON_DYNAMIC, TIMELINE_CHANGE_REASON_PREPARED, TIMELINE_CHANGE_REASON_RESET

Fields
Modifier and Type	Field and Description
`protected Renderer[]`	`renderers`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`SimpleExoPlayer(RenderersFactory renderersFactory, TrackSelector trackSelector, LoadControl loadControl)`
`protected`	`SimpleExoPlayer(RenderersFactory renderersFactory, TrackSelector trackSelector, LoadControl loadControl, Clock clock)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addAudioDebugListener(AudioRendererEventListener listener)` Adds a listener to receive debug events from the audio renderer.
`void`	`addListener(Player.EventListener listener)` Register a listener to receive events from the player.
`void`	`addMetadataOutput(MetadataOutput listener)`
`void`	`addTextOutput(TextOutput listener)` Registers an output to receive text events.
`void`	`addVideoDebugListener(VideoRendererEventListener listener)` Adds a listener to receive debug events from the video renderer.
`void`	`addVideoListener(VideoListener listener)` Adds a listener to receive video events.
`void`	`blockingSendMessages(ExoPlayer.ExoPlayerMessage... messages)`
`void`	`clearMetadataOutput(MetadataOutput output)` Deprecated. Use `removeMetadataOutput(MetadataOutput)`.
`void`	`clearTextOutput(TextOutput output)` Deprecated. Use `removeTextOutput(TextOutput)`.
`void`	`clearVideoListener(SimpleExoPlayer.VideoListener listener)` Deprecated. Use `removeVideoListener(com.google.android.exoplayer2.video.VideoListener)`.
`void`	`clearVideoSurface()` Clears any `Surface`, `SurfaceHolder`, `SurfaceView` or `TextureView` currently set on the player.
`void`	`clearVideoSurface(android.view.Surface surface)` Clears the `Surface` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoSurfaceHolder(android.view.SurfaceHolder surfaceHolder)` Clears the `SurfaceHolder` that holds the `Surface` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoSurfaceView(android.view.SurfaceView surfaceView)` Clears the `SurfaceView` onto which video is being rendered if it matches the one passed.
`void`	`clearVideoTextureView(android.view.TextureView textureView)` Clears the `TextureView` onto which video is being rendered if it matches the one passed.
`protected ExoPlayer`	`createExoPlayerImpl(Renderer[] renderers, TrackSelector trackSelector, LoadControl loadControl, Clock clock)` Creates the `ExoPlayer` implementation used by this instance.
`PlayerMessage`	`createMessage(PlayerMessage.Target target)` Creates a message that can be sent to a `PlayerMessage.Target`.
`AudioAttributes`	`getAudioAttributes()` Returns the attributes for audio playback.
`DecoderCounters`	`getAudioDecoderCounters()` Returns `DecoderCounters` for audio, or null if no audio is being played.
`Format`	`getAudioFormat()` Returns the audio format currently being played, or null if no audio is being played.
`int`	`getAudioSessionId()` Returns the audio session identifier, or `C.AUDIO_SESSION_ID_UNSET` if not set.
`int`	`getAudioStreamType()` Deprecated. Use `getAudioAttributes()`.
`int`	`getBufferedPercentage()` Returns an estimate of the percentage in the current window up to which data is buffered, or 0 if no estimate is available.
`long`	`getBufferedPosition()` Returns an estimate of the position in the current window 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.
`java.lang.Object`	`getCurrentManifest()` Returns the current manifest.
`int`	`getCurrentPeriodIndex()` Returns the index of the period currently being played.
`long`	`getCurrentPosition()` Returns the playback position in the current window, in milliseconds.
`Timeline`	`getCurrentTimeline()` Returns the current `Timeline`.
`TrackGroupArray`	`getCurrentTrackGroups()` Returns the available track groups.
`TrackSelectionArray`	`getCurrentTrackSelections()` Returns the current track selections for each renderer.
`int`	`getCurrentWindowIndex()` Returns the index of the window currently being played.
`long`	`getDuration()` Returns the duration of the current window in milliseconds, or `C.TIME_UNSET` if the duration is not known.
`int`	`getNextWindowIndex()` Returns the index of the next timeline window to be played, which may depend on the current repeat mode and whether shuffle mode is enabled.
`android.os.Looper`	`getPlaybackLooper()` Gets the `Looper` associated with the playback thread.
`PlaybackParameters`	`getPlaybackParameters()` Returns the currently active playback parameters.
`int`	`getPlaybackState()` Returns the current state of the player.
`boolean`	`getPlayWhenReady()` Whether playback will proceed when `Player.getPlaybackState()` == `Player.STATE_READY`.
`int`	`getPreviousWindowIndex()` Returns the index of the previous timeline window to be played, which may depend on the current repeat mode and whether shuffle mode is enabled.
`int`	`getRendererCount()` Returns the number of renderers.
`int`	`getRendererType(int index)` Returns the track type that the renderer at a given index handles.
`int`	`getRepeatMode()` Returns the current `Player.RepeatMode` used for playback.
`boolean`	`getShuffleModeEnabled()` Returns whether shuffling of windows is enabled.
`Player.TextComponent`	`getTextComponent()` Returns the component of this player for text output, or null if text is not supported.
`Player.VideoComponent`	`getVideoComponent()` Returns the component of this player for video output, or null if video is not supported.
`DecoderCounters`	`getVideoDecoderCounters()` Returns `DecoderCounters` for video, or null if no video is being played.
`Format`	`getVideoFormat()` Returns the video format currently being played, or null if no video is being played.
`int`	`getVideoScalingMode()` Returns the video scaling mode.
`float`	`getVolume()` Returns the audio volume, with 0 being silence and 1 being unity gain.
`boolean`	`isCurrentWindowDynamic()` Returns whether the current window is dynamic, or `false` if the `Timeline` is empty.
`boolean`	`isCurrentWindowSeekable()` Returns whether the current window is seekable, or `false` if the `Timeline` is empty.
`boolean`	`isLoading()` Whether the player is currently loading the source.
`boolean`	`isPlayingAd()` Returns whether the player is currently playing an ad.
`void`	`prepare(MediaSource mediaSource)` Prepares the player to play the provided `MediaSource`.
`void`	`prepare(MediaSource mediaSource, boolean resetPosition, boolean resetState)` Prepares the player to play the provided `MediaSource`, optionally resetting the playback position the default position in the first `Timeline.Window`.
`void`	`release()` Releases the player.
`void`	`removeAudioDebugListener(AudioRendererEventListener listener)` Removes a listener to receive debug events from the audio renderer.
`void`	`removeListener(Player.EventListener listener)` Unregister a listener.
`void`	`removeMetadataOutput(MetadataOutput listener)`
`void`	`removeTextOutput(TextOutput listener)` Removes a text output.
`void`	`removeVideoDebugListener(VideoRendererEventListener listener)` Removes a listener to receive debug events from the video renderer.
`void`	`removeVideoListener(VideoListener listener)` Removes a listener of video events.
`void`	`seekTo(int windowIndex, long positionMs)` Seeks to a position specified in milliseconds in the specified window.
`void`	`seekTo(long positionMs)` Seeks to a position specified in milliseconds in the current window.
`void`	`seekToDefaultPosition()` Seeks to the default position associated with the current window.
`void`	`seekToDefaultPosition(int windowIndex)` Seeks to the default position associated with the specified window.
`void`	`sendMessages(ExoPlayer.ExoPlayerMessage... messages)`
`void`	`setAudioAttributes(AudioAttributes audioAttributes)` Sets the attributes for audio playback, used by the underlying audio track.
`void`	`setAudioDebugListener(AudioRendererEventListener listener)` Deprecated. Use `addAudioDebugListener(AudioRendererEventListener)`.
`void`	`setAudioStreamType(int streamType)` Deprecated. Use `setAudioAttributes(AudioAttributes)`.
`void`	`setMetadataOutput(MetadataOutput output)` Deprecated. Use `addMetadataOutput(MetadataOutput)`.
`void`	`setPlaybackParameters(PlaybackParameters playbackParameters)` Attempts to set the playback parameters.
`void`	`setPlaybackParams(android.media.PlaybackParams params)` Deprecated. Use `setPlaybackParameters(PlaybackParameters)`.
`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`	`setSeekParameters(SeekParameters seekParameters)` Sets the parameters that control how seek operations are performed.
`void`	`setShuffleModeEnabled(boolean shuffleModeEnabled)` Sets whether shuffling of windows is enabled.
`void`	`setTextOutput(TextOutput output)` Deprecated. Use `addTextOutput(TextOutput)`.
`void`	`setVideoDebugListener(VideoRendererEventListener listener)` Deprecated. Use `addVideoDebugListener(VideoRendererEventListener)`.
`void`	`setVideoListener(SimpleExoPlayer.VideoListener listener)` Deprecated. Use `addVideoListener(com.google.android.exoplayer2.video.VideoListener)`.
`void`	`setVideoScalingMode(int videoScalingMode)` Sets the video scaling mode.
`void`	`setVideoSurface(android.view.Surface surface)` Sets the `Surface` onto which video will be rendered.
`void`	`setVideoSurfaceHolder(android.view.SurfaceHolder surfaceHolder)` Sets the `SurfaceHolder` that holds the `Surface` onto which video will be rendered.
`void`	`setVideoSurfaceView(android.view.SurfaceView surfaceView)` Sets the `SurfaceView` onto which video will be rendered.
`void`	`setVideoTextureView(android.view.TextureView textureView)` Sets the `TextureView` onto which video will be rendered.
`void`	`setVolume(float audioVolume)` Sets the audio volume, with 0 being silence and 1 being unity gain.
`void`	`stop()` Stops playback without resetting the player.
`void`	`stop(boolean reset)` Stops playback and optionally resets the player.

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

- Field Detail
  - renderers
```
protected final Renderer[] renderers
```
- Constructor Detail
  - SimpleExoPlayer
```
protected SimpleExoPlayer(RenderersFactory renderersFactory,
                          TrackSelector trackSelector,
                          LoadControl loadControl)
```
    Parameters:
    
    renderersFactory - A factory for creating Renderers to be used by the instance.
    
    trackSelector - The TrackSelector that will be used by the instance.
    
    loadControl - The LoadControl that will be used by the instance.
  - SimpleExoPlayer
```
protected SimpleExoPlayer(RenderersFactory renderersFactory,
                          TrackSelector trackSelector,
                          LoadControl loadControl,
                          Clock clock)
```
    Parameters:
    
    renderersFactory - A factory for creating Renderers to be used by the instance.
    
    trackSelector - The TrackSelector that will be used by the instance.
    
    loadControl - The LoadControl that will be used by the instance.
    
    clock - The Clock that will be used by the instance. Should always be Clock.DEFAULT, unless the player is being used from a test.
- Method Detail
  - getVideoComponent
```
public Player.VideoComponent getVideoComponent()
```
    Description copied from interface: Player
    
    Returns the component of this player for video output, or null if video is not supported.
    
    Specified by:
    
    getVideoComponent in interface Player
  - getTextComponent
```
public Player.TextComponent getTextComponent()
```
    Description copied from interface: Player
    
    Returns the component of this player for text output, or null if text is not supported.
    
    Specified by:
    
    getTextComponent in interface Player
  - setVideoScalingMode
```
public void setVideoScalingMode(int videoScalingMode)
```
    Sets the video scaling mode.
    Note that the scaling mode only applies if a MediaCodec-based video Renderer is enabled and if the output surface is owned by a SurfaceView.
    
    Specified by:
    
    setVideoScalingMode in interface Player.VideoComponent
    
    Parameters:
    
    videoScalingMode - The video scaling mode.
  - getVideoScalingMode
```
public int getVideoScalingMode()
```
    Description copied from interface: Player.VideoComponent
    
    Returns the video scaling mode.
    
    Specified by:
    
    getVideoScalingMode in interface Player.VideoComponent
  - clearVideoSurface
```
public void clearVideoSurface()
```
    Description copied from interface: Player.VideoComponent
    
    Clears any Surface, SurfaceHolder, SurfaceView or TextureView currently set on the player.
    
    Specified by:
    
    clearVideoSurface in interface Player.VideoComponent
  - setVideoSurface
```
public void setVideoSurface(android.view.Surface surface)
```
    Description copied from interface: Player.VideoComponent
    
    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.VideoComponent.setVideoSurfaceView(SurfaceView), Player.VideoComponent.setVideoTextureView(TextureView) or Player.VideoComponent.setVideoSurfaceHolder(SurfaceHolder) rather than this method, since passing the holder allows the player to track the lifecycle of the surface automatically.
    
    Specified by:
    
    setVideoSurface in interface Player.VideoComponent
    
    Parameters:
    
    surface - The Surface.
  - clearVideoSurface
```
public void clearVideoSurface(android.view.Surface surface)
```
    Description copied from interface: Player.VideoComponent
    
    Clears the Surface onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Specified by:
    
    clearVideoSurface in interface Player.VideoComponent
    
    Parameters:
    
    surface - The surface to clear.
  - setVideoSurfaceHolder
```
public void setVideoSurfaceHolder(android.view.SurfaceHolder surfaceHolder)
```
    Description copied from interface: Player.VideoComponent
    
    Sets the SurfaceHolder that holds the Surface onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    
    Specified by:
    
    setVideoSurfaceHolder in interface Player.VideoComponent
    
    Parameters:
    
    surfaceHolder - The surface holder.
  - clearVideoSurfaceHolder
```
public void clearVideoSurfaceHolder(android.view.SurfaceHolder surfaceHolder)
```
    Description copied from interface: Player.VideoComponent
    
    Clears the SurfaceHolder that holds the Surface onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Specified by:
    
    clearVideoSurfaceHolder in interface Player.VideoComponent
    
    Parameters:
    
    surfaceHolder - The surface holder to clear.
  - setVideoSurfaceView
```
public void setVideoSurfaceView(android.view.SurfaceView surfaceView)
```
    Description copied from interface: Player.VideoComponent
    
    Sets the SurfaceView onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    
    Specified by:
    
    setVideoSurfaceView in interface Player.VideoComponent
    
    Parameters:
    
    surfaceView - The surface view.
  - clearVideoSurfaceView
```
public void clearVideoSurfaceView(android.view.SurfaceView surfaceView)
```
    Description copied from interface: Player.VideoComponent
    
    Clears the SurfaceView onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Specified by:
    
    clearVideoSurfaceView in interface Player.VideoComponent
    
    Parameters:
    
    surfaceView - The texture view to clear.
  - setVideoTextureView
```
public void setVideoTextureView(android.view.TextureView textureView)
```
    Description copied from interface: Player.VideoComponent
    
    Sets the TextureView onto which video will be rendered. The player will track the lifecycle of the surface automatically.
    
    Specified by:
    
    setVideoTextureView in interface Player.VideoComponent
    
    Parameters:
    
    textureView - The texture view.
  - clearVideoTextureView
```
public void clearVideoTextureView(android.view.TextureView textureView)
```
    Description copied from interface: Player.VideoComponent
    
    Clears the TextureView onto which video is being rendered if it matches the one passed. Else does nothing.
    
    Specified by:
    
    clearVideoTextureView in interface Player.VideoComponent
    
    Parameters:
    
    textureView - The texture view to clear.
  - setAudioStreamType
```
@Deprecated
public void setAudioStreamType(int streamType)
```
    Deprecated. Use setAudioAttributes(AudioAttributes).
    
    Sets the stream type for audio playback, used by the underlying audio track.
    Setting the stream type during playback may introduce a short gap in audio output as the audio track is recreated. A new audio session id will also be generated.
    Calling this method overwrites any attributes set previously by calling setAudioAttributes(AudioAttributes).
    
    Parameters:
    
    streamType - The stream type for audio playback.
  - getAudioStreamType
```
@Deprecated
public int getAudioStreamType()
```
    Deprecated. Use getAudioAttributes().
    
    Returns the stream type for audio playback.
  - setAudioAttributes
```
public void setAudioAttributes(AudioAttributes audioAttributes)
```
    Sets the attributes for audio playback, used by the underlying audio track. If not set, the default audio attributes will be used. They are suitable for general media playback.
    Setting the audio attributes during playback may introduce a short gap in audio output as the audio track is recreated. A new audio session id will also be generated.
    If tunneling is enabled by the track selector, the specified audio attributes will be ignored, but they will take effect if audio is later played without tunneling.
    If the device is running a build before platform API version 21, audio attributes cannot be set directly on the underlying audio track. In this case, the usage will be mapped onto an equivalent stream type using Util.getStreamTypeForAudioUsage(int).
    
    Parameters:
    
    audioAttributes - The attributes to use for audio playback.
  - getAudioAttributes
```
public AudioAttributes getAudioAttributes()
```
    Returns the attributes for audio playback.
  - setVolume
```
public void setVolume(float audioVolume)
```
    Sets the audio volume, with 0 being silence and 1 being unity gain.
    
    Parameters:
    
    audioVolume - The audio volume.
  - getVolume
```
public float getVolume()
```
    Returns the audio volume, with 0 being silence and 1 being unity gain.
  - setPlaybackParams
```
@Deprecated
public void setPlaybackParams(@Nullable
                                          android.media.PlaybackParams params)
```
    Deprecated. Use setPlaybackParameters(PlaybackParameters).
    
    Sets the PlaybackParams governing audio playback.
    
    Parameters:
    
    params - The PlaybackParams, or null to clear any previously set parameters.
  - getVideoFormat
```
public Format getVideoFormat()
```
    Returns the video format currently being played, or null if no video is being played.
  - getAudioFormat
```
public Format getAudioFormat()
```
    Returns the audio format currently being played, or null if no audio is being played.
  - getAudioSessionId
```
public int getAudioSessionId()
```
    Returns the audio session identifier, or C.AUDIO_SESSION_ID_UNSET if not set.
  - getVideoDecoderCounters
```
public DecoderCounters getVideoDecoderCounters()
```
    Returns DecoderCounters for video, or null if no video is being played.
  - getAudioDecoderCounters
```
public DecoderCounters getAudioDecoderCounters()
```
    Returns DecoderCounters for audio, or null if no audio is being played.
  - addVideoListener
```
public void addVideoListener(VideoListener listener)
```
    Description copied from interface: Player.VideoComponent
    
    Adds a listener to receive video events.
    
    Specified by:
    
    addVideoListener in interface Player.VideoComponent
    
    Parameters:
    
    listener - The listener to register.
  - removeVideoListener
```
public void removeVideoListener(VideoListener listener)
```
    Description copied from interface: Player.VideoComponent
    
    Removes a listener of video events.
    
    Specified by:
    
    removeVideoListener in interface Player.VideoComponent
    
    Parameters:
    
    listener - The listener to unregister.
  - setVideoListener
```
@Deprecated
public void setVideoListener(SimpleExoPlayer.VideoListener listener)
```
    Deprecated. Use addVideoListener(com.google.android.exoplayer2.video.VideoListener).
    
    Sets a listener to receive video events, removing all existing listeners.
    
    Parameters:
    
    listener - The listener.
  - clearVideoListener
```
@Deprecated
public void clearVideoListener(SimpleExoPlayer.VideoListener listener)
```
    Deprecated. Use removeVideoListener(com.google.android.exoplayer2.video.VideoListener).
    
    Equivalent to removeVideoListener(com.google.android.exoplayer2.video.VideoListener).
    
    Parameters:
    
    listener - The listener to clear.
  - addTextOutput
```
public void addTextOutput(TextOutput listener)
```
    Description copied from interface: Player.TextComponent
    
    Registers an output to receive text events.
    
    Specified by:
    
    addTextOutput in interface Player.TextComponent
    
    Parameters:
    
    listener - The output to register.
  - removeTextOutput
```
public void removeTextOutput(TextOutput listener)
```
    Description copied from interface: Player.TextComponent
    
    Removes a text output.
    
    Specified by:
    
    removeTextOutput in interface Player.TextComponent
    
    Parameters:
    
    listener - The output to remove.
  - setTextOutput
```
@Deprecated
public void setTextOutput(TextOutput output)
```
    Deprecated. Use addTextOutput(TextOutput).
    
    Sets an output to receive text events, removing all existing outputs.
    
    Parameters:
    
    output - The output.
  - clearTextOutput
```
@Deprecated
public void clearTextOutput(TextOutput output)
```
    Deprecated. Use removeTextOutput(TextOutput).
    
    Equivalent to removeTextOutput(TextOutput).
    
    Parameters:
    
    output - The output to clear.
  - addMetadataOutput
```
public void addMetadataOutput(MetadataOutput listener)
```
  - removeMetadataOutput
```
public void removeMetadataOutput(MetadataOutput listener)
```
  - setMetadataOutput
```
@Deprecated
public void setMetadataOutput(MetadataOutput output)
```
    Deprecated. Use addMetadataOutput(MetadataOutput).
    
    Sets an output to receive metadata events, removing all existing outputs.
    
    Parameters:
    
    output - The output.
  - clearMetadataOutput
```
@Deprecated
public void clearMetadataOutput(MetadataOutput output)
```
    Deprecated. Use removeMetadataOutput(MetadataOutput).
    
    Equivalent to removeMetadataOutput(MetadataOutput).
    
    Parameters:
    
    output - The output to clear.
  - setVideoDebugListener
```
@Deprecated
public void setVideoDebugListener(VideoRendererEventListener listener)
```
    Deprecated. Use addVideoDebugListener(VideoRendererEventListener).
    
    Sets a listener to receive debug events from the video renderer.
    
    Parameters:
    
    listener - The listener.
  - addVideoDebugListener
```
public void addVideoDebugListener(VideoRendererEventListener listener)
```
    Adds a listener to receive debug events from the video renderer.
    
    Parameters:
    
    listener - The listener.
  - removeVideoDebugListener
```
public void removeVideoDebugListener(VideoRendererEventListener listener)
```
    Removes a listener to receive debug events from the video renderer.
    
    Parameters:
    
    listener - The listener.
  - setAudioDebugListener
```
@Deprecated
public void setAudioDebugListener(AudioRendererEventListener listener)
```
    Deprecated. Use addAudioDebugListener(AudioRendererEventListener).
    
    Sets a listener to receive debug events from the audio renderer.
    
    Parameters:
    
    listener - The listener.
  - addAudioDebugListener
```
public void addAudioDebugListener(AudioRendererEventListener listener)
```
    Adds a listener to receive debug events from the audio renderer.
    
    Parameters:
    
    listener - The listener.
  - removeAudioDebugListener
```
public void removeAudioDebugListener(AudioRendererEventListener listener)
```
    Removes a listener to receive debug events from the audio renderer.
    
    Parameters:
    
    listener - The listener.
  - getPlaybackLooper
```
public android.os.Looper getPlaybackLooper()
```
    Description copied from interface: ExoPlayer
    
    Gets the Looper associated with the playback thread.
    
    Specified by:
    
    getPlaybackLooper in interface ExoPlayer
    
    Returns:
    
    The Looper associated with the playback thread.
  - addListener
```
public void addListener(Player.EventListener listener)
```
    Description copied from interface: Player
    
    Register a listener to receive events from the player. The listener's methods will be called on the thread that was used to construct the player. However, if the thread used to construct the player does not have a Looper, then the listener will be called on the main thread.
    
    Specified by:
    
    addListener in interface Player
    
    Parameters:
    
    listener - The listener to register.
  - removeListener
```
public void removeListener(Player.EventListener listener)
```
    Description copied from interface: Player
    
    Unregister a listener. The listener will no longer receive events from the player.
    
    Specified by:
    
    removeListener in interface Player
    
    Parameters:
    
    listener - The listener to unregister.
  - getPlaybackState
```
public int getPlaybackState()
```
    Description copied from interface: Player
    
    Returns the current state of the player.
    
    Specified by:
    
    getPlaybackState in interface Player
    
    Returns:
    
    One of the STATE constants defined in this interface.
  - prepare
```
public void prepare(MediaSource mediaSource)
```
    Description copied from interface: ExoPlayer
    
    Prepares the player to play the provided MediaSource. Equivalent to prepare(mediaSource, true, true).
    Note: MediaSource instances are not designed to be re-used. If you want to prepare a player more than once with the same piece of media, use a new instance each time.
    
    Specified by:
    
    prepare in interface ExoPlayer
  - prepare
```
public void prepare(MediaSource mediaSource,
                    boolean resetPosition,
                    boolean resetState)
```
    Description copied from interface: ExoPlayer
    
    Prepares the player to play the provided MediaSource, optionally resetting the playback position the default position in the first Timeline.Window.
    Note: MediaSource instances are not designed to be re-used. If you want to prepare a player more than once with the same piece of media, use a new instance each time.
    
    Specified by:
    
    prepare in interface ExoPlayer
    
    Parameters:
    
    mediaSource - The MediaSource to play.
    
    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.getCurrentWindowIndex() and Player.getCurrentPosition().
    
    resetState - Whether the timeline, manifest, tracks and track selections should be reset. Should be true unless the player is being prepared to play the same media as it was playing previously (e.g. if playback failed and is being retried).
  - setPlayWhenReady
```
public 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 can be used to pause and resume playback.
    
    Specified by:
    
    setPlayWhenReady in interface Player
    
    Parameters:
    
    playWhenReady - Whether playback should proceed when ready.
  - getPlayWhenReady
```
public boolean getPlayWhenReady()
```
    Description copied from interface: Player
    
    Whether playback will proceed when Player.getPlaybackState() == Player.STATE_READY.
    
    Specified by:
    
    getPlayWhenReady in interface Player
    
    Returns:
    
    Whether playback will proceed when ready.
  - getRepeatMode
```
public int getRepeatMode()
```
    Description copied from interface: Player
    
    Returns the current Player.RepeatMode used for playback.
    
    Specified by:
    
    getRepeatMode in interface Player
    
    Returns:
    
    The current repeat mode.
  - setRepeatMode
```
public void setRepeatMode(int repeatMode)
```
    Description copied from interface: Player
    
    Sets the Player.RepeatMode to be used for playback.
    
    Specified by:
    
    setRepeatMode in interface Player
    
    Parameters:
    
    repeatMode - A repeat mode.
  - setShuffleModeEnabled
```
public void setShuffleModeEnabled(boolean shuffleModeEnabled)
```
    Description copied from interface: Player
    
    Sets whether shuffling of windows is enabled.
    
    Specified by:
    
    setShuffleModeEnabled in interface Player
    
    Parameters:
    
    shuffleModeEnabled - Whether shuffling is enabled.
  - getShuffleModeEnabled
```
public boolean getShuffleModeEnabled()
```
    Description copied from interface: Player
    
    Returns whether shuffling of windows is enabled.
    
    Specified by:
    
    getShuffleModeEnabled in interface Player
  - isLoading
```
public boolean isLoading()
```
    Description copied from interface: Player
    
    Whether the player is currently loading the source.
    
    Specified by:
    
    isLoading in interface Player
    
    Returns:
    
    Whether the player is currently loading the source.
  - seekToDefaultPosition
```
public void seekToDefaultPosition()
```
    Description copied from interface: Player
    
    Seeks to the default position associated with the current window. The position can depend on the type of media being played. For live streams it will typically be the live edge of the window. For other streams it will typically be the start of the window.
    
    Specified by:
    
    seekToDefaultPosition in interface Player
  - seekToDefaultPosition
```
public void seekToDefaultPosition(int windowIndex)
```
    Description copied from interface: Player
    
    Seeks to the default position associated with the specified window. The position can depend on the type of media being played. For live streams it will typically be the live edge of the window. For other streams it will typically be the start of the window.
    
    Specified by:
    
    seekToDefaultPosition in interface Player
    
    Parameters:
    
    windowIndex - The index of the window whose associated default position should be seeked to.
  - seekTo
```
public void seekTo(long positionMs)
```
    Description copied from interface: Player
    
    Seeks to a position specified in milliseconds in the current window.
    
    Specified by:
    
    seekTo in interface Player
    
    Parameters:
    
    positionMs - The seek position in the current window, or C.TIME_UNSET to seek to the window's default position.
  - seekTo
```
public void seekTo(int windowIndex,
                   long positionMs)
```
    Description copied from interface: Player
    
    Seeks to a position specified in milliseconds in the specified window.
    
    Specified by:
    
    seekTo in interface Player
    
    Parameters:
    
    windowIndex - The index of the window.
    
    positionMs - The seek position in the specified window, or C.TIME_UNSET to seek to the window's default position.
  - setPlaybackParameters
```
public void setPlaybackParameters(@Nullable
                                  PlaybackParameters playbackParameters)
```
    Description copied from interface: Player
    
    Attempts to set the playback parameters. Passing null sets the parameters to the default, PlaybackParameters.DEFAULT, which means there is no speed or pitch adjustment.
    Playback parameters changes may cause the player to buffer. Player.EventListener.onPlaybackParametersChanged(PlaybackParameters) will be called whenever the currently active playback parameters change. When that listener is called, the parameters passed to it may not match playbackParameters. For example, the chosen speed or pitch may be out of range, in which case they are constrained to a set of permitted values. If it is not possible to change the playback parameters, the listener will not be invoked.
    
    Specified by:
    
    setPlaybackParameters in interface Player
    
    Parameters:
    
    playbackParameters - The playback parameters, or null to use the defaults.
  - getPlaybackParameters
```
public PlaybackParameters getPlaybackParameters()
```
    Description copied from interface: Player
    
    Returns the currently active playback parameters.
    
    Specified by:
    
    getPlaybackParameters in interface Player
    
    See Also:
    
    Player.EventListener.onPlaybackParametersChanged(PlaybackParameters)
  - setSeekParameters
```
public void setSeekParameters(@Nullable
                              SeekParameters seekParameters)
```
    Description copied from interface: ExoPlayer
    
    Sets the parameters that control how seek operations are performed.
    
    Specified by:
    
    setSeekParameters in interface ExoPlayer
    
    Parameters:
    
    seekParameters - The seek parameters, or null to use the defaults.
  - stop
```
public void stop()
```
    Description copied from interface: Player
    
    Stops playback without resetting the player. Use setPlayWhenReady(false) 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. The player instance can still be used, and Player.release() must still be called on the player if it's no longer required.
    Calling this method does not reset the playback position.
    
    Specified by:
    
    stop in interface Player
  - stop
```
public void stop(boolean reset)
```
    Description copied from interface: Player
    
    Stops playback and optionally resets the player. Use setPlayWhenReady(false) 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. The player instance can still be used, and Player.release() must still be called on the player if it's no longer required.
    
    Specified by:
    
    stop in interface Player
    
    Parameters:
    
    reset - Whether the player should be reset.
  - release
```
public 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.
    
    Specified by:
    
    release in interface Player
  - sendMessages
```
public void sendMessages(ExoPlayer.ExoPlayerMessage... messages)
```
    Specified by:
    
    sendMessages in interface ExoPlayer
  - createMessage
```
public PlayerMessage createMessage(PlayerMessage.Target target)
```
    Description copied from interface: ExoPlayer
    
    Creates a message that can be sent to a PlayerMessage.Target. By default, the message will be delivered immediately without blocking on the playback thread. The default PlayerMessage.getType() is 0 and the default PlayerMessage.getPayload() is null. If a position is specified with PlayerMessage.setPosition(long), the message will be delivered at this position in the current window defined by Player.getCurrentWindowIndex(). Alternatively, the message can be sent at a specific window using PlayerMessage.setPosition(int, long).
    
    Specified by:
    
    createMessage in interface ExoPlayer
  - blockingSendMessages
```
public void blockingSendMessages(ExoPlayer.ExoPlayerMessage... messages)
```
    Specified by:
    
    blockingSendMessages in interface ExoPlayer
  - getRendererCount
```
public int getRendererCount()
```
    Description copied from interface: Player
    
    Returns the number of renderers.
    
    Specified by:
    
    getRendererCount in interface Player
  - getRendererType
```
public int getRendererType(int index)
```
    Description copied from interface: Player
    
    Returns the track type that the renderer at a given index handles.
    
    Specified by:
    
    getRendererType in interface Player
    
    Parameters:
    
    index - The index of the renderer.
    
    Returns:
    
    One of the TRACK_TYPE_* constants defined in C.
    
    See Also:
    
    Renderer.getTrackType()
  - getCurrentTrackGroups
```
public TrackGroupArray getCurrentTrackGroups()
```
    Description copied from interface: Player
    
    Returns the available track groups.
    
    Specified by:
    
    getCurrentTrackGroups in interface Player
  - getCurrentTrackSelections
```
public TrackSelectionArray getCurrentTrackSelections()
```
    Description copied from interface: Player
    
    Returns the current track selections for each renderer.
    
    Specified by:
    
    getCurrentTrackSelections in interface Player
  - getCurrentTimeline
```
public Timeline getCurrentTimeline()
```
    Description copied from interface: Player
    
    Returns the current Timeline. Never null, but may be empty.
    
    Specified by:
    
    getCurrentTimeline in interface Player
  - getCurrentManifest
```
public java.lang.Object getCurrentManifest()
```
    Description copied from interface: Player
    
    Returns the current manifest. The type depends on the type of media being played. May be null.
    
    Specified by:
    
    getCurrentManifest in interface Player
  - getCurrentPeriodIndex
```
public int getCurrentPeriodIndex()
```
    Description copied from interface: Player
    
    Returns the index of the period currently being played.
    
    Specified by:
    
    getCurrentPeriodIndex in interface Player
  - getCurrentWindowIndex
```
public int getCurrentWindowIndex()
```
    Description copied from interface: Player
    
    Returns the index of the window currently being played.
    
    Specified by:
    
    getCurrentWindowIndex in interface Player
  - getNextWindowIndex
```
public int getNextWindowIndex()
```
    Description copied from interface: Player
    
    Returns the index of the next timeline window to be played, which may depend on the current repeat mode and whether shuffle mode is enabled. Returns C.INDEX_UNSET if the window currently being played is the last window.
    
    Specified by:
    
    getNextWindowIndex in interface Player
  - getPreviousWindowIndex
```
public int getPreviousWindowIndex()
```
    Description copied from interface: Player
    
    Returns the index of the previous timeline window to be played, which may depend on the current repeat mode and whether shuffle mode is enabled. Returns C.INDEX_UNSET if the window currently being played is the first window.
    
    Specified by:
    
    getPreviousWindowIndex in interface Player
  - getDuration
```
public long getDuration()
```
    Description copied from interface: Player
    
    Returns the duration of the current window in milliseconds, or C.TIME_UNSET if the duration is not known.
    
    Specified by:
    
    getDuration in interface Player
  - getCurrentPosition
```
public long getCurrentPosition()
```
    Description copied from interface: Player
    
    Returns the playback position in the current window, in milliseconds.
    
    Specified by:
    
    getCurrentPosition in interface Player
  - getBufferedPosition
```
public long getBufferedPosition()
```
    Description copied from interface: Player
    
    Returns an estimate of the position in the current window up to which data is buffered, in milliseconds.
    
    Specified by:
    
    getBufferedPosition in interface Player
  - getBufferedPercentage
```
public int getBufferedPercentage()
```
    Description copied from interface: Player
    
    Returns an estimate of the percentage in the current window up to which data is buffered, or 0 if no estimate is available.
    
    Specified by:
    
    getBufferedPercentage in interface Player
  - isCurrentWindowDynamic
```
public boolean isCurrentWindowDynamic()
```
    Description copied from interface: Player
    
    Returns whether the current window is dynamic, or false if the Timeline is empty.
    
    Specified by:
    
    isCurrentWindowDynamic in interface Player
    
    See Also:
    
    Timeline.Window.isDynamic
  - isCurrentWindowSeekable
```
public boolean isCurrentWindowSeekable()
```
    Description copied from interface: Player
    
    Returns whether the current window is seekable, or false if the Timeline is empty.
    
    Specified by:
    
    isCurrentWindowSeekable in interface Player
    
    See Also:
    
    Timeline.Window.isSeekable
  - isPlayingAd
```
public boolean isPlayingAd()
```
    Description copied from interface: Player
    
    Returns whether the player is currently playing an ad.
    
    Specified by:
    
    isPlayingAd in interface Player
  - getCurrentAdGroupIndex
```
public 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.
    
    Specified by:
    
    getCurrentAdGroupIndex in interface Player
  - getCurrentAdIndexInAdGroup
```
public 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.
    
    Specified by:
    
    getCurrentAdIndexInAdGroup in interface Player
  - getContentPosition
```
public 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().
    
    Specified by:
    
    getContentPosition in interface Player
  - createExoPlayerImpl
```
protected ExoPlayer createExoPlayerImpl(Renderer[] renderers,
                                        TrackSelector trackSelector,
                                        LoadControl loadControl,
                                        Clock clock)
```
    Creates the ExoPlayer implementation used by this instance.
    
    Parameters:
    
    renderers - The Renderers that will be used by the instance.
    
    trackSelector - The TrackSelector that will be used by the instance.
    
    loadControl - The LoadControl that will be used by the instance.
    
    clock - The Clock that will be used by this instance.
    
    Returns:
    
    A new ExoPlayer instance.

Class SimpleExoPlayer

Nested Class Summary

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

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

Field Summary

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

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

renderers

Constructor Detail

SimpleExoPlayer

SimpleExoPlayer

Method Detail

getVideoComponent

getTextComponent

setVideoScalingMode

getVideoScalingMode

clearVideoSurface

setVideoSurface

clearVideoSurface

setVideoSurfaceHolder

clearVideoSurfaceHolder

setVideoSurfaceView

clearVideoSurfaceView

setVideoTextureView

clearVideoTextureView

setAudioStreamType

getAudioStreamType

setAudioAttributes

getAudioAttributes

setVolume

getVolume

setPlaybackParams

getVideoFormat

getAudioFormat

getAudioSessionId

getVideoDecoderCounters

getAudioDecoderCounters

addVideoListener

removeVideoListener

setVideoListener

clearVideoListener

addTextOutput

removeTextOutput

setTextOutput

clearTextOutput

addMetadataOutput

removeMetadataOutput

setMetadataOutput

clearMetadataOutput

setVideoDebugListener

addVideoDebugListener

removeVideoDebugListener

setAudioDebugListener

addAudioDebugListener

removeAudioDebugListener

getPlaybackLooper

addListener

removeListener

getPlaybackState

prepare

prepare

setPlayWhenReady

getPlayWhenReady

getRepeatMode

setRepeatMode

setShuffleModeEnabled

getShuffleModeEnabled

isLoading

seekToDefaultPosition

seekToDefaultPosition

seekTo

seekTo

setPlaybackParameters

getPlaybackParameters

setSeekParameters

stop