MediaCodecVideoRenderer (ExoPlayer library)

java.lang.Object
- com.google.android.exoplayer2.BaseRenderer
- - com.google.android.exoplayer2.mediacodec.MediaCodecRenderer
  - - com.google.android.exoplayer2.video.MediaCodecVideoRenderer

All Implemented Interfaces:

PlayerMessage.Target, Renderer, RendererCapabilities
```
public class MediaCodecVideoRenderer
extends MediaCodecRenderer
```
Decodes and renders video using MediaCodec.
This renderer accepts the following messages sent via ExoPlayer#createMessage(Target) on the playback thread:
- Message with type C.MSG_SET_SURFACE to set the output surface. The message payload should be the target Surface, or null.
- Message with type C.MSG_SET_SCALING_MODE to set the video scaling mode. The message payload should be one of the integer scaling modes in C.VideoScalingMode. Note that the scaling mode only applies if the Surface targeted by this renderer is owned by a SurfaceView.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static class MediaCodecVideoRenderer.CodecMaxValues
- Nested classes/interfaces inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer
  MediaCodecRenderer.DecoderInitializationException, MediaCodecRenderer.KeepCodecResult
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Renderer
  Renderer.State

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`MediaCodecVideoRenderer.CodecMaxValues`

Field Summary
- Fields inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer
  CODEC_OPERATING_RATE_UNSET, decoderCounters, KEEP_CODEC_RESULT_NO, KEEP_CODEC_RESULT_YES_WITH_RECONFIGURATION, KEEP_CODEC_RESULT_YES_WITHOUT_RECONFIGURATION
- Fields inherited from interface com.google.android.exoplayer2.Renderer
  STATE_DISABLED, STATE_ENABLED, STATE_STARTED
- Fields inherited from interface com.google.android.exoplayer2.RendererCapabilities
  ADAPTIVE_NOT_SEAMLESS, ADAPTIVE_NOT_SUPPORTED, ADAPTIVE_SEAMLESS, ADAPTIVE_SUPPORT_MASK, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_HANDLED, FORMAT_SUPPORT_MASK, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE, TUNNELING_NOT_SUPPORTED, TUNNELING_SUPPORT_MASK, TUNNELING_SUPPORTED

Constructor Summary

Constructors
Constructor and Description
`MediaCodecVideoRenderer(Context context, MediaCodecSelector mediaCodecSelector)`
`MediaCodecVideoRenderer(Context context, MediaCodecSelector mediaCodecSelector, long allowedJoiningTimeMs)`
`MediaCodecVideoRenderer(Context context, MediaCodecSelector mediaCodecSelector, long allowedJoiningTimeMs, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, boolean playClearSamplesWithoutKeys, Handler eventHandler, VideoRendererEventListener eventListener, int maxDroppedFramesToNotify)`
`MediaCodecVideoRenderer(Context context, MediaCodecSelector mediaCodecSelector, long allowedJoiningTimeMs, Handler eventHandler, VideoRendererEventListener eventListener, int maxDroppedFramesToNotify)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected int`	`canKeepCodec(MediaCodec codec, MediaCodecInfo codecInfo, Format oldFormat, Format newFormat)` Determines whether the existing `MediaCodec` can be kept for a new format, and if it can whether it requires reconfiguration.
`protected boolean`	`codecNeedsSetOutputSurfaceWorkaround(String name)` Returns whether the codec is known to implement `MediaCodec.setOutputSurface(Surface)` incorrectly.
`protected void`	`configureCodec(MediaCodecInfo codecInfo, MediaCodec codec, Format format, MediaCrypto crypto, float codecOperatingRate)` Configures a newly created `MediaCodec`.
`protected void`	`dropOutputBuffer(MediaCodec codec, int index, long presentationTimeUs)` Drops the output buffer with the specified index.
`protected void`	`flushCodec()`
`protected MediaCodecVideoRenderer.CodecMaxValues`	`getCodecMaxValues(MediaCodecInfo codecInfo, Format format, Format[] streamFormats)` Returns `MediaCodecVideoRenderer.CodecMaxValues` suitable for configuring a codec for `format` in a way that will allow possible adaptation to other compatible formats in `streamFormats`.
`protected boolean`	`getCodecNeedsEosPropagation()` Returns whether the codec needs the renderer to propagate the end-of-stream signal directly, rather than by using an end-of-stream buffer queued to the codec.
`protected float`	`getCodecOperatingRate(float operatingRate, Format format, Format[] streamFormats)` Returns the `MediaFormat.KEY_OPERATING_RATE` value for a given renderer operating rate, current format and set of possible stream formats.
`protected MediaFormat`	`getMediaFormat(Format format, MediaCodecVideoRenderer.CodecMaxValues codecMaxValues, float codecOperatingRate, boolean deviceNeedsNoPostProcessWorkaround, int tunnelingAudioSessionId)` Returns the framework `MediaFormat` that should be used to configure the decoder.
`protected long`	`getOutputStreamOffsetUs()` Returns the offset that should be subtracted from `bufferPresentationTimeUs` in `processOutputBuffer(long, long, MediaCodec, ByteBuffer, int, int, long, boolean, Format)` to get the playback position with respect to the media.
`void`	`handleMessage(int messageType, Object message)` Handles a message delivered to the target.
`boolean`	`isReady()` Whether the renderer is able to immediately render media from the current position.
`protected boolean`	`maybeDropBuffersToKeyframe(MediaCodec codec, int index, long presentationTimeUs, long positionUs)` Drops frames from the current output buffer to the next keyframe at or before the playback position.
`protected void`	`onCodecInitialized(String name, long initializedTimestampMs, long initializationDurationMs)` Called when a `MediaCodec` has been created and configured.
`protected void`	`onDisabled()` Called when the renderer is disabled.
`protected void`	`onEnabled(boolean joining)` Called when the renderer is enabled.
`protected void`	`onInputFormatChanged(Format newFormat)` Called when a new format is read from the upstream `MediaPeriod`.
`protected void`	`onOutputFormatChanged(MediaCodec codec, MediaFormat outputFormat)` Called when the output format of the `MediaCodec` changes.
`protected void`	`onPositionReset(long positionUs, boolean joining)` Called when the position is reset.
`protected void`	`onProcessedOutputBuffer(long presentationTimeUs)` Called when an output buffer is successfully processed.
`protected void`	`onProcessedTunneledBuffer(long presentationTimeUs)` Called when a buffer was processed in tunneling mode.
`protected void`	`onQueueInputBuffer(DecoderInputBuffer buffer)` Called immediately before an input buffer is queued into the codec.
`protected void`	`onStarted()` Called when the renderer is started.
`protected void`	`onStopped()` Called when the renderer is stopped.
`protected void`	`onStreamChanged(Format[] formats, long offsetUs)` Called when the renderer's stream has changed.
`protected boolean`	`processOutputBuffer(long positionUs, long elapsedRealtimeUs, MediaCodec codec, ByteBuffer buffer, int bufferIndex, int bufferFlags, long bufferPresentationTimeUs, boolean shouldSkip, Format format)` Processes an output media buffer.
`protected void`	`releaseCodec()`
`protected void`	`renderOutputBuffer(MediaCodec codec, int index, long presentationTimeUs)` Renders the output buffer with the specified index.
`protected void`	`renderOutputBufferV21(MediaCodec codec, int index, long presentationTimeUs, long releaseTimeNs)` Renders the output buffer with the specified index.
`protected boolean`	`shouldDropBuffersToKeyframe(long earlyUs, long elapsedRealtimeUs)` Returns whether to drop all buffers from the buffer being processed to the keyframe at or after the current playback position, if possible.
`protected boolean`	`shouldDropOutputBuffer(long earlyUs, long elapsedRealtimeUs)` Returns whether the buffer being processed should be dropped.
`protected boolean`	`shouldForceRenderOutputBuffer(long earlyUs, long elapsedSinceLastRenderUs)` Returns whether to force rendering an output buffer.
`protected boolean`	`shouldInitCodec(MediaCodecInfo codecInfo)`
`protected void`	`skipOutputBuffer(MediaCodec codec, int index, long presentationTimeUs)` Skips the output buffer with the specified index.
`protected int`	`supportsFormat(MediaCodecSelector mediaCodecSelector, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, Format format)` Returns the extent to which the renderer is capable of supporting a given format.
`protected void`	`updateDroppedBufferCounters(int droppedBufferCount)` Updates decoder counters to reflect that `droppedBufferCount` additional buffers were dropped.

Methods inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer
getCodec, getCodecInfo, getDecoderInfos, getDequeueOutputBufferTimeoutUs, isEnded, maybeInitCodec, render, renderToEndOfStream, setOperatingRate, supportsFormat, supportsMixedMimeTypeAdaptation, updateOutputFormatForTime

Methods inherited from class com.google.android.exoplayer2.BaseRenderer
disable, enable, getCapabilities, getConfiguration, getIndex, getMediaClock, getState, getStream, getStreamFormats, getTrackType, hasReadStreamToEnd, isCurrentStreamFinal, isSourceReady, maybeThrowStreamError, readSource, replaceStream, resetPosition, setCurrentStreamFinal, setIndex, skipSource, start, stop, supportsFormatDrm

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MediaCodecVideoRenderer
```
public MediaCodecVideoRenderer(Context context,
                               MediaCodecSelector mediaCodecSelector)
```
    Parameters:
    
    context - A context.
    
    mediaCodecSelector - A decoder selector.
  - MediaCodecVideoRenderer
```
public MediaCodecVideoRenderer(Context context,
                               MediaCodecSelector mediaCodecSelector,
                               long allowedJoiningTimeMs)
```
    Parameters:
    
    context - A context.
    
    mediaCodecSelector - A decoder selector.
    
    allowedJoiningTimeMs - The maximum duration in milliseconds for which this video renderer can attempt to seamlessly join an ongoing playback.
  - MediaCodecVideoRenderer
```
public MediaCodecVideoRenderer(Context context,
                               MediaCodecSelector mediaCodecSelector,
                               long allowedJoiningTimeMs,
                               @Nullable
                               Handler eventHandler,
                               @Nullable
                               VideoRendererEventListener eventListener,
                               int maxDroppedFramesToNotify)
```
    Parameters:
    
    context - A context.
    
    mediaCodecSelector - A decoder selector.
    
    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.
    
    maxDroppedFramesToNotify - The maximum number of frames that can be dropped between invocations of VideoRendererEventListener.onDroppedFrames(int, long).
  - MediaCodecVideoRenderer
```
public MediaCodecVideoRenderer(Context context,
                               MediaCodecSelector mediaCodecSelector,
                               long allowedJoiningTimeMs,
                               @Nullable
                               DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                               boolean playClearSamplesWithoutKeys,
                               @Nullable
                               Handler eventHandler,
                               @Nullable
                               VideoRendererEventListener eventListener,
                               int maxDroppedFramesToNotify)
```
    Parameters:
    
    context - A context.
    
    mediaCodecSelector - A decoder selector.
    
    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 acquisition. 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.
    
    maxDroppedFramesToNotify - The maximum number of frames that can be dropped between invocations of VideoRendererEventListener.onDroppedFrames(int, long).
- Method Detail
  - supportsFormat
```
protected int supportsFormat(MediaCodecSelector mediaCodecSelector,
                             DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                             Format format)
                      throws MediaCodecUtil.DecoderQueryException
```
    Description copied from class: MediaCodecRenderer
    
    Returns the extent to which the renderer is capable of supporting a given format.
    
    Specified by:
    
    supportsFormat in class MediaCodecRenderer
    
    Parameters:
    
    mediaCodecSelector - The decoder selector.
    
    drmSessionManager - The renderer's DrmSessionManager.
    
    format - The format.
    
    Returns:
    
    The extent to which the renderer is capable of supporting the given format. See MediaCodecRenderer.supportsFormat(Format) for more detail.
    
    Throws:
    
    MediaCodecUtil.DecoderQueryException - If there was an error querying decoders.
  - onEnabled
```
protected void onEnabled(boolean joining)
                  throws ExoPlaybackException
```
    Description copied from class: BaseRenderer
    
    Called when the renderer is enabled.
    The default implementation is a no-op.
    
    Overrides:
    
    onEnabled in class MediaCodecRenderer
    
    Parameters:
    
    joining - Whether this renderer is being enabled to join an ongoing playback.
    
    Throws:
    
    ExoPlaybackException - If an error occurs.
  - onStreamChanged
```
protected void onStreamChanged(Format[] formats,
                               long offsetUs)
                        throws ExoPlaybackException
```
    Description copied from class: BaseRenderer
    
    Called when the renderer's stream has changed. This occurs when the renderer is enabled after BaseRenderer.onEnabled(boolean) has been called, and also when the stream has been replaced whilst the renderer is enabled or started.
    The default implementation is a no-op.
    
    Overrides:
    
    onStreamChanged in class BaseRenderer
    
    Parameters:
    
    formats - The enabled formats.
    
    offsetUs - The offset that will be added to the timestamps of buffers read via BaseRenderer.readSource(FormatHolder, DecoderInputBuffer, boolean) so that decoder input buffers have monotonically increasing timestamps.
    
    Throws:
    
    ExoPlaybackException - If an error occurs.
  - onPositionReset
```
protected void onPositionReset(long positionUs,
                               boolean joining)
                        throws ExoPlaybackException
```
    Description copied from class: BaseRenderer
    
    Called when the position is reset. This occurs when the renderer is enabled after BaseRenderer.onStreamChanged(Format[], long) has been called, and also when a position discontinuity is encountered.
    After a position reset, the renderer's SampleStream is guaranteed to provide samples starting from a key frame.
    The default implementation is a no-op.
    
    Overrides:
    
    onPositionReset in class MediaCodecRenderer
    
    Parameters:
    
    positionUs - The new playback position in microseconds.
    
    joining - Whether this renderer is being enabled to join an ongoing playback.
    
    Throws:
    
    ExoPlaybackException - If an error occurs.
  - isReady
```
public boolean isReady()
```
    Description copied from interface: Renderer
    
    Whether the renderer is able to immediately render media from the current position.
    If the renderer is in the Renderer.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 Renderer.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: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
    
    Specified by:
    
    isReady in interface Renderer
    
    Overrides:
    
    isReady in class MediaCodecRenderer
    
    Returns:
    
    Whether the renderer is ready to render media.
  - onStarted
```
protected void onStarted()
```
    Description copied from class: BaseRenderer
    
    Called when the renderer is started.
    The default implementation is a no-op.
    
    Overrides:
    
    onStarted in class MediaCodecRenderer
  - onStopped
```
protected void onStopped()
```
    Description copied from class: BaseRenderer
    
    Called when the renderer is stopped.
    The default implementation is a no-op.
    
    Overrides:
    
    onStopped in class MediaCodecRenderer
  - onDisabled
```
protected void onDisabled()
```
    Description copied from class: BaseRenderer
    
    Called when the renderer is disabled.
    The default implementation is a no-op.
    
    Overrides:
    
    onDisabled in class MediaCodecRenderer
  - handleMessage
```
public void handleMessage(int messageType,
                          @Nullable
                          Object message)
                   throws ExoPlaybackException
```
    Description copied from interface: PlayerMessage.Target
    
    Handles a message delivered to the target.
    
    Specified by:
    
    handleMessage in interface PlayerMessage.Target
    
    Overrides:
    
    handleMessage in class BaseRenderer
    
    Parameters:
    
    messageType - The message type.
    
    message - The message payload.
    
    Throws:
    
    ExoPlaybackException - If an error occurred whilst handling the message. Should only be thrown by targets that handle messages on the playback thread.
  - shouldInitCodec
```
protected boolean shouldInitCodec(MediaCodecInfo codecInfo)
```
    Overrides:
    
    shouldInitCodec in class MediaCodecRenderer
  - getCodecNeedsEosPropagation
```
protected boolean getCodecNeedsEosPropagation()
```
    Description copied from class: MediaCodecRenderer
    
    Returns whether the codec needs the renderer to propagate the end-of-stream signal directly, rather than by using an end-of-stream buffer queued to the codec.
    
    Overrides:
    
    getCodecNeedsEosPropagation in class MediaCodecRenderer
  - configureCodec
```
protected void configureCodec(MediaCodecInfo codecInfo,
                              MediaCodec codec,
                              Format format,
                              MediaCrypto crypto,
                              float codecOperatingRate)
                       throws MediaCodecUtil.DecoderQueryException
```
    Description copied from class: MediaCodecRenderer
    
    Configures a newly created MediaCodec.
    
    Specified by:
    
    configureCodec in class MediaCodecRenderer
    
    Parameters:
    
    codecInfo - Information about the MediaCodec being configured.
    
    codec - The MediaCodec to configure.
    
    format - The format for which the codec is being configured.
    
    crypto - For drm protected playbacks, a MediaCrypto to use for decryption.
    
    codecOperatingRate - The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.
    
    Throws:
    
    MediaCodecUtil.DecoderQueryException - If an error occurs querying codecInfo.
  - canKeepCodec
```
@MediaCodecRenderer.KeepCodecResult
protected int canKeepCodec(MediaCodec codec,
                                                               MediaCodecInfo codecInfo,
                                                               Format oldFormat,
                                                               Format newFormat)
```
    Description copied from class: MediaCodecRenderer
    
    Determines whether the existing MediaCodec can be kept for a new format, and if it can whether it requires reconfiguration.
    The default implementation returns MediaCodecRenderer.KEEP_CODEC_RESULT_NO.
    
    Overrides:
    
    canKeepCodec in class MediaCodecRenderer
    
    Parameters:
    
    codec - The existing MediaCodec instance.
    
    codecInfo - A MediaCodecInfo describing the decoder.
    
    oldFormat - The format for which the existing instance is configured.
    
    newFormat - The new format.
    
    Returns:
    
    Whether the instance can be kept, and if it can whether it requires reconfiguration.
  - releaseCodec
```
@CallSuper
protected void releaseCodec()
```
    Overrides:
    
    releaseCodec in class MediaCodecRenderer
  - flushCodec
```
@CallSuper
protected void flushCodec()
                              throws ExoPlaybackException
```
    Overrides:
    
    flushCodec in class MediaCodecRenderer
    
    Throws:
    
    ExoPlaybackException
  - getCodecOperatingRate
```
protected float getCodecOperatingRate(float operatingRate,
                                      Format format,
                                      Format[] streamFormats)
```
    Description copied from class: MediaCodecRenderer
    
    Returns the MediaFormat.KEY_OPERATING_RATE value for a given renderer operating rate, current format and set of possible stream formats.
    The default implementation returns MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET.
    
    Overrides:
    
    getCodecOperatingRate in class MediaCodecRenderer
    
    Parameters:
    
    operatingRate - The renderer operating rate.
    
    format - The format for which the codec is being configured.
    
    streamFormats - The possible stream formats.
    
    Returns:
    
    The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.
  - onCodecInitialized
```
protected void onCodecInitialized(String name,
                                  long initializedTimestampMs,
                                  long initializationDurationMs)
```
    Description copied from class: MediaCodecRenderer
    
    Called when a MediaCodec has been created and configured.
    The default implementation is a no-op.
    
    Overrides:
    
    onCodecInitialized in class MediaCodecRenderer
    
    Parameters:
    
    name - The name of the codec that was initialized.
    
    initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.
    
    initializationDurationMs - The time taken to initialize the codec in milliseconds.
  - onInputFormatChanged
```
protected void onInputFormatChanged(Format newFormat)
                             throws ExoPlaybackException
```
    Description copied from class: MediaCodecRenderer
    
    Called when a new format is read from the upstream MediaPeriod.
    
    Overrides:
    
    onInputFormatChanged in class MediaCodecRenderer
    
    Parameters:
    
    newFormat - The new format.
    
    Throws:
    
    ExoPlaybackException - If an error occurs reinitializing the MediaCodec.
  - onQueueInputBuffer
```
@CallSuper
protected void onQueueInputBuffer(DecoderInputBuffer buffer)
```
    Called immediately before an input buffer is queued into the codec.
    
    Overrides:
    
    onQueueInputBuffer in class MediaCodecRenderer
    
    Parameters:
    
    buffer - The buffer to be queued.
  - onOutputFormatChanged
```
protected void onOutputFormatChanged(MediaCodec codec,
                                     MediaFormat outputFormat)
```
    Description copied from class: MediaCodecRenderer
    
    Called when the output format of the MediaCodec changes.
    The default implementation is a no-op.
    
    Overrides:
    
    onOutputFormatChanged in class MediaCodecRenderer
    
    Parameters:
    
    codec - The MediaCodec instance.
    
    outputFormat - The new output format.
  - processOutputBuffer
```
protected boolean processOutputBuffer(long positionUs,
                                      long elapsedRealtimeUs,
                                      MediaCodec codec,
                                      ByteBuffer buffer,
                                      int bufferIndex,
                                      int bufferFlags,
                                      long bufferPresentationTimeUs,
                                      boolean shouldSkip,
                                      Format format)
                               throws ExoPlaybackException
```
    Description copied from class: MediaCodecRenderer
    
    Processes an output media buffer.
    When a new ByteBuffer is passed to this method its position and limit delineate the data to be processed. The return value indicates whether the buffer was processed in full. If true is returned then the next call to this method will receive a new buffer to be processed. If false is returned then the same buffer will be passed to the next call. An implementation of this method is free to modify the buffer and can assume that the buffer will not be externally modified between successive calls. Hence an implementation can, for example, modify the buffer's position to keep track of how much of the data it has processed.
    Note that the first call to this method following a call to MediaCodecRenderer.onPositionReset(long, boolean) will always receive a new ByteBuffer to be processed.
    
    Specified by:
    
    processOutputBuffer in class MediaCodecRenderer
    
    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.
    
    codec - The MediaCodec instance.
    
    buffer - The output buffer to process.
    
    bufferIndex - The index of the output buffer.
    
    bufferFlags - The flags attached to the output buffer.
    
    bufferPresentationTimeUs - The presentation time of the output buffer in microseconds.
    
    shouldSkip - Whether the buffer should be skipped (i.e. not rendered).
    
    format - The format associated with the buffer.
    
    Returns:
    
    Whether the output buffer was fully processed (e.g. rendered or skipped).
    
    Throws:
    
    ExoPlaybackException - If an error occurs processing the output buffer.
  - getOutputStreamOffsetUs
```
protected long getOutputStreamOffsetUs()
```
    Returns the offset that should be subtracted from bufferPresentationTimeUs in processOutputBuffer(long, long, MediaCodec, ByteBuffer, int, int, long, boolean, Format) to get the playback position with respect to the media.
  - onProcessedTunneledBuffer
```
protected void onProcessedTunneledBuffer(long presentationTimeUs)
```
    Called when a buffer was processed in tunneling mode.
  - onProcessedOutputBuffer
```
@CallSuper
protected void onProcessedOutputBuffer(long presentationTimeUs)
```
    Called when an output buffer is successfully processed.
    
    Overrides:
    
    onProcessedOutputBuffer in class MediaCodecRenderer
    
    Parameters:
    
    presentationTimeUs - The timestamp associated with the output buffer.
  - shouldDropOutputBuffer
```
protected boolean shouldDropOutputBuffer(long earlyUs,
                                         long elapsedRealtimeUs)
```
    Returns whether the buffer being processed should be dropped.
    
    Parameters:
    
    earlyUs - The time until the buffer should be presented in microseconds. A negative value indicates that the buffer is late.
    
    elapsedRealtimeUs - SystemClock.elapsedRealtime() in microseconds, measured at the start of the current iteration of the rendering loop.
  - shouldDropBuffersToKeyframe
```
protected boolean shouldDropBuffersToKeyframe(long earlyUs,
                                              long elapsedRealtimeUs)
```
    Returns whether to drop all buffers from the buffer being processed to the keyframe at or after the current playback position, if possible.
    
    Parameters:
    
    earlyUs - The time until the current buffer should be presented in microseconds. A negative value indicates that the buffer is late.
    
    elapsedRealtimeUs - SystemClock.elapsedRealtime() in microseconds, measured at the start of the current iteration of the rendering loop.
  - shouldForceRenderOutputBuffer
```
protected boolean shouldForceRenderOutputBuffer(long earlyUs,
                                                long elapsedSinceLastRenderUs)
```
    Returns whether to force rendering an output buffer.
    
    Parameters:
    
    earlyUs - The time until the current buffer should be presented in microseconds. A negative value indicates that the buffer is late.
    
    elapsedSinceLastRenderUs - The elapsed time since the last output buffer was rendered, in microseconds.
    
    Returns:
    
    Returns whether to force rendering an output buffer.
  - skipOutputBuffer
```
protected void skipOutputBuffer(MediaCodec codec,
                                int index,
                                long presentationTimeUs)
```
    Skips the output buffer with the specified index.
    
    Parameters:
    
    codec - The codec that owns the output buffer.
    
    index - The index of the output buffer to skip.
    
    presentationTimeUs - The presentation time of the output buffer, in microseconds.
  - dropOutputBuffer
```
protected void dropOutputBuffer(MediaCodec codec,
                                int index,
                                long presentationTimeUs)
```
    Drops the output buffer with the specified index.
    
    Parameters:
    
    codec - The codec that owns the output buffer.
    
    index - The index of the output buffer to drop.
    
    presentationTimeUs - The presentation time of the output buffer, in microseconds.
  - maybeDropBuffersToKeyframe
```
protected boolean maybeDropBuffersToKeyframe(MediaCodec codec,
                                             int index,
                                             long presentationTimeUs,
                                             long positionUs)
                                      throws ExoPlaybackException
```
    Drops frames from the current output buffer to the next keyframe at or before the playback position. If no such keyframe exists, as the playback position is inside the same group of pictures as the buffer being processed, returns false. Returns true otherwise.
    
    Parameters:
    
    codec - The codec that owns the output buffer.
    
    index - The index of the output buffer to drop.
    
    presentationTimeUs - The presentation time of the output buffer, in microseconds.
    
    positionUs - The current playback position, in microseconds.
    
    Returns:
    
    Whether any buffers were dropped.
    
    Throws:
    
    ExoPlaybackException - If an error occurs flushing the codec.
  - updateDroppedBufferCounters
```
protected void updateDroppedBufferCounters(int droppedBufferCount)
```
    Updates decoder counters to reflect that droppedBufferCount additional buffers were dropped.
    
    Parameters:
    
    droppedBufferCount - The number of additional dropped buffers.
  - renderOutputBuffer
```
protected void renderOutputBuffer(MediaCodec codec,
                                  int index,
                                  long presentationTimeUs)
```
    Renders the output buffer with the specified index. This method is only called if the platform API version of the device is less than 21.
    
    Parameters:
    
    codec - The codec that owns the output buffer.
    
    index - The index of the output buffer to drop.
    
    presentationTimeUs - The presentation time of the output buffer, in microseconds.
  - renderOutputBufferV21
```
protected void renderOutputBufferV21(MediaCodec codec,
                                     int index,
                                     long presentationTimeUs,
                                     long releaseTimeNs)
```
    Renders the output buffer with the specified index. This method is only called if the platform API version of the device is 21 or later.
    
    Parameters:
    
    codec - The codec that owns the output buffer.
    
    index - The index of the output buffer to drop.
    
    presentationTimeUs - The presentation time of the output buffer, in microseconds.
    
    releaseTimeNs - The wallclock time at which the frame should be displayed, in nanoseconds.
  - getMediaFormat
```
protected MediaFormat getMediaFormat(Format format,
                                     MediaCodecVideoRenderer.CodecMaxValues codecMaxValues,
                                     float codecOperatingRate,
                                     boolean deviceNeedsNoPostProcessWorkaround,
                                     int tunnelingAudioSessionId)
```
    Returns the framework MediaFormat that should be used to configure the decoder.
    
    Parameters:
    
    format - The format of media.
    
    codecMaxValues - Codec max values that should be used when configuring the decoder.
    
    codecOperatingRate - The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.
    
    deviceNeedsNoPostProcessWorkaround - Whether the device is known to do post processing by default that isn't compatible with ExoPlayer.
    
    tunnelingAudioSessionId - The audio session id to use for tunneling, or C.AUDIO_SESSION_ID_UNSET if tunneling should not be enabled.
    
    Returns:
    
    The framework MediaFormat that should be used to configure the decoder.
  - getCodecMaxValues
```
protected MediaCodecVideoRenderer.CodecMaxValues getCodecMaxValues(MediaCodecInfo codecInfo,
                                                                   Format format,
                                                                   Format[] streamFormats)
                                                            throws MediaCodecUtil.DecoderQueryException
```
    Returns MediaCodecVideoRenderer.CodecMaxValues suitable for configuring a codec for format in a way that will allow possible adaptation to other compatible formats in streamFormats.
    
    Parameters:
    
    codecInfo - Information about the MediaCodec being configured.
    
    format - The format for which the codec is being configured.
    
    streamFormats - The possible stream formats.
    
    Returns:
    
    Suitable MediaCodecVideoRenderer.CodecMaxValues.
    
    Throws:
    
    MediaCodecUtil.DecoderQueryException - If an error occurs querying codecInfo.
  - codecNeedsSetOutputSurfaceWorkaround
```
protected boolean codecNeedsSetOutputSurfaceWorkaround(String name)
```
    Returns whether the codec is known to implement MediaCodec.setOutputSurface(Surface) incorrectly.
    If true is returned then we fall back to releasing and re-instantiating the codec instead.
    
    Parameters:
    
    name - The name of the codec.
    
    Returns:
    
    True if the device is known to implement MediaCodec.setOutputSurface(Surface) incorrectly.

Class MediaCodecVideoRenderer

Nested Class Summary

Nested classes/interfaces inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Renderer

Field Summary

Fields inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer

Fields inherited from interface com.google.android.exoplayer2.Renderer

Fields inherited from interface com.google.android.exoplayer2.RendererCapabilities

Constructor Summary

Method Summary

Methods inherited from class com.google.android.exoplayer2.mediacodec.MediaCodecRenderer

Methods inherited from class com.google.android.exoplayer2.BaseRenderer

Methods inherited from class java.lang.Object

Constructor Detail

MediaCodecVideoRenderer

MediaCodecVideoRenderer

MediaCodecVideoRenderer

MediaCodecVideoRenderer

Method Detail

supportsFormat

onEnabled

onStreamChanged

onPositionReset

isReady

onStarted

onStopped

onDisabled

handleMessage

shouldInitCodec

getCodecNeedsEosPropagation

configureCodec

canKeepCodec

releaseCodec

flushCodec

getCodecOperatingRate

onCodecInitialized

onInputFormatChanged

onQueueInputBuffer

onOutputFormatChanged

processOutputBuffer

getOutputStreamOffsetUs

onProcessedTunneledBuffer

onProcessedOutputBuffer

shouldDropOutputBuffer

shouldDropBuffersToKeyframe

shouldForceRenderOutputBuffer

skipOutputBuffer

dropOutputBuffer

maybeDropBuffersToKeyframe

updateDroppedBufferCounters

renderOutputBuffer

renderOutputBufferV21

getMediaFormat

getCodecMaxValues

codecNeedsSetOutputSurfaceWorkaround