RenderersFactory

Artifact: androidx.media3:media3-exoplayer

Kotlin |Java

@UnstableApi
interface RenderersFactory

Known direct subclasses

CapturingRenderersFactory, DefaultRenderersFactory

`CapturingRenderersFactory`	A `RenderersFactory` that captures interactions with the audio and video `MediaCodecAdapter` instances and `ImageOutput` instances.
`DefaultRenderersFactory`	Default `RenderersFactory` implementation.

Builds Renderer instances for use by an ExoPlayer.

Summary

Public functions
`Array<Renderer!>!`	`createRenderers( eventHandler: Handler!, videoRendererEventListener: VideoRendererEventListener!, audioRendererEventListener: AudioRendererEventListener!, textRendererOutput: TextOutput!, metadataRendererOutput: MetadataOutput! )` Builds the `Renderer` instances for an `ExoPlayer`.
`Renderer?`	`createSecondaryRenderer( renderer: Renderer!, eventHandler: Handler!, videoRendererEventListener: VideoRendererEventListener!, audioRendererEventListener: AudioRendererEventListener!, textRendererOutput: TextOutput!, metadataRendererOutput: MetadataOutput! )` Provides a secondary `Renderer` instance for an `ExoPlayer` to use for pre-warming.

Public functions

createRenderers

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

Builds the Renderer instances for an ExoPlayer.

Parameters
`eventHandler: Handler!`	A handler to use when invoking event listeners and outputs.
`videoRendererEventListener: VideoRendererEventListener!`	An event listener for video renderers.
`audioRendererEventListener: AudioRendererEventListener!`	An event listener for audio renderers.
`textRendererOutput: TextOutput!`	An output for text renderers.
`metadataRendererOutput: MetadataOutput!`	An output for metadata renderers.

Returns
`Array<Renderer!>!`	The `instances`.

createSecondaryRenderer

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.

Parameters
`renderer: Renderer!`	The primary `Renderer` for which to create the backup.
`eventHandler: Handler!`	A handler to use when invoking event listeners and outputs.
`videoRendererEventListener: VideoRendererEventListener!`	An event listener for video renderers.
`audioRendererEventListener: AudioRendererEventListener!`	An event listener for audio renderers.
`textRendererOutput: TextOutput!`	An output for text renderers.
`metadataRendererOutput: MetadataOutput!`	An output for metadata renderers.

Returns
`Renderer?`	The `instances`.