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.

@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 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 setEnableAudioTrackPlaybackParams(
    enableAudioTrackPlaybackParams: Boolean
): DefaultRenderersFactory!

Sets whether to enable setting playback speed using setPlaybackParams, which is supported from API level 23, rather than using application-level audio speed adjustment. This setting has no effect on builds before API level 23 (application-level speed adjustment will be used in all cases).

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

When using this mode, the maximum supported playback speed is limited by the size of the audio track's buffer. 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,
    enableAudioTrackPlaybackParams: 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(out: ArrayList<Renderer!>!): Unit

Builds image renderers for use by the player.

The ImageRenderer is built with ImageOutput set to null and 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 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 instances.

protected fun getImageDecoderFactory(): ImageDecoder.Factory!

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