> Documentation index: https://developer.android.com/reference/llms.txt

# CodecDbEncoderDataset

Artifact: [androidx.media3:media3-transformer](https://developer.android.com/jetpack/androidx/releases/media3.md.txt) [View Source](https://cs.android.com/search?q=file:androidx/media3/transformer/codecdb/CodecDbEncoderDataset.java+class:androidx.media3.transformer.codecdb.CodecDbEncoderDataset)

*** ** * ** ***


```
@ExperimentalApi
public final class CodecDbEncoderDataset
```

<br />

*** ** * ** ***

A loaded dataset of CodecDB data that can be queried for expected quality or optimal settings.

Obtain instances via `CodecDbDatasetLoader`.

## Summary

| ### Public methods |
|---|---|
| `@Nullable VideoEncoderConfiguration` | `findOptimalConfiguration(VideoEncoderConstraints constraints)` Returns the optimal `VideoEncoderConfiguration` that satisfies the provided `VideoEncoderConstraints` based on the loaded CodecDB dataset (or its fallback provider), or `null` if no suitable configuration is found. |
| `double` | `predictQualityFor(VideoEncoderConfiguration videoEncoderConfiguration)` Attempts to predict the expected quality of the provided `VideoEncoderConfiguration`. |

## Public methods

### findOptimalConfiguration

```
public @Nullable VideoEncoderConfiguration findOptimalConfiguration(VideoEncoderConstraints constraints)
```

Returns the optimal `VideoEncoderConfiguration` that satisfies the provided `VideoEncoderConstraints` based on the loaded CodecDB dataset (or its fallback provider), or `null` if no suitable configuration is found.

Callers can obtain `VideoEncoderConstraints` for common encoding use cases from `VideoEncoderConstraintsPresets` (such as `forEditing`, `forHqCameraRecording`, or `forRealTimeCommunication`).

| Parameters |
|---|---|
| `VideoEncoderConstraints constraints` | The encoding constraints to optimize around. |

### predictQualityFor

```
public double predictQualityFor(VideoEncoderConfiguration videoEncoderConfiguration)
```

Attempts to predict the expected quality of the provided `VideoEncoderConfiguration`.

The predicted quality is on a \[0, 100\] scale, representing the Video Multi-method Assessment Fusion (VMAF) score. If no configuration in this dataset matches, the quality fallback provider is queried instead. Returns `NaN` if neither can predict a quality.

| Parameters |
|---|---|
| `VideoEncoderConfiguration videoEncoderConfiguration` | The configuration to predict quality for. |

| Returns |
|---|---|
| `double` | The predicted VMAF quality score, or `NaN` if unavailable. |

| Throws |
|---|---|
| `java.lang.IllegalArgumentException` | If the resolution or bitrate of ` videoEncoderConfiguration` is `NO_VALUE`. |