docs/doc/reference/com/google/android/exoplayer2/audio/MediaCodecAudioRenderer.html
Package com.google.android.exoplayer2.audio
All Implemented Interfaces:PlayerMessage.Target, Renderer, RendererCapabilities, MediaClock
[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public classMediaCodecAudioRendererextends[MediaCodecRenderer](../mediacodec/MediaCodecRenderer.html "class in com.google.android.exoplayer2.mediacodec")implements[MediaClock](../util/MediaClock.html "interface in com.google.android.exoplayer2.util")
Deprecated. com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.
Decodes and renders audio using MediaCodec and an AudioSink.
This renderer accepts the following messages sent via ExoPlayer.createMessage(Target) on the playback thread:
Message with type Renderer.MSG_SET_VOLUME to set the volume. The message payload should be a Float with 0 being silence and 1 being unity gain.
Message with type Renderer.MSG_SET_AUDIO_ATTRIBUTES to set the audio attributes. The message payload should be an AudioAttributes instance that will configure the underlying audio track.
Message with type Renderer.MSG_SET_AUX_EFFECT_INFO to set the auxiliary effect. The message payload should be an AuxEffectInfo instance that will configure the underlying audio track.
Message with type Renderer.MSG_SET_SKIP_SILENCE_ENABLED to enable or disable skipping silences. The message payload should be a Boolean.
Message with type Renderer.MSG_SET_AUDIO_SESSION_ID to set the audio session ID. The message payload should be a session ID Integer that will be attached to the underlying audio track.
-
MediaCodecRenderer.DecoderInitializationException
-
Renderer.MessageType, Renderer.State, Renderer.WakeupListener
-
RendererCapabilities.AdaptiveSupport, RendererCapabilities.Capabilities, RendererCapabilities.DecoderSupport, RendererCapabilities.FormatSupport, RendererCapabilities.HardwareAccelerationSupport, RendererCapabilities.Listener, RendererCapabilities.TunnelingSupport
-
CODEC_OPERATING_RATE_UNSET, decoderCounters
-
MSG_CUSTOM_BASE, MSG_SET_AUDIO_ATTRIBUTES, MSG_SET_AUDIO_SESSION_ID, MSG_SET_AUX_EFFECT_INFO, MSG_SET_CAMERA_MOTION_LISTENER, MSG_SET_CHANGE_FRAME_RATE_STRATEGY, MSG_SET_PREFERRED_AUDIO_DEVICE, MSG_SET_SCALING_MODE, MSG_SET_SKIP_SILENCE_ENABLED, MSG_SET_VIDEO_EFFECTS, MSG_SET_VIDEO_FRAME_METADATA_LISTENER, MSG_SET_VIDEO_OUTPUT, MSG_SET_VIDEO_OUTPUT_RESOLUTION, MSG_SET_VOLUME, MSG_SET_WAKEUP_LISTENER, STATE_DISABLED, STATE_ENABLED, STATE_STARTED
-
ADAPTIVE_NOT_SEAMLESS, ADAPTIVE_NOT_SUPPORTED, ADAPTIVE_SEAMLESS, ADAPTIVE_SUPPORT_MASK, DECODER_SUPPORT_FALLBACK, DECODER_SUPPORT_FALLBACK_MIMETYPE, DECODER_SUPPORT_PRIMARY, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_HANDLED, FORMAT_SUPPORT_MASK, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE, HARDWARE_ACCELERATION_NOT_SUPPORTED, HARDWARE_ACCELERATION_SUPPORT_MASK, HARDWARE_ACCELERATION_SUPPORTED, MODE_SUPPORT_MASK, TUNNELING_NOT_SUPPORTED, TUNNELING_SUPPORT_MASK, TUNNELING_SUPPORTED
Constructors | Constructor | Description |
| --- | --- |
| MediaCodecAudioRenderer(Context context, MediaCodecAdapter.Factory codecAdapterFactory, MediaCodecSelector mediaCodecSelector, boolean enableDecoderFallback, Handler eventHandler, AudioRendererEventListener eventListener, AudioSink audioSink) |
Deprecated.
Creates a new instance.
|
| MediaCodecAudioRenderer(Context context, MediaCodecSelector mediaCodecSelector) |
Deprecated.
|
| MediaCodecAudioRenderer(Context context, MediaCodecSelector mediaCodecSelector, boolean enableDecoderFallback, Handler eventHandler, AudioRendererEventListener eventListener, AudioSink audioSink) |
Deprecated.
|
| MediaCodecAudioRenderer(Context context, MediaCodecSelector mediaCodecSelector, Handler eventHandler, AudioRendererEventListener eventListener) |
Deprecated.
|
| MediaCodecAudioRenderer(Context context, MediaCodecSelector mediaCodecSelector, Handler eventHandler, AudioRendererEventListener eventListener, AudioCapabilities audioCapabilities, AudioProcessor... audioProcessors) |
Deprecated.
|
| MediaCodecAudioRenderer(Context context, MediaCodecSelector mediaCodecSelector, Handler eventHandler, AudioRendererEventListener eventListener, AudioSink audioSink) |
Deprecated.
|
All Methods Instance Methods Concrete Methods Deprecated Methods | Modifier and Type | Method | Description |
| --- | --- | --- |
| protected DecoderReuseEvaluation | canReuseCodec(MediaCodecInfo codecInfo, Format oldFormat, Format newFormat) |
Deprecated.
Evaluates whether the existing MediaCodec can be kept for a new Format, and if it can whether it requires reconfiguration.
|
| void | experimentalSetEnableKeepAudioTrackOnSeek(boolean enableKeepAudioTrackOnSeek) |
Deprecated.
Sets whether to enable the experimental feature that keeps and flushes the AudioTrack when a seek occurs, as opposed to releasing and reinitialising.
|
| protected int | getCodecMaxInputSize(MediaCodecInfo codecInfo, Format format, Format[] streamFormats) |
Deprecated.
Returns a maximum input size suitable for configuring a codec for format in a way that will allow possible adaptation to other compatible formats in streamFormats.
|
| protected float | getCodecOperatingRateV23(float targetPlaybackSpeed, Format format, Format[] streamFormats) |
Deprecated.
Returns the MediaFormat.KEY_OPERATING_RATE value for a given playback speed, current Format and set of possible stream formats.
|
| protected List<MediaCodecInfo> | getDecoderInfos(MediaCodecSelector mediaCodecSelector, Format format, boolean requiresSecureDecoder) |
Deprecated.
Returns a list of decoders that can decode media in the specified format, in priority order.
|
| MediaClock | getMediaClock() |
Deprecated.
If the renderer advances its own playback position then this method returns a corresponding MediaClock.
|
| protected MediaCodecAdapter.Configuration | getMediaCodecConfiguration(MediaCodecInfo codecInfo, Format format, MediaCrypto crypto, float codecOperatingRate) |
Deprecated.
Returns the MediaCodecAdapter.Configuration that will be used to create and configure a MediaCodec to decode the given Format for a playback.
|
| protected MediaFormat | getMediaFormat(Format format, String codecMimeType, int codecMaxInputSize, float codecOperatingRate) |
Deprecated.
Returns the framework MediaFormat that can be used to configure a MediaCodec for decoding the given Format for playback.
|
| String | getName() |
Deprecated.
Returns the name of this renderer, for logging and debugging purposes.
|
| PlaybackParameters | getPlaybackParameters() |
Deprecated.
Returns the active playback parameters.
|
| long | getPositionUs() |
Deprecated.
Returns the current media position in microseconds.
|
| void | handleMessage(@com.google.android.exoplayer2.Renderer.MessageType int messageType, Object message) |
Deprecated.
Handles a message delivered to the target.
|
| boolean | isEnded() |
Deprecated.
Whether the renderer is ready for the ExoPlayer instance to transition to Player.STATE_ENDED.
|
| boolean | isReady() |
Deprecated.
Whether the renderer is able to immediately render media from the current position.
|
| protected void | onCodecError(Exception codecError) |
Deprecated.
Called when a codec error has occurred.
|
| protected void | onCodecInitialized(String name, MediaCodecAdapter.Configuration configuration, long initializedTimestampMs, long initializationDurationMs) |
Deprecated.
Called when a MediaCodec has been created and configured.
|
| protected void | onCodecReleased(String name) |
Deprecated.
Called when a MediaCodec has been released.
|
| protected void | onDisabled() |
Deprecated.
Called when the renderer is disabled.
|
| protected void | onEnabled(boolean joining, boolean mayRenderStartOfStream) |
Deprecated.
Called when the renderer is enabled.
|
| protected DecoderReuseEvaluation | onInputFormatChanged(FormatHolder formatHolder) |
Deprecated.
Called when a new Format is read from the upstream MediaPeriod.
|
| protected void | onOutputFormatChanged(Format format, MediaFormat mediaFormat) |
Deprecated.
Called when one of the output formats changes.
|
| protected void | onOutputStreamOffsetUsChanged(long outputStreamOffsetUs) |
Deprecated.
Called after the output stream offset changes.
|
| protected void | onPositionDiscontinuity() |
Deprecated.
See AudioSink.Listener.onPositionDiscontinuity().
|
| protected void | onPositionReset(long positionUs, boolean joining) |
Deprecated.
Called when the position is reset.
|
| protected void | onProcessedStreamChange() |
Deprecated.
Called after the last output buffer before a stream change has been processed.
|
| protected void | onQueueInputBuffer(DecoderInputBuffer buffer) |
Deprecated.
Called immediately before an input buffer is queued into the codec.
|
| protected void | onRelease() |
Deprecated.
Called when the renderer is released.
|
| protected void | onReset() |
Deprecated.
Called when the renderer is reset.
|
| protected void | onStarted() |
Deprecated.
Called when the renderer is started.
|
| protected void | onStopped() |
Deprecated.
Called when the renderer is stopped.
|
| protected boolean | processOutputBuffer(long positionUs, long elapsedRealtimeUs, MediaCodecAdapter codec, ByteBuffer buffer, int bufferIndex, int bufferFlags, int sampleCount, long bufferPresentationTimeUs, boolean isDecodeOnlyBuffer, boolean isLastBuffer, Format format) |
Deprecated.
Processes an output media buffer.
|
| protected void | renderToEndOfStream() |
Deprecated.
Incrementally renders any remaining output.
|
| void | setPlaybackParameters(PlaybackParameters playbackParameters) |
Deprecated.
Attempts to set the playback parameters.
|
| protected boolean | shouldUseBypass(Format format) |
Deprecated.
Returns whether buffers in the input format can be processed without a codec.
|
| protected @com.google.android.exoplayer2.RendererCapabilities.Capabilities int | supportsFormat(MediaCodecSelector mediaCodecSelector, Format format) |
Deprecated.
Returns the RendererCapabilities.Capabilities for the given Format.
|
-
createDecoderException, flushOrReinitializeCodec, flushOrReleaseCodec, getCodec, getCodecInfo, getCodecNeedsEosPropagation, getCodecOperatingRate, getCodecOutputMediaFormat, getOutputStreamOffsetUs, getPlaybackSpeed, handleInputBufferSupplementalData, isBypassPossible, maybeInitCodecOrBypass, onProcessedOutputBuffer, onReadyToInitializeCodec, onStreamChanged, releaseCodec, render, resetCodecStateForFlush, resetCodecStateForRelease, setPendingOutputEndOfStream, setPendingPlaybackException, setPlaybackSpeed, setRenderTimeLimitMs, shouldInitCodec, shouldReinitCodec, supportsFormat, supportsFormatDrm, supportsMixedMimeTypeAdaptation, updateCodecOperatingRate, updateOutputFormatForTime
-
clearListener, createRendererException, createRendererException, disable, enable, getCapabilities, getConfiguration, getFormatHolder, getIndex, getLastResetPositionUs, getPlayerId, getReadingPositionUs, getState, getStream, getStreamFormats, getTrackType, hasReadStreamToEnd, init, isCurrentStreamFinal, isSourceReady, maybeThrowStreamError, onRendererCapabilitiesChanged, readSource, release, replaceStream, reset, resetPosition, setCurrentStreamFinal, setListener, skipSource, start, stop
-
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector)
Deprecated.
Parameters:context - A context.mediaCodecSelector - A decoder selector.
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,
@Nullable[Handler](https://developer.android.com/reference/android/os/Handler.html "class or interface in android.os")eventHandler,
@Nullable[AudioRendererEventListener](AudioRendererEventListener.html "interface in com.google.android.exoplayer2.audio")eventListener)
Deprecated.
Parameters:context - A context.mediaCodecSelector - A decoder selector.eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.eventListener - A listener of events. May be null if delivery of events is not required.
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,
@Nullable[Handler](https://developer.android.com/reference/android/os/Handler.html "class or interface in android.os")eventHandler,
@Nullable[AudioRendererEventListener](AudioRendererEventListener.html "interface in com.google.android.exoplayer2.audio")eventListener,[AudioCapabilities](AudioCapabilities.html "class in com.google.android.exoplayer2.audio")audioCapabilities,[AudioProcessor](AudioProcessor.html "interface in com.google.android.exoplayer2.audio")... audioProcessors)
Deprecated.
Parameters:context - A context.mediaCodecSelector - A decoder selector.eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.eventListener - A listener of events. May be null if delivery of events is not required.audioCapabilities - The audio capabilities for playback on this device. Use AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES if default capabilities (no encoded audio passthrough support) should be assumed.audioProcessors - Optional AudioProcessors that will process PCM audio before output.
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,
@Nullable[Handler](https://developer.android.com/reference/android/os/Handler.html "class or interface in android.os")eventHandler,
@Nullable[AudioRendererEventListener](AudioRendererEventListener.html "interface in com.google.android.exoplayer2.audio")eventListener,[AudioSink](AudioSink.html "interface in com.google.android.exoplayer2.audio")audioSink)
Deprecated.
Parameters:context - A context.mediaCodecSelector - A decoder selector.eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.eventListener - A listener of events. May be null if delivery of events is not required.audioSink - The sink to which audio will be output.
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,
boolean enableDecoderFallback,
@Nullable[Handler](https://developer.android.com/reference/android/os/Handler.html "class or interface in android.os")eventHandler,
@Nullable[AudioRendererEventListener](AudioRendererEventListener.html "interface in com.google.android.exoplayer2.audio")eventListener,[AudioSink](AudioSink.html "interface in com.google.android.exoplayer2.audio")audioSink)
Deprecated.
Parameters:context - A context.mediaCodecSelector - A decoder selector.enableDecoderFallback - Whether to enable fallback to lower-priority decoders if decoder initialization fails. This may result in using a decoder that is slower/less efficient than the primary decoder.eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.eventListener - A listener of events. May be null if delivery of events is not required.audioSink - The sink to which audio will be output.
-
public MediaCodecAudioRenderer([Context](https://developer.android.com/reference/android/content/Context.html "class or interface in android.content")context,[MediaCodecAdapter.Factory](../mediacodec/MediaCodecAdapter.Factory.html "interface in com.google.android.exoplayer2.mediacodec")codecAdapterFactory,[MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,
boolean enableDecoderFallback,
@Nullable[Handler](https://developer.android.com/reference/android/os/Handler.html "class or interface in android.os")eventHandler,
@Nullable[AudioRendererEventListener](AudioRendererEventListener.html "interface in com.google.android.exoplayer2.audio")eventListener,[AudioSink](AudioSink.html "interface in com.google.android.exoplayer2.audio")audioSink)
Deprecated.
Creates a new instance.
Parameters:context - A context.codecAdapterFactory - The MediaCodecAdapter.Factory used to create MediaCodecAdapter instances.mediaCodecSelector - A decoder selector.enableDecoderFallback - Whether to enable fallback to lower-priority decoders if decoder initialization fails. This may result in using a decoder that is slower/less efficient than the primary decoder.eventHandler - A handler to use when delivering events to eventListener. May be null if delivery of events is not required.eventListener - A listener of events. May be null if delivery of events is not required.audioSink - The sink to which audio will be output.
-
public[String](https://developer.android.com/reference/java/lang/String.html "class or interface in java.lang")getName()
Deprecated.
Description copied from interface: Renderer
Returns the name of this renderer, for logging and debugging purposes. Should typically be the renderer's (un-obfuscated) class name.
Specified by:getName in interface RendererSpecified by:getName in interface RendererCapabilitiesReturns:The name of this renderer.
-
public void experimentalSetEnableKeepAudioTrackOnSeek(boolean enableKeepAudioTrackOnSeek)
Deprecated.
Sets whether to enable the experimental feature that keeps and flushes the AudioTrack when a seek occurs, as opposed to releasing and reinitialising. Off by default.
This method is experimental, and will be renamed or removed in a future release.
Parameters:enableKeepAudioTrackOnSeek - Whether to keep the AudioTrack on seek.
-
protected @com.google.android.exoplayer2.RendererCapabilities.Capabilities int supportsFormat([MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,[Format](../Format.html "class in com.google.android.exoplayer2")format)
throws[MediaCodecUtil.DecoderQueryException](../mediacodec/MediaCodecUtil.DecoderQueryException.html "class in com.google.android.exoplayer2.mediacodec")
Deprecated.
Description copied from class: MediaCodecRenderer
Returns the RendererCapabilities.Capabilities for the given Format.
Specified by:supportsFormat in class MediaCodecRendererParameters:mediaCodecSelector - The decoder selector.format - The Format.Returns:The RendererCapabilities.Capabilities for this Format.Throws:MediaCodecUtil.DecoderQueryException - If there was an error querying decoders.
-
protected[List](https://developer.android.com/reference/java/util/List.html "class or interface in java.util")<[MediaCodecInfo](../mediacodec/MediaCodecInfo.html "class in com.google.android.exoplayer2.mediacodec")> getDecoderInfos([MediaCodecSelector](../mediacodec/MediaCodecSelector.html "interface in com.google.android.exoplayer2.mediacodec")mediaCodecSelector,[Format](../Format.html "class in com.google.android.exoplayer2")format,
boolean requiresSecureDecoder)
throws[MediaCodecUtil.DecoderQueryException](../mediacodec/MediaCodecUtil.DecoderQueryException.html "class in com.google.android.exoplayer2.mediacodec")
Deprecated.
Description copied from class: MediaCodecRenderer
Returns a list of decoders that can decode media in the specified format, in priority order.
Specified by:getDecoderInfos in class MediaCodecRendererParameters:mediaCodecSelector - The decoder selector.format - The Format for which a decoder is required.requiresSecureDecoder - Whether a secure decoder is required.Returns:A list of MediaCodecInfos corresponding to decoders. May be empty.Throws:MediaCodecUtil.DecoderQueryException - Thrown if there was an error querying decoders.
-
protected boolean shouldUseBypass([Format](../Format.html "class in com.google.android.exoplayer2")format)
Deprecated.
Description copied from class: MediaCodecRenderer
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.
Overrides:shouldUseBypass in class MediaCodecRendererParameters:format - The input Format.Returns:Whether playback bypassing MediaCodec is supported.
-
protected[MediaCodecAdapter.Configuration](../mediacodec/MediaCodecAdapter.Configuration.html "class in com.google.android.exoplayer2.mediacodec")getMediaCodecConfiguration([MediaCodecInfo](../mediacodec/MediaCodecInfo.html "class in com.google.android.exoplayer2.mediacodec")codecInfo,[Format](../Format.html "class in com.google.android.exoplayer2")format,
@Nullable[MediaCrypto](https://developer.android.com/reference/android/media/MediaCrypto.html "class or interface in android.media")crypto,
float codecOperatingRate)
Deprecated.
Description copied from class: MediaCodecRenderer
Returns the MediaCodecAdapter.Configuration that will be used to create and configure a MediaCodec to decode the given Format for a playback.
Specified by:getMediaCodecConfiguration in class MediaCodecRendererParameters:codecInfo - Information about the MediaCodec being configured.format - The Format for which the codec is being configured.crypto - For drm protected playbacks, a MediaCrypto to use for decryption.codecOperatingRate - The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.Returns:The parameters needed to call MediaCodec.configure(android.media.MediaFormat, android.view.Surface, android.media.MediaCrypto, int).
-
protected[DecoderReuseEvaluation](../decoder/DecoderReuseEvaluation.html "class in com.google.android.exoplayer2.decoder")canReuseCodec([MediaCodecInfo](../mediacodec/MediaCodecInfo.html "class in com.google.android.exoplayer2.mediacodec")codecInfo,[Format](../Format.html "class in com.google.android.exoplayer2")oldFormat,[Format](../Format.html "class in com.google.android.exoplayer2")newFormat)
Deprecated.
Description copied from class: MediaCodecRenderer
Evaluates whether the existing MediaCodec can be kept for a new Format, and if it can whether it requires reconfiguration.
The default implementation does not allow decoder reuse.
Overrides:canReuseCodec in class MediaCodecRendererParameters:codecInfo - A MediaCodecInfo describing the decoder.oldFormat - The Format for which the existing instance is configured.newFormat - The new Format.Returns:The result of the evaluation.
-
@Nullable
public[MediaClock](../util/MediaClock.html "interface in com.google.android.exoplayer2.util")getMediaClock()
Deprecated.
Description copied from interface: Renderer
If the renderer advances its own playback position then this method returns a corresponding MediaClock. If provided, the player will use the returned MediaClock as its source of time during playback. A player may have at most one renderer that returns a MediaClock from this method.
Specified by:getMediaClock in interface RendererOverrides:getMediaClock in class BaseRendererReturns:The MediaClock tracking the playback position of the renderer, or null.
-
protected float getCodecOperatingRateV23(float targetPlaybackSpeed,[Format](../Format.html "class in com.google.android.exoplayer2")format,[Format](../Format.html "class in com.google.android.exoplayer2")[] streamFormats)
Deprecated.
Description copied from class: MediaCodecRenderer
Returns the MediaFormat.KEY_OPERATING_RATE value for a given playback speed, current Format and set of possible stream formats.
The default implementation returns MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET.
Overrides:getCodecOperatingRateV23 in class MediaCodecRendererParameters: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.format - The Format for which the codec is being configured.streamFormats - The possible stream formats.Returns:The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.
-
protected void onCodecInitialized([String](https://developer.android.com/reference/java/lang/String.html "class or interface in java.lang")name,[MediaCodecAdapter.Configuration](../mediacodec/MediaCodecAdapter.Configuration.html "class in com.google.android.exoplayer2.mediacodec")configuration,
long initializedTimestampMs,
long initializationDurationMs)
Deprecated.
Description copied from class: MediaCodecRenderer
Called when a MediaCodec has been created and configured.
The default implementation is a no-op.
Overrides:onCodecInitialized in class MediaCodecRendererParameters:name - The name of the codec that was initialized.configuration - The MediaCodecAdapter.Configuration used to configure the codec.initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.initializationDurationMs - The time taken to initialize the codec in milliseconds.
-
protected void onCodecReleased([String](https://developer.android.com/reference/java/lang/String.html "class or interface in java.lang")name)
Deprecated.
Description copied from class: MediaCodecRenderer
Called when a MediaCodec has been released.
The default implementation is a no-op.
Overrides:onCodecReleased in class MediaCodecRendererParameters:name - The name of the codec that was released.
-
protected void onCodecError([Exception](https://developer.android.com/reference/java/lang/Exception.html "class or interface in java.lang")codecError)
Deprecated.
Description copied from class: MediaCodecRenderer
Called when a codec error has occurred.
The default implementation is a no-op.
Overrides:onCodecError in class MediaCodecRendererParameters:codecError - The error.
-
@Nullable
protected[DecoderReuseEvaluation](../decoder/DecoderReuseEvaluation.html "class in com.google.android.exoplayer2.decoder")onInputFormatChanged([FormatHolder](../FormatHolder.html "class in com.google.android.exoplayer2")formatHolder)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: MediaCodecRenderer
Called when a new Format is read from the upstream MediaPeriod.
Overrides:onInputFormatChanged in class MediaCodecRendererParameters:formatHolder - A FormatHolder that holds the new Format.Returns: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:ExoPlaybackException - If an error occurs re-initializing the MediaCodec.
-
protected void onOutputFormatChanged([Format](../Format.html "class in com.google.android.exoplayer2")format,
@Nullable[MediaFormat](https://developer.android.com/reference/android/media/MediaFormat.html "class or interface in android.media")mediaFormat)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: MediaCodecRenderer
Called when one of the output formats changes.
The default implementation is a no-op.
Overrides:onOutputFormatChanged in class MediaCodecRendererParameters:format - The input Format to which future output now corresponds. If the renderer is in bypass mode, this is also the output format.mediaFormat - The codec output MediaFormat, or null if the renderer is in bypass mode.Throws:ExoPlaybackException - Thrown if an error occurs configuring the output.
-
@CallSuper
protected void onPositionDiscontinuity()
Deprecated.
See AudioSink.Listener.onPositionDiscontinuity().
-
protected void onEnabled(boolean joining,
boolean mayRenderStartOfStream)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is enabled.
The default implementation is a no-op.
Overrides:onEnabled in class MediaCodecRendererParameters:joining - Whether this renderer is being enabled to join an ongoing playback.mayRenderStartOfStream - Whether this renderer is allowed to render the start of the stream even if the state is not Renderer.STATE_STARTED yet.Throws:ExoPlaybackException - If an error occurs.
-
protected void onPositionReset(long positionUs,
boolean joining)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: BaseRenderer
Called when the position is reset. This occurs when the renderer is enabled after BaseRenderer.onStreamChanged(Format[], long, long) has been called, and also when a position discontinuity is encountered.
After a position reset, the renderer's SampleStream is guaranteed to provide samples starting from a key frame.
The default implementation is a no-op.
Overrides:onPositionReset in class MediaCodecRendererParameters:positionUs - The new playback position in microseconds.joining - Whether this renderer is being enabled to join an ongoing playback.Throws:ExoPlaybackException - If an error occurs.
-
protected void onStarted()
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is started.
The default implementation is a no-op.
Overrides:onStarted in class MediaCodecRenderer
-
protected void onStopped()
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is stopped.
The default implementation is a no-op.
Overrides:onStopped in class MediaCodecRenderer
-
protected void onDisabled()
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is disabled.
The default implementation is a no-op.
Overrides:onDisabled in class MediaCodecRenderer
-
protected void onReset()
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is reset.
The default implementation is a no-op.
Overrides:onReset in class MediaCodecRenderer
-
protected void onRelease()
Deprecated.
Description copied from class: BaseRenderer
Called when the renderer is released.
The default implementation is a no-op.
Overrides:onRelease in class BaseRenderer
-
public boolean isEnded()
Deprecated.
Description copied from interface: Renderer
Whether the renderer is ready for the ExoPlayer instance to transition to 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: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
Specified by:isEnded in interface RendererOverrides:isEnded in class MediaCodecRendererReturns:Whether the renderer is ready for the player to transition to the ended state.
-
public boolean isReady()
Deprecated.
Description copied from interface: Renderer
Whether the renderer is able to immediately render media from the current position.
If the renderer is in the Renderer.STATE_STARTED state then returning true indicates that the renderer has everything that it needs to continue playback. Returning false indicates that the player should pause until the renderer is ready.
If the renderer is in the Renderer.STATE_ENABLED state then returning true indicates that the renderer is ready for playback to be started. Returning false indicates that it is not.
This method may be called when the renderer is in the following states: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
Specified by:isReady in interface RendererOverrides:isReady in class MediaCodecRendererReturns:Whether the renderer is ready to render media.
-
public long getPositionUs()
Deprecated.
Description copied from interface: MediaClock
Returns the current media position in microseconds.
Specified by:getPositionUs in interface MediaClock
-
public void setPlaybackParameters([PlaybackParameters](../PlaybackParameters.html "class in com.google.android.exoplayer2")playbackParameters)
Deprecated.
Description copied from interface: MediaClock
Attempts to set the playback parameters. The media clock may override the speed if changing the playback parameters is not supported.
Specified by:setPlaybackParameters in interface MediaClockParameters:playbackParameters - The playback parameters to attempt to set.
-
public[PlaybackParameters](../PlaybackParameters.html "class in com.google.android.exoplayer2")getPlaybackParameters()
Deprecated.
Description copied from interface: MediaClock
Returns the active playback parameters.
Specified by:getPlaybackParameters in interface MediaClock
-
protected void onQueueInputBuffer([DecoderInputBuffer](../decoder/DecoderInputBuffer.html "class in com.google.android.exoplayer2.decoder")buffer)
Deprecated.
Description copied from class: MediaCodecRenderer
Called immediately before an input buffer is queued into the codec.
The default implementation is a no-op.
Overrides:onQueueInputBuffer in class MediaCodecRendererParameters:buffer - The buffer to be queued.
-
protected void onProcessedStreamChange()
Deprecated.
Description copied from class: MediaCodecRenderer
Called after the last output buffer before a stream change has been processed.
Overrides:onProcessedStreamChange in class MediaCodecRenderer
-
protected boolean processOutputBuffer(long positionUs,
long elapsedRealtimeUs,
@Nullable[MediaCodecAdapter](../mediacodec/MediaCodecAdapter.html "interface in com.google.android.exoplayer2.mediacodec")codec,
@Nullable[ByteBuffer](https://developer.android.com/reference/java/nio/ByteBuffer.html "class or interface in java.nio")buffer,
int bufferIndex,
int bufferFlags,
int sampleCount,
long bufferPresentationTimeUs,
boolean isDecodeOnlyBuffer,
boolean isLastBuffer,[Format](../Format.html "class in com.google.android.exoplayer2")format)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: MediaCodecRenderer
Processes an output media buffer.
When a new ByteBuffer is passed to this method its position and limit delineate the data to be processed. The return value indicates whether the buffer was processed in full. If true is returned then the next call to this method will receive a new buffer to be processed. If false is returned then the same buffer will be passed to the next call. An implementation of this method is free to modify the buffer and can assume that the buffer will not be externally modified between successive calls. Hence an implementation can, for example, modify the buffer's position to keep track of how much of the data it has processed.
Note that the first call to this method following a call to MediaCodecRenderer.onPositionReset(long, boolean) will always receive a new ByteBuffer to be processed.
Specified by:processOutputBuffer in class MediaCodecRendererParameters:positionUs - The current media time in microseconds, measured at the start of the current iteration of the rendering loop.elapsedRealtimeUs - SystemClock.elapsedRealtime() in microseconds, measured at the start of the current iteration of the rendering loop.codec - The MediaCodecAdapter instance, or null in bypass mode were no codec is used.buffer - The output buffer to process, or null if the buffer data is not made available to the application layer (see MediaCodec.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.bufferIndex - The index of the output buffer.bufferFlags - The flags attached to the output buffer.sampleCount - The number of samples extracted from the sample queue in the buffer. This allows handling multiple samples as a batch for efficiency.bufferPresentationTimeUs - The presentation time of the output buffer in microseconds.isDecodeOnlyBuffer - Whether the buffer was marked with C.BUFFER_FLAG_DECODE_ONLY by the source.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.format - The Format associated with the buffer.Returns:Whether the output buffer was fully processed (for example, rendered or skipped).Throws:ExoPlaybackException - If an error occurs processing the output buffer.
-
protected void renderToEndOfStream()
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from class: MediaCodecRenderer
Incrementally renders any remaining output.
The default implementation is a no-op.
Overrides:renderToEndOfStream in class MediaCodecRendererThrows:ExoPlaybackException - Thrown if an error occurs rendering remaining output.
-
protected void onOutputStreamOffsetUsChanged(long outputStreamOffsetUs)
Deprecated.
Description copied from class: MediaCodecRenderer
Called after the output stream offset changes.
The default implementation is a no-op.
Overrides:onOutputStreamOffsetUsChanged in class MediaCodecRendererParameters:outputStreamOffsetUs - The output stream offset in microseconds.
-
public void handleMessage(@com.google.android.exoplayer2.Renderer.MessageType int messageType,
@Nullable[Object](https://developer.android.com/reference/java/lang/Object.html "class or interface in java.lang")message)
throws[ExoPlaybackException](../ExoPlaybackException.html "class in com.google.android.exoplayer2")
Deprecated.
Description copied from interface: PlayerMessage.Target
Handles a message delivered to the target.
Specified by:handleMessage in interface PlayerMessage.TargetOverrides:handleMessage in class BaseRendererParameters:messageType - The message type.message - The message payload.Throws:ExoPlaybackException - If an error occurred whilst handling the message. Should only be thrown by targets that handle messages on the playback thread.
-
protected int getCodecMaxInputSize([MediaCodecInfo](../mediacodec/MediaCodecInfo.html "class in com.google.android.exoplayer2.mediacodec")codecInfo,[Format](../Format.html "class in com.google.android.exoplayer2")format,[Format](../Format.html "class in com.google.android.exoplayer2")[] streamFormats)
Deprecated.
Returns a maximum input size suitable for configuring a codec for format in a way that will allow possible adaptation to other compatible formats in streamFormats.
Parameters:codecInfo - A MediaCodecInfo describing the decoder.format - The Format for which the codec is being configured.streamFormats - The possible stream formats.Returns:A suitable maximum input size.
-
protected[MediaFormat](https://developer.android.com/reference/android/media/MediaFormat.html "class or interface in android.media")getMediaFormat([Format](../Format.html "class in com.google.android.exoplayer2")format,[String](https://developer.android.com/reference/java/lang/String.html "class or interface in java.lang")codecMimeType,
int codecMaxInputSize,
float codecOperatingRate)
Deprecated.
Returns the framework MediaFormat that can be used to configure a MediaCodec for decoding the given Format for playback.
Parameters:format - The Format of the media.codecMimeType - The MIME type handled by the codec.codecMaxInputSize - The maximum input size supported by the codec.codecOperatingRate - The codec operating rate, or MediaCodecRenderer.CODEC_OPERATING_RATE_UNSET if no codec operating rate should be set.Returns:The framework MediaFormat.