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. All methods have no-op default implementations to allow selective overrides.

Method Summary

Modifier and Type	Method and Description
default void	onLoadingChanged(boolean isLoading) Called when the player starts or stops loading the source.
default void	onPlaybackParametersChanged(PlaybackParameters playbackParameters) Called when the current playback parameters change.
default void	onPlayerError(ExoPlaybackException error) Called when an error occurs.
default void	onPlayerStateChanged(boolean playWhenReady, int playbackState) Called when the value returned from either Player.getPlayWhenReady() or Player.getPlaybackState() changes.
default void	onPositionDiscontinuity(int reason) Called when a position discontinuity occurs without a change to the timeline.
default void	onRepeatModeChanged(int repeatMode) Called when the value of Player.getRepeatMode() changes.
default void	onSeekProcessed() Called when all pending seek requests have been processed by the player.
default void	onShuffleModeEnabledChanged(boolean shuffleModeEnabled) Called when the value of Player.getShuffleModeEnabled() changes.
default void	onTimelineChanged(Timeline timeline, java.lang.Object manifest, int reason) Called when the timeline and/or manifest has been refreshed.
default void	onTracksChanged(TrackGroupArray trackGroups, TrackSelectionArray trackSelections) Called when the available or selected tracks change.

Method Detail

onTimelineChanged

default void onTimelineChanged(Timeline timeline,
                               @Nullable
                               java.lang.Object manifest,
                               @Player.TimelineChangeReason
                               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

default 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

default void onLoadingChanged(boolean isLoading)

Called when the player starts or stops loading the source.

Parameters:

isLoading - Whether the source is currently being loaded.

onPlayerStateChanged

default 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

default void onRepeatModeChanged(@Player.RepeatMode
                                 int repeatMode)

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

Parameters:

repeatMode - The Player.RepeatMode used for playback.

onShuffleModeEnabledChanged

default void onShuffleModeEnabledChanged(boolean shuffleModeEnabled)

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

Parameters:

shuffleModeEnabled - Whether shuffling of windows is enabled.

onPlayerError

default 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

default void onPositionDiscontinuity(@Player.DiscontinuityReason
                                     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

default 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

default 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).