com.google.android.exoplayer2.ui

Class DebugTextViewHelper

java.lang.Object

com.google.android.exoplayer2.ui.DebugTextViewHelper

All Implemented Interfaces:

Player.EventListener, Runnable

public final class DebugTextViewHelper
extends Object
implements Runnable, Player.EventListener

A helper class for periodically updating a TextView with debug information obtained from a SimpleExoPlayer.

Constructor Summary

Constructors

Constructor and Description
DebugTextViewHelper(SimpleExoPlayer player, TextView textView)

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() 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	onTimelineChanged(Timeline timeline, Object manifest) Called when the timeline and/or manifest has been refreshed.
void	onTracksChanged(TrackGroupArray tracks, TrackSelectionArray selections) Called when the available or selected tracks change.
void	run()
void	start() Starts periodic updates of the TextView.
void	stop() Stops periodic updates of the TextView.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DebugTextViewHelper

public DebugTextViewHelper(SimpleExoPlayer player,
                           TextView textView)

Parameters:

player - The SimpleExoPlayer from which debug information should be obtained.

textView - The TextView that should be updated to display the information.

Method Detail

start

public void start()

Starts periodic updates of the TextView. Must be called from the application's main thread.

stop

public void stop()

Stops periodic updates of the TextView. Must be called from the application's main thread.

onLoadingChanged

public void onLoadingChanged(boolean isLoading)

Description copied from interface: Player.EventListener

Called when the player starts or stops loading the source.

Specified by:

onLoadingChanged in interface Player.EventListener

Parameters:

isLoading - Whether the source is currently being loaded.

onPlayerStateChanged

public void onPlayerStateChanged(boolean playWhenReady,
                                 int playbackState)

Description copied from interface: Player.EventListener

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

Specified by:

onPlayerStateChanged in interface Player.EventListener

Parameters:

playWhenReady - Whether playback will proceed when ready.

playbackState - One of the STATE constants.

onRepeatModeChanged

public void onRepeatModeChanged(int repeatMode)

Description copied from interface: Player.EventListener

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

Specified by:

onRepeatModeChanged in interface Player.EventListener

Parameters:

repeatMode - The Player.RepeatMode used for playback.

onPositionDiscontinuity

public void onPositionDiscontinuity()

Description copied from interface: Player.EventListener

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. Player.EventListener.onTimelineChanged(Timeline, Object) is called in this case.

Specified by:

onPositionDiscontinuity in interface Player.EventListener

onPlaybackParametersChanged

public void onPlaybackParametersChanged(PlaybackParameters playbackParameters)

Description copied from interface: Player.EventListener

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

Specified by:

onPlaybackParametersChanged in interface Player.EventListener

Parameters:

playbackParameters - The playback parameters.

onTimelineChanged

public void onTimelineChanged(Timeline timeline,
                              Object manifest)

Description copied from interface: Player.EventListener

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 Player.EventListener.onPositionDiscontinuity().

Specified by:

onTimelineChanged in interface Player.EventListener

Parameters:

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

manifest - The latest manifest. May be null.

onPlayerError

public void onPlayerError(ExoPlaybackException error)

Description copied from interface: Player.EventListener

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.

Specified by:

onPlayerError in interface Player.EventListener

Parameters:

error - The error.

onTracksChanged

public void onTracksChanged(TrackGroupArray tracks,
                            TrackSelectionArray selections)

Description copied from interface: Player.EventListener

Called when the available or selected tracks change.

Specified by:

onTracksChanged in interface Player.EventListener

Parameters:

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

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

run

public void run()

Specified by:

run in interface Runnable