DefaultRenderersFactory

const val DEFAULT_ALLOWED_VIDEO_JOINING_TIME_MS = 5000: Long

The default maximum duration for which a video renderer can attempt to seamlessly join an ongoing playback.

const val EXTENSION_RENDERER_MODE_OFF = 0: Int

Do not allow use of extension renderers.

const val EXTENSION_RENDERER_MODE_ON = 1: Int

Allow use of extension renderers. Extension renderers are indexed after core renderers of the same type. A TrackSelector that prefers the first suitable renderer will therefore prefer to use a core renderer to an extension renderer in the case that both are able to play a given track.

const val EXTENSION_RENDERER_MODE_PREFER = 2: Int

Allow use of extension renderers. Extension renderers are indexed before core renderers of the same type. A TrackSelector that prefers the first suitable renderer will therefore prefer to use an extension renderer to a core renderer in the case that both are able to play a given track.

const val MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY = 50: Int

The maximum number of frames that can be dropped between invocations of onDroppedFrames.

fun createRenderers(
    eventHandler: Handler!,
    videoRendererEventListener: VideoRendererEventListener!,
    audioRendererEventListener: AudioRendererEventListener!,
    textRendererOutput: TextOutput!,
    metadataRendererOutput: MetadataOutput!
): Array<Renderer!>!

Builds the Renderer instances for an ExoPlayer.

fun createSecondaryRenderer(
    renderer: Renderer!,
    eventHandler: Handler!,
    videoRendererEventListener: VideoRendererEventListener!,
    audioRendererEventListener: AudioRendererEventListener!,
    textRendererOutput: TextOutput!,
    metadataRendererOutput: MetadataOutput!
): Renderer?

Provides a secondary Renderer instance for an ExoPlayer to use for pre-warming.

The created secondary Renderer should match its primary in its reported track type support and RendererCapabilities.

@RequiresApi(value = 34)
@CanIgnoreReturnValue
fun experimentalSetEnableMediaCodecBufferDecodeOnlyFlag(
    enableMediaCodecBufferDecodeOnlyFlag: Boolean
): DefaultRenderersFactory!

Sets whether the BUFFER_FLAG_DECODE_ONLY flag will be included when queuing decode-only input buffers to the decoder.

If false, then only if the decoder is set up in tunneling mode will the decode-only input buffers be queued with the BUFFER_FLAG_DECODE_ONLY flag. The default value is false.

Requires API 34.

This method is experimental and will be renamed or removed in a future release.

@CanIgnoreReturnValue
fun experimentalSetEnableMediaCodecVideoRendererPrewarming(
    enableMediaCodecVideoRendererPrewarming: Boolean
): DefaultRenderersFactory!

Sets whether a secondary MediaCodecVideoRenderer will be created through buildSecondaryVideoRenderer for use by ExoPlayer for pre-warming.

If enabled, ExoPlayer will pre-process the video of consecutive media items during playback to reduce media item transition latency.

If buildVideoRenderers is overridden to provide custom video renderers then to still enable pre-warming,buildSecondaryVideoRenderer must also be overridden to provide matching secondary custom video renderers.

This method is experimental. Its default value may change, or it may be renamed or removed in a future release.

@CanIgnoreReturnValue
fun experimentalSetLateThresholdToDropDecoderInputUs(
    lateThresholdToDropDecoderInputUs: Long
): DefaultRenderersFactory!

Sets the late threshold for rendered output buffers, in microseconds, after which decoder input buffers may be dropped.

The default value is TIME_UNSET and therefore no input buffers will be dropped due to this logic.

This method is experimental and will be renamed or removed in a future release.

@CanIgnoreReturnValue
fun experimentalSetMediaCodecAsyncCryptoFlagEnabled(
    enableAsyncCryptoFlag: Boolean
): DefaultRenderersFactory!

Sets whether to enable CONFIGURE_FLAG_USE_CRYPTO_ASYNC on API 34 and above when operating the codec in asynchronous mode.

This method is experimental. Its default value may change, or it may be renamed or removed in a future release.

@CanIgnoreReturnValue
fun experimentalSetParseAv1SampleDependencies(
    parseAv1SampleDependencies: Boolean
): DefaultRenderersFactory!

Sets whether VIDEO_AV1 bitstream parsing for sample dependency information is enabled. Knowing which input frames are not depended on can speed up seeking and reduce dropped frames.

Defaults to false.

This method is experimental and will be renamed or removed in a future release.

@CanIgnoreReturnValue
fun forceDisableMediaCodecAsynchronousQueueing(): DefaultRenderersFactory!

Disables androidx.media3.exoplayer.mediacodec.MediaCodecRenderer instances from operating their MediaCodec in asynchronous mode and perform asynchronous queueing. MediaCodec instances will be operated synchronous mode.

@CanIgnoreReturnValue
fun forceEnableMediaCodecAsynchronousQueueing(): DefaultRenderersFactory!

Enables androidx.media3.exoplayer.mediacodec.MediaCodecRenderer instances to operate their MediaCodec in asynchronous mode and perform asynchronous queueing.

This feature can be enabled only on devices with API versions >= 23. For devices with older API versions, this method is a no-op.

@CanIgnoreReturnValue
fun setAllowedVideoJoiningTimeMs(allowedVideoJoiningTimeMs: Long): DefaultRenderersFactory!

Sets the maximum duration for which video renderers can attempt to seamlessly join an ongoing playback.

The default value is DEFAULT_ALLOWED_VIDEO_JOINING_TIME_MS.

@CanIgnoreReturnValue
fun setEnableAudioFloatOutput(enableFloatOutput: Boolean): DefaultRenderersFactory!

Sets whether floating point audio should be output when possible.

Enabling floating point output disables audio processing, but may allow for higher quality audio output.

The default value is false.

@CanIgnoreReturnValue
fun setEnableAudioOutputPlaybackParameters(
    enableAudioOutputPlaybackParameters: Boolean
): DefaultRenderersFactory!

Sets whether to enable setting playback speed via AudioOutput, using setPlaybackParams by default, rather than using application-level audio speed adjustment.

If enabled and supported, new playback speed settings will take effect more quickly because they are applied at the audio mixer, rather than at the point of writing data to the output. However, the setting is more device-dependent, less reliable and may offer fewer available speeds.

If the requested speed is not supported the player's event listener will be notified twice on setting playback speed, once with the requested speed, then again with the old playback speed reflecting the fact that the requested speed was not supported.

@CanIgnoreReturnValue
fun setEnableDecoderFallback(enableDecoderFallback: Boolean): DefaultRenderersFactory!

Sets 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.

@CanIgnoreReturnValue
fun setExtensionRendererMode(
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int
): DefaultRenderersFactory!

Sets the extension renderer mode, which determines if and how available extension renderers are used. Note that extensions must be included in the application build for them to be considered available.

The default value is EXTENSION_RENDERER_MODE_OFF.

@CanIgnoreReturnValue
fun setMediaCodecSelector(mediaCodecSelector: MediaCodecSelector!): DefaultRenderersFactory!

Sets a MediaCodecSelector for use by MediaCodec based renderers.

The default value is DEFAULT.

protected fun buildAudioRenderers(
    context: Context!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    mediaCodecSelector: MediaCodecSelector!,
    enableDecoderFallback: Boolean,
    audioSink: AudioSink!,
    eventHandler: Handler!,
    eventListener: AudioRendererEventListener!,
    out: ArrayList<Renderer!>!
): Unit

Builds audio renderers for use by the player.

protected fun buildAudioSink(
    context: Context!,
    enableFloatOutput: Boolean,
    enableAudioOutputPlaybackParams: Boolean
): AudioSink?

Builds an AudioSink to which the audio renderers will output.

protected fun buildCameraMotionRenderers(
    context: Context!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    out: ArrayList<Renderer!>!
): Unit

Builds camera motion renderers for use by the player.

protected fun buildImageRenderers(context: Context!, out: ArrayList<Renderer!>!): Unit

Builds image renderers for use by the player.

The ImageRenderer is built with ImageOutput set to null and ImageDecoder.Factory set to ImageDecoder.Factory.DEFAULT by default.

protected fun buildMetadataRenderers(
    context: Context!,
    output: MetadataOutput!,
    outputLooper: Looper!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    out: ArrayList<Renderer!>!
): Unit

Builds metadata renderers for use by the player.

protected fun buildMiscellaneousRenderers(
    context: Context!,
    eventHandler: Handler!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    out: ArrayList<Renderer!>!
): Unit

Builds any miscellaneous renderers used by the player.

protected fun buildSecondaryVideoRenderer(
    renderer: Renderer!,
    context: Context!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    mediaCodecSelector: MediaCodecSelector!,
    enableDecoderFallback: Boolean,
    eventHandler: Handler!,
    eventListener: VideoRendererEventListener!,
    allowedVideoJoiningTimeMs: Long
): Renderer?

Builds a secondary video renderer for an ExoPlayer instance to use for pre-warming.

The created secondary video Renderer should match its primary Renderer in reported track type support and RendererCapabilities.

If buildVideoRenderers is overridden to provide custom video renderers, then this method must also be overridden to supply corresponding custom secondary video renderers.

protected fun buildTextRenderers(
    context: Context!,
    output: TextOutput!,
    outputLooper: Looper!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    out: ArrayList<Renderer!>!
): Unit

Builds text renderers for use by the player.

protected fun buildVideoRenderers(
    context: Context!,
    @DefaultRenderersFactory.ExtensionRendererMode extensionRendererMode: Int,
    mediaCodecSelector: MediaCodecSelector!,
    enableDecoderFallback: Boolean,
    eventHandler: Handler!,
    eventListener: VideoRendererEventListener!,
    allowedVideoJoiningTimeMs: Long,
    out: ArrayList<Renderer!>!
): Unit

Builds video renderers for use by the player.

protected fun getCodecAdapterFactory(): MediaCodecAdapter.Factory!

Returns the MediaCodecAdapter.Factory that will be used when creating androidx.media3.exoplayer.mediacodec.MediaCodecRenderer instances.

@ForOverride
protected fun getImageDecoderFactory(context: Context!): ImageDecoder.Factory!

Returns the ImageDecoder.Factory used to build the image renderer.