com.google.android.exoplayer

Class MediaCodecVideoTrackRenderer

java.lang.Object

com.google.android.exoplayer.TrackRenderer

com.google.android.exoplayer.SampleSourceTrackRenderer

com.google.android.exoplayer.MediaCodecTrackRenderer

com.google.android.exoplayer.MediaCodecVideoTrackRenderer

All Implemented Interfaces:

ExoPlayer.ExoPlayerComponent

public class MediaCodecVideoTrackRenderer
extends MediaCodecTrackRenderer

Decodes and renders video using MediaCodec.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MediaCodecVideoTrackRenderer.EventListener Interface definition for a callback to be notified of MediaCodecVideoTrackRenderer events.

Nested classes/interfaces inherited from class com.google.android.exoplayer.MediaCodecTrackRenderer

MediaCodecTrackRenderer.DecoderInitializationException

Field Summary

Fields

Modifier and Type	Field and Description
static int	MSG_SET_SURFACE The type of a message that can be passed to an instance of this class via ExoPlayer.sendMessage(com.google.android.exoplayer.ExoPlayer.ExoPlayerComponent, int, java.lang.Object) or ExoPlayer.blockingSendMessage(com.google.android.exoplayer.ExoPlayer.ExoPlayerComponent, int, java.lang.Object).

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

codecCounters, eventHandler, SOURCE_STATE_NOT_READY, SOURCE_STATE_READY, SOURCE_STATE_READY_READ_MAY_FAIL

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
MediaCodecVideoTrackRenderer(Context context, SampleSource source, MediaCodecSelector mediaCodecSelector, int videoScalingMode)
MediaCodecVideoTrackRenderer(Context context, SampleSource source, MediaCodecSelector mediaCodecSelector, int videoScalingMode, long allowedJoiningTimeMs)
MediaCodecVideoTrackRenderer(Context context, SampleSource source, MediaCodecSelector mediaCodecSelector, int videoScalingMode, long allowedJoiningTimeMs, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, boolean playClearSamplesWithoutKeys, Handler eventHandler, MediaCodecVideoTrackRenderer.EventListener eventListener, int maxDroppedFrameCountToNotify)
MediaCodecVideoTrackRenderer(Context context, SampleSource source, MediaCodecSelector mediaCodecSelector, int videoScalingMode, long allowedJoiningTimeMs, Handler eventHandler, MediaCodecVideoTrackRenderer.EventListener eventListener, int maxDroppedFrameCountToNotify)

Method Summary

Modifier and Type	Method and Description
protected boolean	canReconfigureCodec(MediaCodec codec, boolean codecIsAdaptive, MediaFormat oldFormat, MediaFormat newFormat) Determines whether the existing MediaCodec should be reconfigured for a new format by sending codec specific initialization data at the start of the next input buffer.
protected void	configureCodec(MediaCodec codec, boolean codecIsAdaptive, MediaFormat format, MediaCrypto crypto) Configures a newly created MediaCodec.
protected void	dropOutputBuffer(MediaCodec codec, int bufferIndex)
void	handleMessage(int messageType, Object message) Handles a message delivered to the component.
protected boolean	handlesTrack(MediaCodecSelector mediaCodecSelector, MediaFormat mediaFormat) Returns whether this renderer is capable of handling the provided track.
protected boolean	haveRenderedFirstFrame()
protected boolean	isReady() Whether the renderer is able to immediately render media from the current position.
protected void	onDisabled() Called when the renderer is disabled.
protected void	onDiscontinuity(long positionUs) Invoked when a discontinuity is encountered.
protected void	onEnabled(int track, long positionUs, boolean joining) Called when the renderer is enabled.
protected void	onInputFormatChanged(MediaFormatHolder holder) Invoked when a new format is read from the upstream SampleSource.
protected void	onOutputFormatChanged(MediaCodec codec, MediaFormat outputFormat) Invoked when the output format of the MediaCodec changes.
protected void	onStarted() Called when the renderer is started.
protected void	onStopped() Called when the renderer is stopped.
protected boolean	processOutputBuffer(long positionUs, long elapsedRealtimeUs, MediaCodec codec, ByteBuffer buffer, MediaCodec.BufferInfo bufferInfo, int bufferIndex, boolean shouldSkip) Processes the provided output buffer.
protected void	renderOutputBuffer(MediaCodec codec, int bufferIndex)
protected void	renderOutputBufferV21(MediaCodec codec, int bufferIndex, long releaseTimeNs)
protected boolean	shouldInitCodec()
protected void	skipOutputBuffer(MediaCodec codec, int bufferIndex)

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

codecInitialized, doSomeWork, flushCodec, getDecoderInfo, getDequeueOutputBufferTimeoutUs, getSourceState, handlesTrack, haveFormat, isEnded, maybeInitCodec, onOutputStreamEnded, onProcessedOutputBuffer, onQueuedInputBuffer, releaseCodec

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

doPrepare, doSomeWork, getBufferedPositionUs, getDurationUs, getFormat, getTrackCount, maybeThrowError, onReleased, readSource, seekTo, shiftInputPosition

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

getMediaClock, getState

Methods inherited from class java.lang.Object

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

Field Detail

MSG_SET_SURFACE

public static final int MSG_SET_SURFACE

The type of a message that can be passed to an instance of this class via ExoPlayer.sendMessage(com.google.android.exoplayer.ExoPlayer.ExoPlayerComponent, int, java.lang.Object) or ExoPlayer.blockingSendMessage(com.google.android.exoplayer.ExoPlayer.ExoPlayerComponent, int, java.lang.Object). The message object should be the target Surface, or null.

See Also:

Constant Field Values

Constructor Detail

MediaCodecVideoTrackRenderer

public MediaCodecVideoTrackRenderer(Context context,
                                    SampleSource source,
                                    MediaCodecSelector mediaCodecSelector,
                                    int videoScalingMode)

Parameters:

context - A context.

source - The upstream source from which the renderer obtains samples.

mediaCodecSelector - A decoder selector.

videoScalingMode - The scaling mode to pass to MediaCodec.setVideoScalingMode(int).

MediaCodecVideoTrackRenderer

public MediaCodecVideoTrackRenderer(Context context,
                                    SampleSource source,
                                    MediaCodecSelector mediaCodecSelector,
                                    int videoScalingMode,
                                    long allowedJoiningTimeMs)

Parameters:

context - A context.

source - The upstream source from which the renderer obtains samples.

mediaCodecSelector - A decoder selector.

videoScalingMode - The scaling mode to pass to MediaCodec.setVideoScalingMode(int).

allowedJoiningTimeMs - The maximum duration in milliseconds for which this video renderer can attempt to seamlessly join an ongoing playback.

MediaCodecVideoTrackRenderer

public MediaCodecVideoTrackRenderer(Context context,
                                    SampleSource source,
                                    MediaCodecSelector mediaCodecSelector,
                                    int videoScalingMode,
                                    long allowedJoiningTimeMs,
                                    Handler eventHandler,
                                    MediaCodecVideoTrackRenderer.EventListener eventListener,
                                    int maxDroppedFrameCountToNotify)

Parameters:

context - A context.

source - The upstream source from which the renderer obtains samples.

mediaCodecSelector - A decoder selector.

videoScalingMode - The scaling mode to pass to MediaCodec.setVideoScalingMode(int).

allowedJoiningTimeMs - The maximum duration in milliseconds for which this video renderer can attempt to seamlessly join an ongoing playback.

eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

maxDroppedFrameCountToNotify - The maximum number of frames that can be dropped between invocations of MediaCodecVideoTrackRenderer.EventListener.onDroppedFrames(int, long).

MediaCodecVideoTrackRenderer

public MediaCodecVideoTrackRenderer(Context context,
                                    SampleSource source,
                                    MediaCodecSelector mediaCodecSelector,
                                    int videoScalingMode,
                                    long allowedJoiningTimeMs,
                                    DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                                    boolean playClearSamplesWithoutKeys,
                                    Handler eventHandler,
                                    MediaCodecVideoTrackRenderer.EventListener eventListener,
                                    int maxDroppedFrameCountToNotify)

Parameters:

context - A context.

source - The upstream source from which the renderer obtains samples.

mediaCodecSelector - A decoder selector.

videoScalingMode - The scaling mode to pass to MediaCodec.setVideoScalingMode(int).

allowedJoiningTimeMs - The maximum duration in milliseconds for which this video renderer can attempt to seamlessly join an ongoing playback.

drmSessionManager - For use with encrypted content. May be null if support for encrypted content is not required.

playClearSamplesWithoutKeys - Encrypted media may contain clear (un-encrypted) regions. For example a media file may start with a short clear region so as to allow playback to begin in parallel with key acquisision. This parameter specifies whether the renderer is permitted to play clear regions of encrypted media files before drmSessionManager has obtained the keys necessary to decrypt encrypted regions of the media.

eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

maxDroppedFrameCountToNotify - The maximum number of frames that can be dropped between invocations of MediaCodecVideoTrackRenderer.EventListener.onDroppedFrames(int, long).

Method Detail

handlesTrack

protected boolean handlesTrack(MediaCodecSelector mediaCodecSelector,
                               MediaFormat mediaFormat)
                        throws MediaCodecUtil.DecoderQueryException

Description copied from class: MediaCodecTrackRenderer

Returns whether this renderer is capable of handling the provided track.

Specified by:

handlesTrack in class MediaCodecTrackRenderer

Parameters:

mediaCodecSelector - The decoder selector.

mediaFormat - The format of the track.

Returns:

True if the renderer can handle the track, false otherwise.

Throws:

MediaCodecUtil.DecoderQueryException - Thrown if there was an error querying decoders.

onEnabled

protected void onEnabled(int track,
                         long positionUs,
                         boolean joining)
                  throws ExoPlaybackException

Description copied from class: TrackRenderer

Called when the renderer is enabled.

The default implementation is a no-op.

Overrides:

onEnabled in class SampleSourceTrackRenderer

Parameters:

track - The track for which the renderer is being enabled.

positionUs - The player's current position.

joining - Whether this renderer is being enabled to join an ongoing playback.

Throws:

ExoPlaybackException - If an error occurs.

onDiscontinuity

protected void onDiscontinuity(long positionUs)
                        throws ExoPlaybackException

Description copied from class: SampleSourceTrackRenderer

Invoked when a discontinuity is encountered. Also invoked when the renderer is enabled, for convenience.

Overrides:

onDiscontinuity in class MediaCodecTrackRenderer

Parameters:

positionUs - The playback position after the discontinuity, or the position at which the renderer is being enabled.

Throws:

ExoPlaybackException - If an error occurs handling the discontinuity.

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

Overrides:

isReady in class MediaCodecTrackRenderer

Returns:

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

onStarted

protected void onStarted()

Description copied from class: TrackRenderer

Called when the renderer is started.

The default implementation is a no-op.

Overrides:

onStarted in class MediaCodecTrackRenderer

onStopped

protected void onStopped()

Description copied from class: TrackRenderer

Called when the renderer is stopped.

The default implementation is a no-op.

Overrides:

onStopped in class MediaCodecTrackRenderer

onDisabled

protected void onDisabled()
                   throws ExoPlaybackException

Description copied from class: TrackRenderer

Called when the renderer is disabled.

The default implementation is a no-op.

Overrides:

onDisabled in class MediaCodecTrackRenderer

Throws:

ExoPlaybackException - If an error occurs.

handleMessage

public void handleMessage(int messageType,
                          Object message)
                   throws ExoPlaybackException

Description copied from interface: ExoPlayer.ExoPlayerComponent

Handles a message delivered to the component. Invoked on the playback thread.

Specified by:

handleMessage in interface ExoPlayer.ExoPlayerComponent

Overrides:

handleMessage in class TrackRenderer

Parameters:

messageType - An integer identifying the type of message.

message - The message object.

Throws:

ExoPlaybackException - If an error occurred whilst handling the message.

shouldInitCodec

protected boolean shouldInitCodec()

Overrides:

shouldInitCodec in class MediaCodecTrackRenderer

configureCodec

protected void configureCodec(MediaCodec codec,
                              boolean codecIsAdaptive,
                              MediaFormat format,
                              MediaCrypto crypto)

Description copied from class: MediaCodecTrackRenderer

Configures a newly created MediaCodec.

Specified by:

configureCodec in class MediaCodecTrackRenderer

Parameters:

codec - The MediaCodec to configure.

codecIsAdaptive - Whether the codec is adaptive.

format - The format for which the codec is being configured.

crypto - For drm protected playbacks, a MediaCrypto to use for decryption.

onInputFormatChanged

protected void onInputFormatChanged(MediaFormatHolder holder)
                             throws ExoPlaybackException

Description copied from class: MediaCodecTrackRenderer

Invoked when a new format is read from the upstream SampleSource.

Overrides:

onInputFormatChanged in class MediaCodecTrackRenderer

Parameters:

holder - Holds the new format.

Throws:

ExoPlaybackException - If an error occurs reinitializing the MediaCodec.

haveRenderedFirstFrame

protected final boolean haveRenderedFirstFrame()

Returns:

True if the first frame has been rendered (playback has not necessarily begun).

onOutputFormatChanged

protected void onOutputFormatChanged(MediaCodec codec,
                                     MediaFormat outputFormat)

Description copied from class: MediaCodecTrackRenderer

Invoked when the output format of the MediaCodec changes.

The default implementation is a no-op.

Overrides:

onOutputFormatChanged in class MediaCodecTrackRenderer

Parameters:

codec - The MediaCodec instance.

outputFormat - The new output format.

canReconfigureCodec

protected boolean canReconfigureCodec(MediaCodec codec,
                                      boolean codecIsAdaptive,
                                      MediaFormat oldFormat,
                                      MediaFormat newFormat)

Description copied from class: MediaCodecTrackRenderer

Determines whether the existing MediaCodec should be reconfigured for a new format by sending codec specific initialization data at the start of the next input buffer. If true is returned then the MediaCodec instance will be reconfigured in this way. If false is returned then the instance will be released, and a new instance will be created for the new format.

The default implementation returns false.

Overrides:

canReconfigureCodec in class MediaCodecTrackRenderer

Parameters:

codec - The existing MediaCodec instance.

codecIsAdaptive - Whether the codec is adaptive.

oldFormat - The format for which the existing instance is configured.

newFormat - The new format.

Returns:

True if the existing instance can be reconfigured. False otherwise.

processOutputBuffer

protected boolean processOutputBuffer(long positionUs,
                                      long elapsedRealtimeUs,
                                      MediaCodec codec,
                                      ByteBuffer buffer,
                                      MediaCodec.BufferInfo bufferInfo,
                                      int bufferIndex,
                                      boolean shouldSkip)

Description copied from class: MediaCodecTrackRenderer

Processes the provided output buffer.

Specified by:

processOutputBuffer in class MediaCodecTrackRenderer

Returns:

True if the output buffer was processed (e.g. rendered or discarded) and hence is no longer required. False otherwise.

skipOutputBuffer

protected void skipOutputBuffer(MediaCodec codec,
                                int bufferIndex)

dropOutputBuffer

protected void dropOutputBuffer(MediaCodec codec,
                                int bufferIndex)

renderOutputBuffer

protected void renderOutputBuffer(MediaCodec codec,
                                  int bufferIndex)

renderOutputBufferV21

protected void renderOutputBufferV21(MediaCodec codec,
                                     int bufferIndex,
                                     long releaseTimeNs)