com.google.android.exoplayer

Class DummyTrackRenderer

java.lang.Object

com.google.android.exoplayer.TrackRenderer

com.google.android.exoplayer.DummyTrackRenderer

All Implemented Interfaces:

ExoPlayer.ExoPlayerComponent

public final class DummyTrackRenderer
extends TrackRenderer

A TrackRenderer that does nothing.

This renderer returns 0 from getTrackCount() in order to request that it should be ignored. IllegalStateException is thrown from all other methods documented to indicate that they should not be invoked unless the renderer is prepared.

Field Summary

Fields inherited from class com.google.android.exoplayer.TrackRenderer

END_OF_TRACK_US, MATCH_LONGEST_US, STATE_ENABLED, STATE_PREPARED, STATE_RELEASED, STATE_STARTED, STATE_UNPREPARED, UNKNOWN_TIME_US

Constructor Summary

Constructors

Constructor and Description
DummyTrackRenderer()

Method Summary

Modifier and Type	Method and Description
protected boolean	doPrepare(long positionUs) Invoked to make progress when the renderer is in the TrackRenderer.STATE_UNPREPARED state.
protected void	doSomeWork(long positionUs, long elapsedRealtimeUs) Invoked to make progress when the renderer is in the TrackRenderer.STATE_ENABLED or TrackRenderer.STATE_STARTED states.
protected long	getBufferedPositionUs() Returns an estimate of the absolute position in microseconds up to which data is buffered.
protected long	getDurationUs() Returns the duration of the media being rendered.
protected MediaFormat	getFormat(int track) Returns the format of the specified track.
protected int	getTrackCount() Returns the number of tracks exposed by the renderer.
protected boolean	isEnded() Whether the renderer is ready for the ExoPlayer instance to transition to ExoPlayer.STATE_ENDED.
protected boolean	isReady() Whether the renderer is able to immediately render media from the current position.
protected void	maybeThrowError() Throws an error that's preventing the renderer from making progress or buffering more data at this point in time.
protected void	seekTo(long positionUs) Seeks to a specified time in the track.

Methods inherited from class com.google.android.exoplayer.TrackRenderer

getMediaClock, getState, handleMessage, onDisabled, onEnabled, onReleased, onStarted, onStopped

Methods inherited from class java.lang.Object

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

Constructor Detail

DummyTrackRenderer

public DummyTrackRenderer()

Method Detail

doPrepare

protected boolean doPrepare(long positionUs)
                     throws ExoPlaybackException

Description copied from class: TrackRenderer

Invoked to make progress when the renderer is in the TrackRenderer.STATE_UNPREPARED state. This method will be called repeatedly until true is returned.

This method should return quickly, and should not block if the renderer is currently unable to make any useful progress.

Specified by:

doPrepare in class TrackRenderer

Parameters:

positionUs - The player's current playback position.

Returns:

True if the renderer is now prepared. False otherwise.

Throws:

ExoPlaybackException - If an error occurs.

getTrackCount

protected int getTrackCount()

Description copied from class: TrackRenderer

Returns the number of tracks exposed by the renderer.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_PREPARED, TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

getTrackCount in class TrackRenderer

Returns:

The number of tracks.

getFormat

protected MediaFormat getFormat(int track)

Description copied from class: TrackRenderer

Returns the format of the specified track.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_PREPARED, TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

getFormat in class TrackRenderer

Parameters:

track - The track index.

Returns:

The format of the specified track.

isEnded

protected boolean isEnded()

Description copied from class: TrackRenderer

Whether the renderer is ready for the ExoPlayer instance to transition to ExoPlayer.STATE_ENDED. The player will make this transition as soon as true is returned by all of its TrackRenderers.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

isEnded in class TrackRenderer

Returns:

Whether the renderer is ready for the player to transition to the ended state.

isReady

protected boolean isReady()

Description copied from class: TrackRenderer

Whether the renderer is able to immediately render media from the current position.

If the renderer is in the TrackRenderer.STATE_STARTED state then returning true indicates that the renderer has everything that it needs to continue playback. Returning false indicates that the player should pause until the renderer is ready.

If the renderer is in the TrackRenderer.STATE_ENABLED state then returning true indicates that the renderer is ready for playback to be started. Returning false indicates that it is not.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

isReady in class TrackRenderer

Returns:

True if the renderer is ready to render media. False otherwise.

seekTo

protected void seekTo(long positionUs)

Description copied from class: TrackRenderer

Seeks to a specified time in the track.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_ENABLED

Specified by:

seekTo in class TrackRenderer

Parameters:

positionUs - The desired playback position in microseconds.

doSomeWork

protected void doSomeWork(long positionUs,
                          long elapsedRealtimeUs)

Description copied from class: TrackRenderer

Invoked to make progress when the renderer is in the TrackRenderer.STATE_ENABLED or TrackRenderer.STATE_STARTED states.

If the renderer's state is TrackRenderer.STATE_STARTED, then repeated calls to this method should cause the media track to be rendered. If the state is TrackRenderer.STATE_ENABLED, then repeated calls should make progress towards getting the renderer into a position where it is ready to render the track.

This method should return quickly, and should not block if the renderer is currently unable to make any useful progress.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

doSomeWork in class TrackRenderer

Parameters:

positionUs - The current media time in microseconds, measured at the start of the current iteration of the rendering loop.

elapsedRealtimeUs - SystemClock.elapsedRealtime() in microseconds, measured at the start of the current iteration of the rendering loop.

maybeThrowError

protected void maybeThrowError()

Description copied from class: TrackRenderer

Throws an error that's preventing the renderer from making progress or buffering more data at this point in time.

Specified by:

maybeThrowError in class TrackRenderer

getDurationUs

protected long getDurationUs()

Description copied from class: TrackRenderer

Returns the duration of the media being rendered.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_PREPARED, TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

getDurationUs in class TrackRenderer

Returns:

The duration of the track in microseconds, or TrackRenderer.MATCH_LONGEST_US if the track's duration should match that of the longest track whose duration is known, or or TrackRenderer.UNKNOWN_TIME_US if the duration is not known.

getBufferedPositionUs

protected long getBufferedPositionUs()

Description copied from class: TrackRenderer

Returns an estimate of the absolute position in microseconds up to which data is buffered.

This method may be called when the renderer is in the following states: TrackRenderer.STATE_ENABLED, TrackRenderer.STATE_STARTED

Specified by:

getBufferedPositionUs in class TrackRenderer

Returns:

An estimate of the absolute position in microseconds up to which data is buffered, or TrackRenderer.END_OF_TRACK_US if the track is fully buffered, or TrackRenderer.UNKNOWN_TIME_US if no estimate is available.