# CapturingRenderersFactory

Artifact: [androidx.media3:media3-test-utils-robolectric](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/test/utils/robolectric/CapturingRenderersFactory.java+class:androidx.media3.test.utils.robolectric.CapturingRenderersFactory)

*** ** * ** ***


```
@UnstableApi
class CapturingRenderersFactory : RenderersFactory, Dumper.Dumpable
```

<br />

*** ** * ** ***

A `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/RenderersFactory` that captures interactions with the audio and video `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter` instances and `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/image/ImageOutput` instances.

The captured interactions can be used in a test assertion via the `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Dumper.Dumpable` interface.

## Summary

| ### Nested types |
|---|
| `protected class https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.CapturingMediaCodecVideoRenderer : https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` A `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` that will not skip or drop buffers due to slow processing. |
| `interface https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.TextRendererFactory` A factory for `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instances that handle `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_TEXT()` tracks. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#CapturingRenderersFactory(android.content.Context,androidx.media3.common.util.Clock)(context: https://developer.android.com/reference/android/content/Context.html!, clock: https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock!)` Creates an instance. |
| `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#CapturingRenderersFactory(android.content.Context,androidx.media3.common.util.Clock,androidx.media3.test.utils.CapturingAudioSink)( context: https://developer.android.com/reference/android/content/Context.html!, clock: https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock!, capturingAudioSink: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/CapturingAudioSink! )` Creates an instance. |

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer!>!` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#createRenderers(android.os.Handler,androidx.media3.exoplayer.video.VideoRendererEventListener,androidx.media3.exoplayer.audio.AudioRendererEventListener,androidx.media3.exoplayer.text.TextOutput,androidx.media3.exoplayer.metadata.MetadataOutput)( eventHandler: https://developer.android.com/reference/android/os/Handler.html!, videoRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoRendererEventListener!, audioRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioRendererEventListener!, textRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/TextOutput!, metadataRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/metadata/MetadataOutput! )` Builds the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instances for an `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#dump(androidx.media3.test.utils.Dumper)(dumper: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Dumper!)` Dumps the fields of the object using the `dumper`. |
| `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#setTextRendererFactory(androidx.media3.test.utils.robolectric.CapturingRenderersFactory.TextRendererFactory)( textRendererFactory: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.TextRendererFactory! )` Sets the factory for `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instances that handle `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_TEXT()` tracks. |

| ### Protected functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer!` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#createMediaCodecVideoRenderer(android.os.Handler,androidx.media3.exoplayer.video.VideoRendererEventListener)( eventHandler: https://developer.android.com/reference/android/os/Handler.html!, videoRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoRendererEventListener! )` Returns new instance of a specialized `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` that will not drop or skip buffers due to slow processing. |
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Factory!` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#getMediaCodecAdapterFactory()()` Returns the `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.CapturingMediaCodecAdapter.Factory` as a `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Factory`. |

| ### Protected properties |
|---|---|
| `https://developer.android.com/reference/android/content/Context.html!` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#context()` |
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/image/ImageDecoder.Factory!` | `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory#imageDecoderFactory()` |

### Inherited functions

From [androidx.media3.exoplayer.RenderersFactory](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/RenderersFactory) `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer?` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/RenderersFactory#createSecondaryRenderer(androidx.media3.exoplayer.Renderer,android.os.Handler,androidx.media3.exoplayer.video.VideoRendererEventListener,androidx.media3.exoplayer.audio.AudioRendererEventListener,androidx.media3.exoplayer.text.TextOutput,androidx.media3.exoplayer.metadata.MetadataOutput)(
renderer: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer!,
eventHandler: https://developer.android.com/reference/android/os/Handler.html!,
videoRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoRendererEventListener!,
audioRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioRendererEventListener!,
textRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/TextOutput!,
metadataRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/metadata/MetadataOutput!
)`

Provides a secondary `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instance for an `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer` to use for pre-warming.

## Public constructors

### CapturingRenderersFactory

```
CapturingRenderersFactory(context: Context!, clock: Clock!)
```

Creates an instance.

| Parameters |
|---|---|
| `context: https://developer.android.com/reference/android/content/Context.html!` | The `https://developer.android.com/reference/android/content/Context.html`. |
| `clock: https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock!` | The `https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock`. |

### CapturingRenderersFactory

```
CapturingRenderersFactory(
    context: Context!,
    clock: Clock!,
    capturingAudioSink: CapturingAudioSink!
)
```

Creates an instance.

| Parameters |
|---|---|
| `context: https://developer.android.com/reference/android/content/Context.html!` | The `https://developer.android.com/reference/android/content/Context.html`. |
| `clock: https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock!` | The `https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock`. |
| `capturingAudioSink: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/CapturingAudioSink!` | The audio sink to use for capturing audio output. |

## Public functions

### createRenderers

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

Builds the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instances for an `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer`.

| Parameters |
|---|---|
| `eventHandler: https://developer.android.com/reference/android/os/Handler.html!` | A handler to use when invoking event listeners and outputs. |
| `videoRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoRendererEventListener!` | An event listener for video renderers. |
| `audioRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioRendererEventListener!` | An event listener for audio renderers. |
| `textRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/TextOutput!` | An output for text renderers. |
| `metadataRendererOutput: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/metadata/MetadataOutput!` | An output for metadata renderers. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer!>!` | The `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer`. |

### dump

```
fun dump(dumper: Dumper!): Unit
```

Dumps the fields of the object using the `dumper`.

| Parameters |
|---|---|
| `dumper: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Dumper!` | The `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Dumper` to be used to dump fields. |

### setTextRendererFactory

```
@CanIgnoreReturnValue
fun setTextRendererFactory(
    textRendererFactory: CapturingRenderersFactory.TextRendererFactory!
): CapturingRenderersFactory!
```

Sets the factory for `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/Renderer` instances that handle `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_TEXT()` tracks.

| Parameters |
|---|---|
| `textRendererFactory: https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.TextRendererFactory!` | The `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.TextRendererFactory`. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory!` | This factory, for convenience. |

## Protected functions

### createMediaCodecVideoRenderer

```
protected fun createMediaCodecVideoRenderer(
    eventHandler: Handler!,
    videoRendererEventListener: VideoRendererEventListener!
): MediaCodecVideoRenderer!
```

Returns new instance of a specialized `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer` that will not drop or skip buffers due to slow processing.

| Parameters |
|---|---|
| `eventHandler: https://developer.android.com/reference/android/os/Handler.html!` | A handler to use when invoking event listeners and outputs. |
| `videoRendererEventListener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoRendererEventListener!` | An event listener for video renderers. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer!` | a new instance of a specialized `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/MediaCodecVideoRenderer`. |

### getMediaCodecAdapterFactory

```
protected fun getMediaCodecAdapterFactory(): MediaCodecAdapter.Factory!
```

Returns the `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/CapturingRenderersFactory.CapturingMediaCodecAdapter.Factory` as a `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/mediacodec/MediaCodecAdapter.Factory`.

## Protected properties

### context

```
protected val context: Context!
```

### imageDecoderFactory

```
protected var imageDecoderFactory: ImageDecoder.Factory!
```