com.google.android.exoplayer2

Interface ExoPlayer.EventListener

Enclosing interface:

ExoPlayer

public static interface ExoPlayer.EventListener

Listener of changes in player state.

Method Summary

Modifier and Type	Method and Description
void	onLoadingChanged(boolean isLoading) Called when the player starts or stops loading the source.
void	onPlaybackParametersChanged(PlaybackParameters playbackParameters) Called when the current playback parameters change.
void	onPlayerError(ExoPlaybackException error) Called when an error occurs.
void	onPlayerStateChanged(boolean playWhenReady, int playbackState) Called when the value returned from either ExoPlayer.getPlayWhenReady() or ExoPlayer.getPlaybackState() changes.
void	onPositionDiscontinuity() Called when a position discontinuity occurs without a change to the timeline.
void	onTimelineChanged(Timeline timeline, java.lang.Object manifest) Called when the timeline and/or manifest has been refreshed.
void	onTracksChanged(TrackGroupArray trackGroups, TrackSelectionArray trackSelections) Called when the available or selected tracks change.

Method Detail

onTimelineChanged

void onTimelineChanged(Timeline timeline,
                       java.lang.Object manifest)

Called when the timeline and/or manifest has been refreshed.

Note that if the timeline has changed then a position discontinuity may also have occurred. For example, the current period index may have changed as a result of periods being added or removed from the timeline. This will not be reported via a separate call to onPositionDiscontinuity().

Parameters:

timeline - The latest timeline. Never null, but may be empty.

manifest - The latest manifest. May be null.

onTracksChanged

void onTracksChanged(TrackGroupArray trackGroups,
                     TrackSelectionArray trackSelections)

Called when the available or selected tracks change.

Parameters:

trackGroups - The available tracks. Never null, but may be of length zero.

trackSelections - The track selections for each Renderer. Never null and always of length ExoPlayer.getRendererCount(), but may contain null elements.

onLoadingChanged

void onLoadingChanged(boolean isLoading)

Called when the player starts or stops loading the source.

Parameters:

isLoading - Whether the source is currently being loaded.

onPlayerStateChanged

void onPlayerStateChanged(boolean playWhenReady,
                          int playbackState)

Called when the value returned from either ExoPlayer.getPlayWhenReady() or ExoPlayer.getPlaybackState() changes.

Parameters:

playWhenReady - Whether playback will proceed when ready.

playbackState - One of the STATE constants defined in the ExoPlayer interface.

onPlayerError

void onPlayerError(ExoPlaybackException error)

Called when an error occurs. The playback state will transition to ExoPlayer.STATE_IDLE immediately after this method is called. The player instance can still be used, and ExoPlayer.release() must still be called on the player should it no longer be required.

Parameters:

error - The error.

onPositionDiscontinuity

void onPositionDiscontinuity()

Called when a position discontinuity occurs without a change to the timeline. A position discontinuity occurs when the current window or period index changes (as a result of playback transitioning from one period in the timeline to the next), or when the playback position jumps within the period currently being played (as a result of a seek being performed, or when the source introduces a discontinuity internally).

When a position discontinuity occurs as a result of a change to the timeline this method is not called. onTimelineChanged(Timeline, Object) is called in this case.

onPlaybackParametersChanged

void onPlaybackParametersChanged(PlaybackParameters playbackParameters)

Called when the current playback parameters change. The playback parameters may change due to a call to ExoPlayer.setPlaybackParameters(PlaybackParameters), or the player itself may change them (for example, if audio playback switches to passthrough mode, where speed adjustment is no longer possible).

Parameters:

playbackParameters - The playback parameters.