# MediaCodecRenderer
Artifact: [androidx.media3:media3-exoplayer](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/exoplayer/mediacodec/MediaCodecRenderer.java+class:androidx.media3.exoplayer.mediacodec.MediaCodecRenderer)
*** ** * ** ***
```
@UnstableApi
public abstract class MediaCodecRenderer extends BaseRenderer
```
|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) |||
| ↳ | [androidx.media3.exoplayer.BaseRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer) ||
| | ↳ | [androidx.media3.exoplayer.mediacodec.MediaCodecRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer) |
Known direct subclasses [MediaCodecAudioRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/audio/MediaCodecAudioRenderer), [MediaCodecVideoRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoRenderer)
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/audio/MediaCodecAudioRenderer` | Decodes and renders audio using `https://developer.android.com/reference/android/media/MediaCodec.html` and an `https://developer.android.com/reference/androidx/media3/exoplayer/audio/AudioSink`. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` | Decodes and renders video using `https://developer.android.com/reference/android/media/MediaCodec.html`. |
Known indirect subclasses [CapturingRenderersFactory.CapturingMediaCodecVideoRenderer](https://developer.android.com/reference/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.CapturingMediaCodecVideoRenderer)
|---|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.CapturingMediaCodecVideoRenderer` | A `https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` that will not skip or drop buffers due to slow processing. |
*** ** * ** ***
An abstract renderer that uses `https://developer.android.com/reference/android/media/MediaCodec.html` to decode samples for rendering.
## Summary
| ### Nested types |
|---|
| `public class https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer.DecoderInitializationException extends https://developer.android.com/reference/java/lang/Exception.html` Thrown when a failure occurs instantiating a decoder. |
| ### Constants |
|---|---|
| `static final float` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#CODEC_OPERATING_RATE_UNSET() = -1.0f` Indicates no codec operating rate should be set. |
| `static final boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#DEBUG_LOG_ENABLED() = false` Compile-time flag to enable detailed logging for codec interactions. |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#DEBUG_LOG_TAG() = "MCRdebug"` Logging tag that should be used for all `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#DEBUG_LOG_ENABLED()` logs. |
| ### Protected fields |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#codec()` |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#codecInfo()` |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#codecInputFormat()` |
| `float` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#codecOperatingRate()` |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaFormat.html` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#codecOutputMediaFormat()` |
| `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderCounters` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#decoderCounters()` |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#largestQueuedPresentationTimeUs()` |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#lastProcessedOutputBufferTimeUs()` |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#skippedFlushOffsetUs()` |
| `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html https://developer.android.com/reference/androidx/media3/exoplayer/Renderer.WakeupListener` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#wakeupListener()` |
| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#MediaCodecRenderer(android.content.Context,int,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter.Factory,androidx.media3.exoplayer.mediacodec.MediaCodecSelector,boolean,float)( https://developer.android.com/reference/android/content/Context.html context, @https://developer.android.com/reference/androidx/media3/common/C.TrackType int trackType, https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Factory codecAdapterFactory, https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector, boolean enableDecoderFallback, float assumedMinimumCodecOperatingRate )` |
| ### Public methods |
|---|---|
| `final long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getDurationToProgressUs(long,long)(long positionUs, long elapsedRealtimeUs)` Returns minimum amount of playback clock time that must pass from `elapsedRealtimeUs` in order for the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#render(long,long)` call to make progress. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#handleMessage(int,java.lang.Object)( @https://developer.android.com/reference/androidx/media3/exoplayer/Renderer.MessageType int messageType, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html message )` Handles a message delivered to the target. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#isEnded()()` Whether the renderer is ready for the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` instance to transition to `https://developer.android.com/reference/androidx/media3/common/Player#STATE_ENDED()`. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#isReady()()` Whether the renderer is able to immediately render media from the current position. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)(long positionUs, long elapsedRealtimeUs)` Incrementally renders the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setPlaybackSpeed(float,float)(float currentPlaybackSpeed, float targetPlaybackSpeed)` Indicates the playback speed to this renderer. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setRenderTimeLimitMs(long)(long renderTimeLimitMs)` Sets a limit on the time a single `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` call can spend draining and filling the decoder. |
| `final int` | `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#supportsFormat(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Returns the extent to which the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` supports a given format. |
| `final int` | `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#supportsMixedMimeTypeAdaptation()()` Returns the extent to which the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` supports adapting between supported formats that have different MIME types. |
| ### Protected methods |
|---|---|
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#applyCodecParametersToMediaFormat(android.media.MediaFormat)(https://developer.android.com/reference/android/media/MediaFormat.html mediaFormat)` Applies the currently active `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters` to the given `https://developer.android.com/reference/android/media/MediaFormat.html`. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderReuseEvaluation` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#canReuseCodec(androidx.media3.exoplayer.mediacodec.MediaCodecInfo,androidx.media3.common.Format,androidx.media3.common.Format,boolean)( https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo, https://developer.android.com/reference/androidx/media3/common/Format oldFormat, https://developer.android.com/reference/androidx/media3/common/Format newFormat, boolean isAdaptiveFormatChange )` Evaluates whether the existing `https://developer.android.com/reference/android/media/MediaCodec.html` can be kept for a new `https://developer.android.com/reference/androidx/media3/common/Format`, and if it can, whether it requires reconfiguration. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecDecoderException` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#createDecoderException(java.lang.Throwable,androidx.media3.exoplayer.mediacodec.MediaCodecInfo)( https://developer.android.com/reference/java/lang/Throwable.html cause, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo )` |
| `final boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#flushOrReinitializeCodec()()` Flushes the codec. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodec()()` |
| `int` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecBufferFlags(androidx.media3.decoder.DecoderInputBuffer)(https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer)` Returns the flags that should be set on `https://developer.android.com/reference/android/media/MediaCodec.html#queueInputBuffer(int, int, int, long, int)` or `https://developer.android.com/reference/android/media/MediaCodec.html#queueSecureInputBuffer(int, int, android.media.MediaCodec.CryptoInfo, long, int)` for this buffer. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecInfo()()` |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecInputFormat()()` |
| `float` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecOperatingRate()()` Returns the operating rate used by the current codec |
| `float` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecOperatingRateV23(float,androidx.media3.common.Format,androidx.media3.common.Format[])( float targetPlaybackSpeed, https://developer.android.com/reference/androidx/media3/common/Format format, Format[] streamFormats )` Returns the `https://developer.android.com/reference/android/media/MediaFormat.html#KEY_OPERATING_RATE` value for a given playback speed, current `https://developer.android.com/reference/androidx/media3/common/Format` and set of possible stream formats. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaFormat.html` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getCodecOutputMediaFormat()()` |
| `abstract https://developer.android.com/reference/java/util/List.html` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getDecoderInfos(androidx.media3.exoplayer.mediacodec.MediaCodecSelector,androidx.media3.common.Format,boolean)( https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector, https://developer.android.com/reference/androidx/media3/common/Format format, boolean requiresSecureDecoder )` Returns a list of decoders that can decode media in the specified format, in priority order. |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getDurationToProgressUs(long,long,boolean)( long positionUs, long elapsedRealtimeUs, boolean isOnBufferAvailableListenerRegistered )` Returns minimum time playback must advance in order for the `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` call to make progress. |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getLargestQueuedPresentationTimeUs()()` Returns the largest presentation time of a buffer queued to the decoder. |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getLastBufferInStreamPresentationTimeUs()()` Returns the presentation time of the last buffer in the stream. |
| `final long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getLastProcessedOutputBufferTimeUs()()` Returns the presentation time of the last output buffer processed. |
| `abstract https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getMediaCodecConfiguration(androidx.media3.exoplayer.mediacodec.MediaCodecInfo,androidx.media3.common.Format,android.media.MediaCrypto,float)( https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo, https://developer.android.com/reference/androidx/media3/common/Format format, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaCrypto.html crypto, float codecOperatingRate )` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration` that will be used to create and configure a `https://developer.android.com/reference/android/media/MediaCodec.html` to decode the given `https://developer.android.com/reference/androidx/media3/common/Format` for a playback. |
| `final long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getOutputStreamOffsetUs()()` Returns the offset that should be subtracted from `bufferPresentationTimeUs` in `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#processOutputBuffer(long,long,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter,java.nio.ByteBuffer,int,int,int,long,boolean,boolean,androidx.media3.common.Format)` to get the playback position with respect to the media. |
| `final long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getOutputStreamStartPositionUs()()` Returns the start position of the current output stream in microseconds. |
| `float` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getPlaybackSpeed()()` Returns the current playback speed, as set by `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setPlaybackSpeed(float,float)`. |
| `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getSkippedFlushOffsetUs()()` Returns the offset added to buffer timestamps prior to decoding. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/Renderer.WakeupListener` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#getWakeupListener()()` Returns listener used to signal that `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` should be called. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#handleInputBufferSupplementalData(androidx.media3.decoder.DecoderInputBuffer)(https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer)` Handles supplemental data associated with an input buffer. |
| `final boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#isBypassEnabled()()` Returns whether bypass is enabled by the renderer. |
| `final boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#isBypassPossible(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Returns whether buffers in the input format can be processed without a codec. |
| `final boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#isReadyForDecoding()()` Returns whether the renderer is ready to start or continue decoding. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#maybeInitCodecOrBypass()()` |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#maybeInitializeProcessingPipeline(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Initializes the processing pipeline, if needed by the implementation. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onCodecError(java.lang.Exception)(https://developer.android.com/reference/java/lang/Exception.html codecError)` Called when a codec error has occurred. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onCodecInitialized(java.lang.String,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter.Configuration,long,long)( https://developer.android.com/reference/java/lang/String.html name, https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration configuration, long initializedTimestampMs, long initializationDurationMs )` Called when a `https://developer.android.com/reference/android/media/MediaCodec.html` has been created and configured. |
| `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onCodecParametersChanged(androidx.media3.exoplayer.CodecParameters)(https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters)` Called when one or more of the subscribed codec parameters have changed. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onCodecReleased(java.lang.String)(https://developer.android.com/reference/java/lang/String.html name)` Called when a `https://developer.android.com/reference/android/media/MediaCodec.html` has been released. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onDisabled()()` Called when the renderer is disabled. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onEnabled(boolean,boolean)(boolean joining, boolean mayRenderStartOfStream)` Called when the renderer is enabled. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/DecoderReuseEvaluation` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onInputFormatChanged(androidx.media3.exoplayer.FormatHolder)(https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder formatHolder)` Called when a new `https://developer.android.com/reference/androidx/media3/common/Format` is read from the upstream `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod`. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onOutputFormatChanged(androidx.media3.common.Format,android.media.MediaFormat)(https://developer.android.com/reference/androidx/media3/common/Format format, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaFormat.html mediaFormat)` Called when one of the output formats changes. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onOutputStreamOffsetUsChanged(long)(long outputStreamOffsetUs)` Called after the output stream offset changes. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onPositionReset(long,boolean,boolean)( long positionUs, boolean joining, boolean sampleStreamIsResetToKeyFrame )` Called when the position is reset. |
| `void` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onProcessedOutputBuffer(long)(long presentationTimeUs)` Called when an output buffer is successfully processed. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onProcessedStreamChange()()` Called after the last output buffer before a stream change has been processed. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onQueueInputBuffer(androidx.media3.decoder.DecoderInputBuffer)(https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer)` Called immediately before an input buffer is queued into the codec. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onReset()()` Called when the renderer is reset. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onStarted()()` Called when the renderer is started. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onStopped()()` Called when the renderer is stopped. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onStreamChanged(androidx.media3.common.Format[],long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)( Format[] formats, long startPositionUs, long offsetUs, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId )` Called when the renderer's stream has changed. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onTimelineChanged(androidx.media3.common.Timeline)(https://developer.android.com/reference/androidx/media3/common/Timeline timeline)` Called when a new timeline is `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#setTimeline(androidx.media3.common.Timeline)`. |
| `abstract boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#processOutputBuffer(long,long,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter,java.nio.ByteBuffer,int,int,int,long,boolean,boolean,androidx.media3.common.Format)( long positionUs, long elapsedRealtimeUs, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter codec, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/nio/ByteBuffer.html buffer, int bufferIndex, int bufferFlags, int sampleCount, long bufferPresentationTimeUs, boolean isDecodeOnlyBuffer, boolean isLastBuffer, https://developer.android.com/reference/androidx/media3/common/Format format )` Processes an output media buffer. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#releaseCodec()()` |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#renderToEndOfStream()()` Incrementally renders any remaining output. |
| `void` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#resetCodecStateForFlush()()` Resets the renderer internal state after a codec flush. |
| `void` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#resetCodecStateForRelease()()` Resets the renderer internal state after a codec release. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setPendingOutputEndOfStream()()` Notifies the renderer that output end of stream is pending and should be handled on the next render. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setPendingPlaybackException(androidx.media3.exoplayer.ExoPlaybackException)(https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException exception)` Sets an exception to be re-thrown by render. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldDiscardDecoderInputBuffer(androidx.media3.decoder.DecoderInputBuffer)(https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer)` Returns whether the input buffer should be discarded before decoding. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldFlushCodec()()` Returns whether the codec should be flushed in cases such that the codec was not released. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldInitCodec(androidx.media3.exoplayer.mediacodec.MediaCodecInfo)(https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo)` |
| `boolean` | `@https://developer.android.com/reference/androidx/media3/common/util/ExperimentalApi https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldProcessStreamChangeAtStart()()` Returns whether `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onProcessedStreamChange()` should be invoked on the first stream. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldReinitCodec()()` Returns whether the renderer needs to re-initialize the codec, possibly as a result of a change in device capabilities. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldReleaseCodecInsteadOfFlushing()()` Returns whether the codec should be released rather than flushed. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldSkipDecoderInputBuffer(androidx.media3.decoder.DecoderInputBuffer)(https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer)` Returns whether the input buffer should be skipped before the decoder. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#shouldUseBypass(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Returns whether buffers in the input format can be processed without a codec. |
| `abstract int` | `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#supportsFormat(androidx.media3.exoplayer.mediacodec.MediaCodecSelector,androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector, https://developer.android.com/reference/androidx/media3/common/Format format)` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` for the given `https://developer.android.com/reference/androidx/media3/common/Format`. |
| `static boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#supportsFormatDrm(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Returns whether this renderer supports the given `https://developer.android.com/reference/androidx/media3/common/Format` DRM scheme. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#updateCodecOperatingRate()()` Updates the codec operating rate. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#updateOutputFormatForTime(long)(long presentationTimeUs)` Updates the output formats for the specified output buffer timestamp, calling `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onOutputFormatChanged(androidx.media3.common.Format,android.media.MediaFormat)` if a change has occurred. |
### Inherited Constants
From [androidx.media3.exoplayer.Renderer](https://developer.android.com/reference/androidx/media3/exoplayer/Renderer) `static final long` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#DEFAULT_DURATION_TO_PROGRESS_US() = 10000`
Default minimum duration that the playback clock must advance before `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#render(long,long)` can make progress.
`static final long` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#DEFAULT_IDLE_DURATION_TO_PROGRESS_US() = 1000000`
Default duration to progress reported if the renderer does not need calls to `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#render(long,long)` to progress, if it's in `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()` and already `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#isReady()` or `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#isEnded()`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_CUSTOM_BASE() = 10000`
Applications or extensions may define custom `MSG_*` constants that can be passed to renderers.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_AUDIO_ATTRIBUTES() = 3`
A type of a message that can be passed to an audio renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_AUDIO_OUTPUT_PROVIDER() = 20`
The type of a message that can be passed to audio renderers via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_AUDIO_SESSION_ID() = 10`
The type of a message that can be passed to audio and video renderers via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_AUX_EFFECT_INFO() = 6`
A type of a message that can be passed to an audio renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_CAMERA_MOTION_LISTENER() = 8`
The type of a message that can be passed to a camera motion renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_CHANGE_FRAME_RATE_STRATEGY() = 5`
The type of a message that can be passed to a video renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_CODEC_PARAMETERS() = 21`
The type of a message that can be passed to renderers via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_IMAGE_METADATA_LISTENER() = 23`
The type of a message that can be passed to an image renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_IMAGE_OUTPUT() = 15`
The type of message that can be passed to an image renderer to set a desired image output.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_PREFERRED_AUDIO_DEVICE() = 12`
The type of a message that can be passed to audio renderers via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_PRIORITY() = 16`
The type of message that can be passed to a renderer to set its priority.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_SCALING_MODE() = 4`
The type of a message that can be passed to a `https://developer.android.com/reference/android/media/MediaCodec.html`-based video renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_SCRUBBING_MODE() = 18`
The type of message that can be passed to a renderer to direct it to enable or disable scrubbing mode.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_SKIP_SILENCE_ENABLED() = 9`
The type of a message that can be passed to an audio renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_SUBSCRIBED_CODEC_PARAMETER_KEYS() = 22`
A message to set the keys for which a renderer should report parameter changes.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIDEO_EFFECTS() = 13`
The type of a message that can be passed to a video renderer.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIDEO_FRAME_METADATA_LISTENER() = 7`
The type of a message that can be passed to a video renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIDEO_OUTPUT() = 1`
The type of a message that can be passed to a video renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIDEO_OUTPUT_RESOLUTION() = 14`
The type of a message that can be passed to a video renderer to set the desired output resolution.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VIRTUAL_DEVICE_ID() = 19`
The type of a message that can be passed to audio renderers via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_VOLUME() = 2`
A type of a message that can be passed to an audio renderer via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_SET_WAKEUP_LISTENER() = 11`
The type of a message that can be passed to a `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` via `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer#createMessage(androidx.media3.exoplayer.PlayerMessage.Target)`, to inform the renderer that it can schedule waking up another component.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#MSG_TRANSFER_RESOURCES() = 17`
The type of message that can be passed to a renderer to direct it to transfer relevant resources to another renderer.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_DISABLED() = 0`
The renderer is disabled.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED() = 1`
The renderer is enabled but not started.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED() = 2`
The renderer is started.
From [androidx.media3.exoplayer.RendererCapabilities](https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities) `static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#ADAPTIVE_NOT_SEAMLESS() = 8`
The `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` can adapt between formats, but may suffer a brief discontinuity (\~50-100ms) when adaptation occurs.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#ADAPTIVE_NOT_SUPPORTED() = 0`
The `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` does not support adaptation between formats.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#ADAPTIVE_SEAMLESS() = 16`
The `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` can seamlessly adapt between formats.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#ADAPTIVE_SUPPORT_MASK() = 24`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport` only.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#AUDIO_OFFLOAD_GAPLESS_SUPPORTED() = 1024`
The renderer supports audio offload and gapless transitions with this format.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#AUDIO_OFFLOAD_NOT_SUPPORTED() = 0`
Audio offload is not supported with this format.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#AUDIO_OFFLOAD_SPEED_CHANGE_SUPPORTED() = 2048`
The renderer supports audio offload and speed changes with this format.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#AUDIO_OFFLOAD_SUPPORTED() = 512`
The renderer supports audio offload with this format.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#AUDIO_OFFLOAD_SUPPORT_MASK() = 3584`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport` only.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#DECODER_SUPPORT_FALLBACK() = 0`
The format exceeds the primary decoder's capabilities but is supported by fallback decoder
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#DECODER_SUPPORT_FALLBACK_MIMETYPE() = 256`
The format's MIME type is unsupported and the renderer may use a decoder for a fallback MIME type.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#DECODER_SUPPORT_MASK() = 384`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport` only.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#DECODER_SUPPORT_PRIMARY() = 128`
The renderer is able to use the primary decoder for the format's MIME type.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#FORMAT_SUPPORT_MASK() = 7`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain the `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport` only.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#HARDWARE_ACCELERATION_NOT_SUPPORTED() = 0`
The renderer is not able to use hardware acceleration.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#HARDWARE_ACCELERATION_SUPPORTED() = 64`
The renderer is able to use hardware acceleration.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#HARDWARE_ACCELERATION_SUPPORT_MASK() = 64`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport` only.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#TUNNELING_NOT_SUPPORTED() = 0`
The `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` does not support tunneled output.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#TUNNELING_SUPPORTED() = 32`
The `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` supports tunneled output.
`static final int` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#TUNNELING_SUPPORT_MASK() = 32`
A mask to apply to `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` to obtain `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport` only.
### Inherited fields
From [androidx.media3.exoplayer.BaseRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer) `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html https://developer.android.com/reference/androidx/media3/common/util/Clock` `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html
https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#clock()` `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/RendererConfiguration` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#configuration()` `final https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#formatHolder()` `int` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#index()` `long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#lastResetPositionUs()` `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#mediaPeriodId()` `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html https://developer.android.com/reference/androidx/media3/exoplayer/analytics/PlayerId` `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/MonotonicNonNull.html
https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#playerId()` `long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#readingPositionUs()` `int` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#state()` `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#stream()` `long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#streamEndPositionUs()` `@https://developer.android.com/reference/androidx/annotation/Nullable Format[]` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#streamFormats()` `long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#streamOffsetUs()` `https://developer.android.com/reference/androidx/media3/common/Timeline` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#timeline()` `final int` `@https://developer.android.com/reference/androidx/media3/common/C.TrackType
https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#trackType()`
### Inherited methods
From [androidx.media3.exoplayer.BaseRenderer](https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer) `final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#clearListener()()`
Clears the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener`.
`final https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#createRendererException(java.lang.Throwable,androidx.media3.common.Format,int)(
https://developer.android.com/reference/java/lang/Throwable.html cause,
@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format format,
@https://developer.android.com/reference/androidx/media3/common/PlaybackException.ErrorCode int errorCode
)`
Creates an `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` of type `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException#TYPE_RENDERER()` for this renderer.
`final https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#createRendererException(java.lang.Throwable,androidx.media3.common.Format,boolean,int)(
https://developer.android.com/reference/java/lang/Throwable.html cause,
@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/Format format,
boolean isRecoverable,
@https://developer.android.com/reference/androidx/media3/common/PlaybackException.ErrorCode int errorCode
)`
Creates an `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` of type `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException#TYPE_RENDERER()` for this renderer.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#disable()()`
Disable the renderer, transitioning it to the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_DISABLED()` state.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#enable(androidx.media3.exoplayer.RendererConfiguration,androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,boolean,boolean,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)(
https://developer.android.com/reference/androidx/media3/exoplayer/RendererConfiguration configuration,
Format[] formats,
https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream stream,
long positionUs,
boolean joining,
boolean mayRenderStartOfStream,
long startPositionUs,
long offsetUs,
https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId
)`
Enables the renderer to consume from the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`.
`final https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getCapabilities()()`
Returns the capabilities of the renderer.
`final https://developer.android.com/reference/androidx/media3/common/util/Clock` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getClock()()`
Returns the `https://developer.android.com/reference/androidx/media3/common/util/Clock`.
`final https://developer.android.com/reference/androidx/media3/exoplayer/RendererConfiguration` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getConfiguration()()`
Returns the configuration set when the renderer was most recently enabled.
`final https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getFormatHolder()()`
Returns a clear `https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder`.
`final int` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getIndex()()`
Returns the index of the renderer within the player.
`final long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getLastResetPositionUs()()`
Returns the position passed to the most recent call to `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#enable(androidx.media3.exoplayer.RendererConfiguration,androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,boolean,boolean,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)` or `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#resetPosition(long,boolean)`.
`@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/MediaClock` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getMediaClock()()`
If the renderer advances its own playback position then this method returns a corresponding `https://developer.android.com/reference/androidx/media3/exoplayer/MediaClock`.
`final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getMediaPeriodId()()`
The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` of the `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod` producing the `stream`, or `null` if the renderer is disabled.
`final https://developer.android.com/reference/androidx/media3/exoplayer/analytics/PlayerId` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getPlayerId()()`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/analytics/PlayerId` of the player using this renderer.
`final long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getReadingPositionUs()()`
Returns the renderer time up to which the renderer has read samples, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if the renderer has read the current `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` to the end.
`final int` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getState()()`
Returns the current state of the renderer.
`final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getStream()()`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` being consumed, or null if the renderer is disabled.
`final long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getStreamEndPositionUs()()`
Returns the end position of the content or ad period producing the stream, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if unknown.
`final Format[]` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getStreamFormats()()`
Returns the formats of the currently enabled stream.
`final long` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getStreamOffsetUs()()`
Returns the offset added to timestamps of buffers read from the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`.
`final https://developer.android.com/reference/androidx/media3/common/Timeline` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getTimeline()()`
Returns the current `https://developer.android.com/reference/androidx/media3/common/Timeline` containing the rendered stream.
`final int` `@https://developer.android.com/reference/androidx/media3/common/C.TrackType
https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getTrackType()()`
Returns the track type that the renderer handles.
`final boolean` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#hasReadStreamToEnd()()`
Returns whether the renderer has read the current `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` to the end.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#init(int,androidx.media3.exoplayer.analytics.PlayerId,androidx.media3.common.util.Clock)(int index, https://developer.android.com/reference/androidx/media3/exoplayer/analytics/PlayerId playerId, https://developer.android.com/reference/androidx/media3/common/util/Clock clock)`
Initializes the renderer for playback with a player.
`final boolean` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#isCurrentStreamFinal()()`
Returns whether the current `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` will be the final one supplied before the renderer is next disabled or reset.
`final boolean` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#isSourceReady()()`
Returns whether the upstream source is ready.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#maybeThrowStreamError()()`
Throws an error that's preventing the renderer from reading from its `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`.
`void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#onInit()()`
Called when the renderer is initialized.
`void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#onRelease()()`
Called when the renderer is released.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#onRendererCapabilitiesChanged()()`
Called when the renderer capabilities are changed.
`final int` `@https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream.ReadDataResult
https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#readSource(androidx.media3.exoplayer.FormatHolder,androidx.media3.decoder.DecoderInputBuffer,int)(
https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder formatHolder,
https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer,
@https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream.ReadFlags int readFlags
)`
Reads from the enabled upstream source.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#release()()`
Releases the renderer.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#replaceStream(androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)(
Format[] formats,
https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream stream,
long startPositionUs,
long offsetUs,
https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId
)`
Replaces the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` from which samples will be consumed.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#reset()()`
Forces the renderer to give up any resources (e.g. media decoders) that it may be holding.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#resetPosition(long,boolean)(long positionUs, boolean sampleStreamIsResetToKeyFrame)`
Signals to the renderer that a position discontinuity has occurred.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#setCurrentStreamFinal()()`
Signals to the renderer that the current `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` will be the final one supplied before it is next disabled or reset.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#setListener(androidx.media3.exoplayer.RendererCapabilities.Listener)(https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener listener)`
Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener`.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#setTimeline(androidx.media3.common.Timeline)(https://developer.android.com/reference/androidx/media3/common/Timeline timeline)`
Sets the timeline that is currently being played.
`int` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#skipSource(long)(long positionUs)`
Attempts to skip to the keyframe before the specified position, or to the end of the stream if `positionUs` is beyond it.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#start()()`
Starts the renderer, meaning that calls to `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#render(long,long)` will cause media to be rendered.
`final void` `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#stop()()`
Stops the renderer, transitioning it to the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()` state.
From [androidx.media3.exoplayer.Renderer](https://developer.android.com/reference/androidx/media3/exoplayer/Renderer) `abstract void` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#enable(androidx.media3.exoplayer.RendererConfiguration,androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,boolean,boolean,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)(
https://developer.android.com/reference/androidx/media3/exoplayer/RendererConfiguration configuration,
Format[] formats,
https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream stream,
long positionUs,
boolean joining,
boolean mayRenderStartOfStream,
long startPositionUs,
long offsetUs,
https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId
)`
Enables the renderer to consume from the specified `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`.
`void` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#enableMayRenderStartOfStream()()`
Enables this renderer to render the start of the stream even if the state is not `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()` yet.
`abstract https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#getName()()`
Returns the name of this renderer, for logging and debugging purposes.
`abstract void` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#replaceStream(androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)(
Format[] formats,
https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream stream,
long startPositionUs,
long offsetUs,
https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId
)`
Replaces the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` from which samples will be consumed.
`boolean` `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#supportsResetPositionWithoutKeyFrameReset(long)(long positionUs)`
Returns whether the renderer can support processing a position discontinuity without a key frame reset.
From [androidx.media3.exoplayer.RendererCapabilities](https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities) `static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#create(int)(@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport int formatSupport)`
Returns `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` for the given `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#create(int,int,int)(
@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport int formatSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport int adaptiveSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport int tunnelingSupport
)`
Returns `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` combining the given `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport` and `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#create(int,int,int,int)(
@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport int formatSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport int adaptiveSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport int tunnelingSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport int audioOffloadSupport
)`
Returns `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` combining the given `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport`, and `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#create(int,int,int,int,int)(
@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport int formatSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport int adaptiveSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport int tunnelingSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport int hardwareAccelerationSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport int decoderSupport
)`
Returns `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` combining the given `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport`, and `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#create(int,int,int,int,int,int)(
@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport int formatSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport int adaptiveSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport int tunnelingSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport int hardwareAccelerationSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport int decoderSupport,
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport int audioOffloadSupport
)`
Returns `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` combining the given `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport`, `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport` and `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getAdaptiveSupport(int)(@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags)`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getAudioOffloadSupport(int)(
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags
)`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AudioOffloadSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getDecoderSupport(int)(@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags)`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.DecoderSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static int` `@https://developer.android.com/reference/androidx/media3/common/C.FormatSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getFormatSupport(int)(@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags)`
Returns the `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getHardwareAccelerationSupport(int)(
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags
)`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.HardwareAccelerationSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static int` `@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport
https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#getTunnelingSupport(int)(@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags)`
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.TunnelingSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities`.
`static boolean` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#isFormatSupported(int,boolean)(
@https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities int supportFlags,
boolean allowExceedsCapabilities
)`
Returns whether the `https://developer.android.com/reference/androidx/media3/common/C.FormatSupport` from the combined `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` indicates the format is supported.
`void` `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities#setListener(androidx.media3.exoplayer.RendererCapabilities.Listener)(https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener listener)`
Sets the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener`.
## Constants
### CODEC_OPERATING_RATE_UNSET
```
protected static final float CODEC_OPERATING_RATE_UNSET = -1.0f
```
Indicates no codec operating rate should be set.
### DEBUG_LOG_ENABLED
```
protected static final boolean DEBUG_LOG_ENABLED = false
```
Compile-time flag to enable detailed logging for codec interactions.
### DEBUG_LOG_TAG
```
protected static final String DEBUG_LOG_TAG = "MCRdebug"
```
Logging tag that should be used for all `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#DEBUG_LOG_ENABLED()` logs.
## Protected fields
### codec
```
protected @Nullable MediaCodecAdapter codec
```
### codecInfo
```
protected @Nullable MediaCodecInfo codecInfo
```
### codecInputFormat
```
protected @Nullable Format codecInputFormat
```
### codecOperatingRate
```
protected float codecOperatingRate
```
### codecOutputMediaFormat
```
protected @Nullable MediaFormat codecOutputMediaFormat
```
### decoderCounters
```
protected DecoderCounters decoderCounters
```
### largestQueuedPresentationTimeUs
```
protected long largestQueuedPresentationTimeUs
```
### lastProcessedOutputBufferTimeUs
```
protected long lastProcessedOutputBufferTimeUs
```
### skippedFlushOffsetUs
```
protected long skippedFlushOffsetUs
```
### wakeupListener
```
@MonotonicNonNull
protected @MonotonicNonNull Renderer.WakeupListener wakeupListener
```
## Public constructors
### MediaCodecRenderer
```
public MediaCodecRenderer(
Context context,
@C.TrackType int trackType,
MediaCodecAdapter.Factory codecAdapterFactory,
MediaCodecSelector mediaCodecSelector,
boolean enableDecoderFallback,
float assumedMinimumCodecOperatingRate
)
```
| Parameters |
|---|---|
| `https://developer.android.com/reference/android/content/Context.html context` | A context. |
| `@https://developer.android.com/reference/androidx/media3/common/C.TrackType int trackType` | The `https://developer.android.com/reference/androidx/media3/common/C.TrackType` that the renderer handles. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Factory codecAdapterFactory` | A factory for `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` instances. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector` | A decoder selector. |
| `boolean enableDecoderFallback` | Whether to enable fallback to lower-priority decoders if decoder initialization fails. This may result in using a decoder that is less efficient or slower than the primary decoder. |
| `float assumedMinimumCodecOperatingRate` | A codec operating rate that all codecs instantiated by this renderer are assumed to meet implicitly (i.e. without the operating rate being set explicitly using `https://developer.android.com/reference/android/media/MediaFormat.html#KEY_OPERATING_RATE`). |
## Public methods
### getDurationToProgressUs
```
public final long getDurationToProgressUs(long positionUs, long elapsedRealtimeUs)
```
Returns minimum amount of playback clock time that must pass from `elapsedRealtimeUs` in order for the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#render(long,long)` call to make progress.
This method may be called when the renderer is in the following states: `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()`, `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()`.
The default return time is `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#DEFAULT_DURATION_TO_PROGRESS_US()` if the renderer is in `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()`, or in `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()` and not yet `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#isReady()` or `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#isEnded()`. Otherwise, it returns `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#DEFAULT_IDLE_DURATION_TO_PROGRESS_US()`.
| Parameters |
|---|---|
| `long positionUs` | The current render position in microseconds, measured at the start of the current iteration of the rendering loop. |
| `long elapsedRealtimeUs` | `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()` in microseconds, measured at the start of the current iteration of the rendering loop. |
| Returns |
|---|---|
| `long` | Minimum amount of playback clock time that must pass before renderer is able to make progress. |
### handleMessage
```
public void handleMessage(
@Renderer.MessageType int messageType,
@Nullable Object message
)
```
Handles a message delivered to the target.
| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/media3/exoplayer/Renderer.MessageType int messageType` | The message type. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html message` | The message payload. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurred whilst handling the message. Should only be thrown by targets that handle messages on the playback thread. |
### isEnded
```
public boolean isEnded()
```
Whether the renderer is ready for the `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` instance to transition to `https://developer.android.com/reference/androidx/media3/common/Player#STATE_ENDED()`. The player will make this transition as soon as `true` is returned by all of its renderers.
This method may be called when the renderer is in the following states: `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()`, `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()`.
| Returns |
|---|---|
| `boolean` | Whether the renderer is ready for the player to transition to the ended state. |
### isReady
```
public boolean isReady()
```
Whether the renderer is able to immediately render media from the current position.
If the renderer is in the `https://developer.android.com/reference/androidx/media3/exoplayer/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 `https://developer.android.com/reference/androidx/media3/exoplayer/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: `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()`, `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()`.
| Returns |
|---|---|
| `boolean` | Whether the renderer is ready to render media. |
### render
```
public void render(long positionUs, long elapsedRealtimeUs)
```
Incrementally renders the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream`.
If the renderer is in the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()` state then each call to this method will do work toward being ready to render the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` when the renderer is started. If the renderer is in the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()` state then calls to this method will render the `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` in sync with the specified media positions.
The renderer may also render the very start of the media at the current position (e.g. the first frame of a video stream) while still in the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()` state, unless it's the initial start of the media after calling `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#enable(androidx.media3.exoplayer.RendererConfiguration,androidx.media3.common.Format[],androidx.media3.exoplayer.source.SampleStream,long,boolean,boolean,long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)` with `
mayRenderStartOfStream` set to `false`.
This method should return quickly, and should not block if the renderer is unable to make useful progress.
This method may be called when the renderer is in the following states: `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_ENABLED()`, `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()`.
| Parameters |
|---|---|
| `long positionUs` | The current media time in microseconds, measured at the start of the current iteration of the rendering loop. |
| `long elapsedRealtimeUs` | `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()` in microseconds, measured at the start of the current iteration of the rendering loop. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### setPlaybackSpeed
```
public void setPlaybackSpeed(float currentPlaybackSpeed, float targetPlaybackSpeed)
```
Indicates the playback speed to this renderer.
The default implementation is a no-op.
| Parameters |
|---|---|
| `float currentPlaybackSpeed` | The factor by which playback is currently sped up. |
| `float targetPlaybackSpeed` | The target factor by which playback should be sped up. This may be different from `currentPlaybackSpeed`, for example, if the speed is temporarily adjusted for live playback. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs handling the playback speed. |
### setRenderTimeLimitMs
```
public void setRenderTimeLimitMs(long renderTimeLimitMs)
```
Sets a limit on the time a single `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` call can spend draining and filling the decoder.
This method should be called right after creating an instance of this class.
| Parameters |
|---|---|
| `long renderTimeLimitMs` | The render time limit in milliseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` for no limit. |
### supportsFormat
```
@RendererCapabilities.Capabilities
public final int supportsFormat(Format format)
```
Returns the extent to which the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` supports a given format.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The format. |
| Returns |
|---|---|
| `int` | The `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` for this format. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### supportsMixedMimeTypeAdaptation
```
@RendererCapabilities.AdaptiveSupport
public final int supportsMixedMimeTypeAdaptation()
```
Returns the extent to which the `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer` supports adapting between supported formats that have different MIME types.
| Returns |
|---|---|
| `int` | The `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.AdaptiveSupport` for adapting between supported formats that have different MIME types. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
## Protected methods
### applyCodecParametersToMediaFormat
```
protected final void applyCodecParametersToMediaFormat(MediaFormat mediaFormat)
```
Applies the currently active `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters` to the given `https://developer.android.com/reference/android/media/MediaFormat.html`.
### canReuseCodec
```
protected DecoderReuseEvaluation canReuseCodec(
MediaCodecInfo codecInfo,
Format oldFormat,
Format newFormat,
boolean isAdaptiveFormatChange
)
```
Evaluates whether the existing `https://developer.android.com/reference/android/media/MediaCodec.html` can be kept for a new `https://developer.android.com/reference/androidx/media3/common/Format`, and if it can, whether it requires reconfiguration.
The default implementation does not allow decoder reuse.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo` | A `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo` describing the decoder. |
| `https://developer.android.com/reference/androidx/media3/common/Format oldFormat` | The `https://developer.android.com/reference/androidx/media3/common/Format` for which the existing instance is configured. |
| `https://developer.android.com/reference/androidx/media3/common/Format newFormat` | The new `https://developer.android.com/reference/androidx/media3/common/Format`. |
| `boolean isAdaptiveFormatChange` | Whether the format change happens within the same stream after having queued samples for `oldFormat`, typically indicating an adaptive format change. |
| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/DecoderReuseEvaluation` | The result of the evaluation. |
### createDecoderException
```
protected MediaCodecDecoderException createDecoderException(
Throwable cause,
@Nullable MediaCodecInfo codecInfo
)
```
### flushOrReinitializeCodec
```
protected final boolean flushOrReinitializeCodec()
```
Flushes the codec. If flushing is not possible, the codec will be released and re-instantiated. This method is a no-op if the codec is `null`.
The implementation of this method calls `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#flushOrReleaseCodec()`, and `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#maybeInitCodecOrBypass()` if the codec needs to be re-instantiated.
| Returns |
|---|---|
| `boolean` | Whether the codec was released and reinitialized, rather than being flushed. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs re-instantiating the codec. |
### getCodec
```
protected final @Nullable MediaCodecAdapter getCodec()
```
### getCodecBufferFlags
```
protected int getCodecBufferFlags(DecoderInputBuffer buffer)
```
Returns the flags that should be set on `https://developer.android.com/reference/android/media/MediaCodec.html#queueInputBuffer(int, int, int, long, int)` or `https://developer.android.com/reference/android/media/MediaCodec.html#queueSecureInputBuffer(int, int, android.media.MediaCodec.CryptoInfo, long, int)` for this buffer.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer` | The input buffer. |
| Returns |
|---|---|
| `int` | The flags to set on `https://developer.android.com/reference/android/media/MediaCodec.html#queueInputBuffer(int, int, int, long, int)` or `https://developer.android.com/reference/android/media/MediaCodec.html#queueSecureInputBuffer(int, int, android.media.MediaCodec.CryptoInfo, long, int)`. |
### getCodecInfo
```
protected final @Nullable MediaCodecInfo getCodecInfo()
```
### getCodecInputFormat
```
protected final @Nullable Format getCodecInputFormat()
```
### getCodecOperatingRate
```
protected float getCodecOperatingRate()
```
Returns the operating rate used by the current codec
### getCodecOperatingRateV23
```
protected float getCodecOperatingRateV23(
float targetPlaybackSpeed,
Format format,
Format[] streamFormats
)
```
Returns the `https://developer.android.com/reference/android/media/MediaFormat.html#KEY_OPERATING_RATE` value for a given playback speed, current `https://developer.android.com/reference/androidx/media3/common/Format` and set of possible stream formats.
The default implementation returns `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#CODEC_OPERATING_RATE_UNSET()`.
| Parameters |
|---|---|
| `float targetPlaybackSpeed` | The target factor by which playback should be sped up. This may be different from the current playback speed, for example, if the speed is temporarily adjusted for live playback. |
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format` for which the codec is being configured. |
| `Format[] streamFormats` | The possible stream formats. |
| Returns |
|---|---|
| `float` | The codec operating rate, or `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#CODEC_OPERATING_RATE_UNSET()` if no codec operating rate should be set. |
### getCodecOutputMediaFormat
```
protected final @Nullable MediaFormat getCodecOutputMediaFormat()
```
### getDecoderInfos
```
protected abstract List getDecoderInfos(
MediaCodecSelector mediaCodecSelector,
Format format,
boolean requiresSecureDecoder
)
```
Returns a list of decoders that can decode media in the specified format, in priority order.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector` | The decoder selector. |
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format` for which a decoder is required. |
| `boolean requiresSecureDecoder` | Whether a secure decoder is required. |
| Returns |
|---|---|
| `https://developer.android.com/reference/java/util/List.html` | A list of `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo`s corresponding to decoders. May be empty. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecUtil.DecoderQueryException` | Thrown if there was an error querying decoders. |
### getDurationToProgressUs
```
protected long getDurationToProgressUs(
long positionUs,
long elapsedRealtimeUs,
boolean isOnBufferAvailableListenerRegistered
)
```
Returns minimum time playback must advance in order for the `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` call to make progress.
If the `Renderer` has a registered `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.OnBufferAvailableListener`, then the `Renderer` will be notified when decoder input and output buffers become available. These callbacks may affect the calculated minimum time playback must advance before a `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` call can make progress.
| Parameters |
|---|---|
| `long positionUs` | The current media time in microseconds, measured at the start of the current iteration of the rendering loop. |
| `long elapsedRealtimeUs` | `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()` in microseconds, measured at the start of the current iteration of the rendering loop. |
| `boolean isOnBufferAvailableListenerRegistered` | Whether the `Renderer` is using a `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` with successfully registered `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.OnBufferAvailableListener`. |
| Returns |
|---|---|
| `long` | minimum time playback must advance before renderer is able to make progress. |
### getLargestQueuedPresentationTimeUs
```
protected long getLargestQueuedPresentationTimeUs()
```
Returns the largest presentation time of a buffer queued to the decoder.
If a buffer has not yet been queued to the decoder then the return value will be `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()`. The value is reset when the decoder is flushed or released.
| Returns |
|---|---|
| `long` | The largest presentation time of buffers queued to the decoder. |
### getLastBufferInStreamPresentationTimeUs
```
protected long getLastBufferInStreamPresentationTimeUs()
```
Returns the presentation time of the last buffer in the stream.
If the last buffer has not yet been read off the sample queue then the return value will be `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()`.
| Returns |
|---|---|
| `long` | The presentation time of the last buffer in the stream. |
### getLastProcessedOutputBufferTimeUs
```
protected final long getLastProcessedOutputBufferTimeUs()
```
Returns the presentation time of the last output buffer processed.
If an output buffer has not yet been processed then the return value will be `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()`.
| Returns |
|---|---|
| `long` | The presentation time of the last output buffer processed. |
### getMediaCodecConfiguration
```
protected abstract MediaCodecAdapter.Configuration getMediaCodecConfiguration(
MediaCodecInfo codecInfo,
Format format,
@Nullable MediaCrypto crypto,
float codecOperatingRate
)
```
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration` that will be used to create and configure a `https://developer.android.com/reference/android/media/MediaCodec.html` to decode the given `https://developer.android.com/reference/androidx/media3/common/Format` for a playback.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecInfo codecInfo` | Information about the `https://developer.android.com/reference/android/media/MediaCodec.html` being configured. |
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format` for which the codec is being configured. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaCrypto.html crypto` | For drm protected playbacks, a `https://developer.android.com/reference/android/media/MediaCrypto.html` to use for decryption. |
| `float codecOperatingRate` | The codec operating rate, or `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#CODEC_OPERATING_RATE_UNSET()` if no codec operating rate should be set. |
| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration` | The parameters needed to call `https://developer.android.com/reference/android/media/MediaCodec.html#configure(android.media.MediaFormat, android.view.Surface, android.media.MediaCrypto, int)`. |
### getOutputStreamOffsetUs
```
protected final long getOutputStreamOffsetUs()
```
Returns the offset that should be subtracted from `bufferPresentationTimeUs` in `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#processOutputBuffer(long,long,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter,java.nio.ByteBuffer,int,int,int,long,boolean,boolean,androidx.media3.common.Format)` to get the playback position with respect to the media.
### getOutputStreamStartPositionUs
```
protected final long getOutputStreamStartPositionUs()
```
Returns the start position of the current output stream in microseconds.
### getPlaybackSpeed
```
protected float getPlaybackSpeed()
```
Returns the current playback speed, as set by `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#setPlaybackSpeed(float,float)`.
### getSkippedFlushOffsetUs
```
protected long getSkippedFlushOffsetUs()
```
Returns the offset added to buffer timestamps prior to decoding.
The skippedFlushOffset ensures timestamps are greater than the current "largestQueuedTimestamp" when skipping flushing the codec during a seek.
### getWakeupListener
```
protected final @Nullable Renderer.WakeupListener getWakeupListener()
```
Returns listener used to signal that `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#render(long,long)` should be called.
### handleInputBufferSupplementalData
```
protected void handleInputBufferSupplementalData(DecoderInputBuffer buffer)
```
Handles supplemental data associated with an input buffer.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer` | The input buffer that is about to be queued. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | Thrown if an error occurs handling supplemental data. |
### isBypassEnabled
```
protected final boolean isBypassEnabled()
```
Returns whether bypass is enabled by the renderer.
### isBypassPossible
```
protected final boolean isBypassPossible(Format format)
```
Returns whether buffers in the input format can be processed without a codec.
This method returns the possibility of bypass mode with checking both the renderer capabilities and DRM protection.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The input `https://developer.android.com/reference/androidx/media3/common/Format`. |
| Returns |
|---|---|
| `boolean` | Whether playback bypassing `https://developer.android.com/reference/android/media/MediaCodec.html` is possible. |
### isReadyForDecoding
```
protected final boolean isReadyForDecoding()
```
Returns whether the renderer is ready to start or continue decoding.
### maybeInitCodecOrBypass
```
protected final void maybeInitCodecOrBypass()
```
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | |
### maybeInitializeProcessingPipeline
```
protected boolean maybeInitializeProcessingPipeline(Format format)
```
Initializes the processing pipeline, if needed by the implementation.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format` for which the codec is being configured. |
| Returns |
|---|---|
| `boolean` | Returns `true` when the processing pipeline is successfully initialized, or the `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer` does not use a processing pipeline. The caller should try again later, if `false` is returned. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs preparing for initializing the codec. |
### onCodecError
```
protected void onCodecError(Exception codecError)
```
Called when a codec error has occurred.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html codecError` | The error. |
### onCodecInitialized
```
protected void onCodecInitialized(
String name,
MediaCodecAdapter.Configuration configuration,
long initializedTimestampMs,
long initializationDurationMs
)
```
Called when a `https://developer.android.com/reference/android/media/MediaCodec.html` has been created and configured.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html name` | The name of the codec that was initialized. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration configuration` | The `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Configuration` used to configure the codec. |
| `long initializedTimestampMs` | `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()` when initialization finished. |
| `long initializationDurationMs` | The time taken to initialize the codec in milliseconds. |
### onCodecParametersChanged
```
protected abstract void onCodecParametersChanged(CodecParameters codecParameters)
```
Called when one or more of the subscribed codec parameters have changed.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters codecParameters` | A `https://developer.android.com/reference/androidx/media3/exoplayer/CodecParameters` instance containing the current values for the subscribed keys as reported by the underlying codec. |
### onCodecReleased
```
protected void onCodecReleased(String name)
```
Called when a `https://developer.android.com/reference/android/media/MediaCodec.html` has been released.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html name` | The name of the codec that was released. |
### onDisabled
```
protected void onDisabled()
```
Called when the renderer is disabled.
The default implementation is a no-op.
### onEnabled
```
protected void onEnabled(boolean joining, boolean mayRenderStartOfStream)
```
Called when the renderer is enabled.
The default implementation is a no-op.
| Parameters |
|---|---|
| `boolean joining` | Whether this renderer is being enabled to join an ongoing playback. |
| `boolean mayRenderStartOfStream` | Whether this renderer is allowed to render the start of the stream even if the state is not `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#STATE_STARTED()` yet. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### onInputFormatChanged
```
@CallSuper
protected @Nullable DecoderReuseEvaluation onInputFormatChanged(FormatHolder formatHolder)
```
Called when a new `https://developer.android.com/reference/androidx/media3/common/Format` is read from the upstream `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod`.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder formatHolder` | A `https://developer.android.com/reference/androidx/media3/exoplayer/FormatHolder` that holds the new `https://developer.android.com/reference/androidx/media3/common/Format`. |
| Returns |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/DecoderReuseEvaluation` | The result of the evaluation to determine whether the existing decoder instance can be reused for the new format, or `null` if the renderer did not have a decoder. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs re-initializing the `https://developer.android.com/reference/android/media/MediaCodec.html`. |
### onOutputFormatChanged
```
protected void onOutputFormatChanged(Format format, @Nullable MediaFormat mediaFormat)
```
Called when one of the output formats changes.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The input `https://developer.android.com/reference/androidx/media3/common/Format` to which future output now corresponds. If the renderer is in bypass mode, this is also the output format. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/media/MediaFormat.html mediaFormat` | The codec output `https://developer.android.com/reference/android/media/MediaFormat.html`, or `null` if the renderer is in bypass mode. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | Thrown if an error occurs configuring the output. |
### onOutputStreamOffsetUsChanged
```
protected void onOutputStreamOffsetUsChanged(long outputStreamOffsetUs)
```
Called after the output stream offset changes.
The default implementation is a no-op.
| Parameters |
|---|---|
| `long outputStreamOffsetUs` | The output stream offset in microseconds. |
### onPositionReset
```
protected void onPositionReset(
long positionUs,
boolean joining,
boolean sampleStreamIsResetToKeyFrame
)
```
Called when the position is reset. This occurs when the renderer is enabled after `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#onStreamChanged(androidx.media3.common.Format[],long,long,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)` has been called, and also when a position discontinuity is encountered.
After a position reset, the renderer's `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` is guaranteed to provide samples starting from a key frame if `sampleStreamIsResetToKeyFrame` is `true`. `
sampleStreamIsResetToKeyFrame` is guaranteed to be `true` unless the implementation overrides `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer#supportsResetPositionWithoutKeyFrameReset(long)` to return `
true`.
The default implementation is a no-op.
| Parameters |
|---|---|
| `long positionUs` | The new playback position in microseconds. |
| `boolean joining` | Whether this renderer is being enabled to join an ongoing playback. |
| `boolean sampleStreamIsResetToKeyFrame` | Whether the renderer's `https://developer.android.com/reference/androidx/media3/exoplayer/source/SampleStream` is guaranteed to provide samples starting from a key frame. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### onProcessedOutputBuffer
```
@CallSuper
protected void onProcessedOutputBuffer(long presentationTimeUs)
```
Called when an output buffer is successfully processed.
| Parameters |
|---|---|
| `long presentationTimeUs` | The timestamp associated with the output buffer. |
### onProcessedStreamChange
```
protected void onProcessedStreamChange()
```
Called after the last output buffer before a stream change has been processed.
### onQueueInputBuffer
```
protected void onQueueInputBuffer(DecoderInputBuffer buffer)
```
Called immediately before an input buffer is queued into the codec.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer` | The buffer to be queued. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | Thrown if an error occurs handling the input buffer. |
### onReset
```
protected void onReset()
```
Called when the renderer is reset.
The default implementation is a no-op.
### onStarted
```
protected void onStarted()
```
Called when the renderer is started.
The default implementation is a no-op.
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### onStopped
```
protected void onStopped()
```
Called when the renderer is stopped.
The default implementation is a no-op.
### onStreamChanged
```
protected void onStreamChanged(
Format[] formats,
long startPositionUs,
long offsetUs,
MediaSource.MediaPeriodId mediaPeriodId
)
```
Called when the renderer's stream has changed. This occurs when the renderer is enabled after `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#onEnabled(boolean,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.
| Parameters |
|---|---|
| `Format[] formats` | The enabled formats. |
| `long startPositionUs` | The start position of the new stream in renderer time (microseconds). |
| `long offsetUs` | The offset that will be added to the timestamps of buffers read via `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#readSource(androidx.media3.exoplayer.FormatHolder,androidx.media3.decoder.DecoderInputBuffer,int)` so that decoder input buffers have monotonically increasing timestamps. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId mediaPeriodId` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` of the `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod` that produces the stream. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs. |
### onTimelineChanged
```
protected void onTimelineChanged(Timeline timeline)
```
Called when a new timeline is `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#setTimeline(androidx.media3.common.Timeline)`.
The default implementation is a no-op.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Timeline timeline` | The new timeline, which can also be obtained from `https://developer.android.com/reference/androidx/media3/exoplayer/BaseRenderer#getTimeline()`. |
### processOutputBuffer
```
protected abstract boolean processOutputBuffer(
long positionUs,
long elapsedRealtimeUs,
@Nullable MediaCodecAdapter codec,
@Nullable ByteBuffer buffer,
int bufferIndex,
int bufferFlags,
int sampleCount,
long bufferPresentationTimeUs,
boolean isDecodeOnlyBuffer,
boolean isLastBuffer,
Format format
)
```
Processes an output media buffer.
When a new `https://developer.android.com/reference/java/nio/ByteBuffer.html` 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 `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onPositionReset(long,boolean,boolean)` will always receive a new `https://developer.android.com/reference/java/nio/ByteBuffer.html` to be processed.
| Parameters |
|---|---|
| `long positionUs` | The current media time in microseconds, measured at the start of the current iteration of the rendering loop. |
| `long elapsedRealtimeUs` | `https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime()` in microseconds, measured at the start of the current iteration of the rendering loop. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter codec` | The `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` instance, or null in bypass mode were no codec is used. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/nio/ByteBuffer.html buffer` | The output buffer to process, or null if the buffer data is not made available to the application layer (see `https://developer.android.com/reference/android/media/MediaCodec.html#getOutputBuffer(int)`). This `buffer` can only be null for video data. Note that the buffer data can still be rendered in this case by using the `bufferIndex`. |
| `int bufferIndex` | The index of the output buffer. |
| `int bufferFlags` | The flags attached to the output buffer. |
| `int sampleCount` | The number of samples extracted from the sample queue in the buffer. This allows handling multiple samples as a batch for efficiency. |
| `long bufferPresentationTimeUs` | The presentation time of the output buffer in microseconds. |
| `boolean isDecodeOnlyBuffer` | Whether the buffer timestamp is less than the intended playback start position. |
| `boolean isLastBuffer` | Whether the buffer is known to contain the last sample of the current stream. This flag is set on a best effort basis, and any logic relying on it should degrade gracefully to handle cases where it's not set. |
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format` associated with the buffer. |
| Returns |
|---|---|
| `boolean` | Whether the output buffer was fully processed (for example, rendered or skipped). |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs processing the output buffer. |
### releaseCodec
```
protected void releaseCodec()
```
### renderToEndOfStream
```
protected void renderToEndOfStream()
```
Incrementally renders any remaining output.
The default implementation is a no-op.
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | Thrown if an error occurs rendering remaining output. |
### resetCodecStateForFlush
```
@CallSuper
protected void resetCodecStateForFlush()
```
Resets the renderer internal state after a codec flush.
### resetCodecStateForRelease
```
@CallSuper
protected void resetCodecStateForRelease()
```
Resets the renderer internal state after a codec release.
Note that this only needs to reset state variables that are changed in addition to those already changed in `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#resetCodecStateForFlush()`.
### setPendingOutputEndOfStream
```
protected final void setPendingOutputEndOfStream()
```
Notifies the renderer that output end of stream is pending and should be handled on the next render.
### setPendingPlaybackException
```
protected final void setPendingPlaybackException(ExoPlaybackException exception)
```
Sets an exception to be re-thrown by render.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException exception` | The exception. |
### shouldDiscardDecoderInputBuffer
```
protected boolean shouldDiscardDecoderInputBuffer(DecoderInputBuffer buffer)
```
Returns whether the input buffer should be discarded before decoding.
Implement this method to to skip decoding of buffers that are not needed during a seek, or to drop input buffers that cannot be rendered on time. See `https://developer.android.com/reference/androidx/media3/common/C#BUFFER_FLAG_NOT_DEPENDED_ON()`.
Subclasses that implement this method are responsible for updating `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#decoderCounters()`. For codecs with out-of-order buffers, consecutive dropped input buffers may have to be counted after frame reordering. For example, in `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#processOutputBuffer(long,long,androidx.media3.exoplayer.mediacodec.MediaCodecAdapter,java.nio.ByteBuffer,int,int,int,long,boolean,boolean,androidx.media3.common.Format)`.
Implementations of this method must update the `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer#data()`. Data that is only used for output at the current `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer#timeUs()` should be removed. Data that is referenced by later input buffers should remain in the current buffer.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer` | The input buffer. |
### shouldFlushCodec
```
protected boolean shouldFlushCodec()
```
Returns whether the codec should be flushed in cases such that the codec was not released.
The default implementation returns whether buffers have been received by the codec.
| See also |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#flushOrReleaseCodec()` | |
### shouldInitCodec
```
protected boolean shouldInitCodec(MediaCodecInfo codecInfo)
```
### shouldProcessStreamChangeAtStart
```
@ExperimentalApi
protected boolean shouldProcessStreamChangeAtStart()
```
Returns whether `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onProcessedStreamChange()` should be invoked on the first stream.
Subclasses can override this method if they need stream change processing for the initial stream even when `https://developer.android.com/reference/androidx/media3/common/Flags#FLAG_PROCESSED_STREAM_CHANGED_AT_START()` is disabled.
### shouldReinitCodec
```
protected boolean shouldReinitCodec()
```
Returns whether the renderer needs to re-initialize the codec, possibly as a result of a change in device capabilities.
### shouldReleaseCodecInsteadOfFlushing
```
protected boolean shouldReleaseCodecInsteadOfFlushing()
```
Returns whether the codec should be released rather than flushed.
| See also |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#flushOrReleaseCodec()` | |
### shouldSkipDecoderInputBuffer
```
protected boolean shouldSkipDecoderInputBuffer(DecoderInputBuffer buffer)
```
Returns whether the input buffer should be skipped before the decoder.
This can be used to skip decoding of buffers that are not depended on during seeking. See `https://developer.android.com/reference/androidx/media3/common/C#BUFFER_FLAG_NOT_DEPENDED_ON()`.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderInputBuffer buffer` | The input buffer. |
### shouldUseBypass
```
protected boolean shouldUseBypass(Format format)
```
Returns whether buffers in the input format can be processed without a codec.
This method is only called if the content is not DRM protected, because if the content is DRM protected use of bypass is never possible.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The input `https://developer.android.com/reference/androidx/media3/common/Format`. |
| Returns |
|---|---|
| `boolean` | Whether playback bypassing `https://developer.android.com/reference/android/media/MediaCodec.html` is supported. |
### supportsFormat
```
@RendererCapabilities.Capabilities
protected abstract int supportsFormat(MediaCodecSelector mediaCodecSelector, Format format)
```
Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` for the given `https://developer.android.com/reference/androidx/media3/common/Format`.
| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecSelector mediaCodecSelector` | The decoder selector. |
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The `https://developer.android.com/reference/androidx/media3/common/Format`. |
| Returns |
|---|---|
| `int` | The `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Capabilities` for this `https://developer.android.com/reference/androidx/media3/common/Format`. |
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecUtil.DecoderQueryException` | If there was an error querying decoders. |
### supportsFormatDrm
```
protected static boolean supportsFormatDrm(Format format)
```
Returns whether this renderer supports the given `https://developer.android.com/reference/androidx/media3/common/Format` DRM scheme.
### updateCodecOperatingRate
```
protected final void updateCodecOperatingRate()
```
Updates the codec operating rate.
### updateOutputFormatForTime
```
protected final void updateOutputFormatForTime(long presentationTimeUs)
```
Updates the output formats for the specified output buffer timestamp, calling `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer#onOutputFormatChanged(androidx.media3.common.Format,android.media.MediaFormat)` if a change has occurred.
Subclasses should only call this method if operating in a mode where buffers are not dequeued from the decoder, for example when using video tunneling).
| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | Thrown if an error occurs as a result of the output format change. |