# MediaItem.SubtitleConfiguration

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

*** ** * ** ***


```
public class MediaItem.SubtitleConfiguration
```

<br />

Known direct subclasses [MediaItem.Subtitle](https://developer.android.com/reference/androidx/media3/common/MediaItem.Subtitle)

|---|---|
| `https://developer.android.com/reference/androidx/media3/common/MediaItem.Subtitle` | **This class is deprecated.** Use `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration` instead <br /> |

*** ** * ** ***

Properties for a text track.

## Summary

| ### Nested types |
|---|
| `public final class https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration.Builder` Builder for `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration` instances. |

| ### Public fields |
|---|---|
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#id()` The ID of the subtitles. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#label()` The label. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#language()` The language. |
| `final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#mimeType()` The optional MIME type of the subtitle file, or `null` if unspecified. |
| `final int` | `@https://developer.android.com/reference/androidx/media3/common/C.RoleFlags https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#roleFlags()` The role flags. |
| `final int` | `@https://developer.android.com/reference/androidx/media3/common/C.SelectionFlags https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#selectionFlags()` The selection flags. |
| `final long` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#timeOffsetUs()` The offset that is added to the timestamps of the cues in this subtitle track, in microseconds. |
| `final https://developer.android.com/reference/android/net/Uri.html` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#uri()` The `https://developer.android.com/reference/android/net/Uri.html` to the subtitle file. |

| ### Public methods |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration.Builder` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#buildUpon()()` Returns a `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration.Builder` initialized with the values of this instance. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#equals(java.lang.Object)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html obj)` |
| `static https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#fromBundle(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle.html bundle)` Restores a `SubtitleConfiguration` from a `https://developer.android.com/reference/android/os/Bundle.html`. |
| `int` | `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#hashCode()()` |
| `https://developer.android.com/reference/android/os/Bundle.html` | `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration#toBundle()()` |

## Public fields

### id

```
public final @Nullable String id
```

The ID of the subtitles. This will be propagated to the `https://developer.android.com/reference/androidx/media3/common/Format#id()` of the subtitle track created from this configuration.

### label

```
public final @Nullable String label
```

The label.

### language

```
public final @Nullable String language
```

The language.

### mimeType

```
public final @Nullable String mimeType
```

The optional MIME type of the subtitle file, or `null` if unspecified.

### roleFlags

```
@C.RoleFlags
public final int roleFlags
```

The role flags.

### selectionFlags

```
@C.SelectionFlags
public final int selectionFlags
```

The selection flags.

### timeOffsetUs

```
@UnstableApi
public final long timeOffsetUs
```

The offset that is added to the timestamps of the cues in this subtitle track, in microseconds. See `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration.Builder#setTimeOffsetUs(long)` for details.

### uri

```
public final Uri uri
```

The `https://developer.android.com/reference/android/net/Uri.html` to the subtitle file.

## Public methods

### buildUpon

```
public MediaItem.SubtitleConfiguration.Builder buildUpon()
```

Returns a `https://developer.android.com/reference/androidx/media3/common/MediaItem.SubtitleConfiguration.Builder` initialized with the values of this instance.

### equals

```
public boolean equals(@Nullable Object obj)
```

### fromBundle

```
@UnstableApi
public static MediaItem.SubtitleConfiguration fromBundle(Bundle bundle)
```

Restores a `SubtitleConfiguration` from a `https://developer.android.com/reference/android/os/Bundle.html`.

### hashCode

```
public int hashCode()
```

### toBundle

```
@UnstableApi
public Bundle toBundle()
```