com.google.android.exoplayer2

Interface Player.EventListener

All Known Subinterfaces:

ExoPlayer.EventListener

All Known Implementing Classes:

AnalyticsCollector, Player.DefaultEventListener

Enclosing interface:

Player

public static interface Player.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 Player.getPlayWhenReady() or Player.getPlaybackState() changes.
void	onPositionDiscontinuity(int reason) Called when a position discontinuity occurs without a change to the timeline.
void	onRepeatModeChanged(int repeatMode) Called when the value of Player.getRepeatMode() changes.
void	onSeekProcessed() Called when all pending seek requests have been processed by the player.
void	onShuffleModeEnabledChanged(boolean shuffleModeEnabled) Called when the value of Player.getShuffleModeEnabled() changes.
void	onTimelineChanged(Timeline timeline, java.lang.Object manifest, int reason) 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,
                       @Nullable
                       java.lang.Object manifest,
                       int reason)

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(int).

Parameters:

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

manifest - The latest manifest. May be null.

reason - The Player.TimelineChangeReason responsible for this timeline change.

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 Player.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 Player.getPlayWhenReady() or Player.getPlaybackState() changes.

Parameters:

playWhenReady - Whether playback will proceed when ready.

playbackState - One of the STATE constants.

onRepeatModeChanged

void onRepeatModeChanged(int repeatMode)

Called when the value of Player.getRepeatMode() changes.

Parameters:

repeatMode - The Player.RepeatMode used for playback.

onShuffleModeEnabledChanged

void onShuffleModeEnabledChanged(boolean shuffleModeEnabled)

Called when the value of Player.getShuffleModeEnabled() changes.

Parameters:

shuffleModeEnabled - Whether shuffling of windows is enabled.

onPlayerError

void onPlayerError(ExoPlaybackException error)

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

Parameters:

error - The error.

onPositionDiscontinuity

void onPositionDiscontinuity(int reason)

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, int) is called in this case.

Parameters:

reason - The Player.DiscontinuityReason responsible for the discontinuity.

onPlaybackParametersChanged

void onPlaybackParametersChanged(PlaybackParameters playbackParameters)

Called when the current playback parameters change. The playback parameters may change due to a call to Player.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.

onSeekProcessed

void onSeekProcessed()

Called when all pending seek requests have been processed by the player. This is guaranteed to happen after any necessary changes to the player state were reported to onPlayerStateChanged(boolean, int).