# DvbSubtitleReader

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

*** ** * ** ***


```
@UnstableApi
public final class DvbSubtitleReader implements ElementaryStreamReader
```

<br />

*** ** * ** ***

Parses DVB subtitle data and extracts individual frames.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#DvbSubtitleReader(java.util.List<androidx.media3.extractor.ts.TsPayloadReader.DvbSubtitleInfo>,java.lang.String)( https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.DvbSubtitleInfo> subtitleInfos, https://developer.android.com/reference/java/lang/String.html containerMimeType )` |

| ### Public methods |
|---|---|
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#consume(androidx.media3.common.util.ParsableByteArray)(https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray data)` Consumes (possibly partial) data from the current packet. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#createTracks(androidx.media3.extractor.ExtractorOutput,androidx.media3.extractor.ts.TsPayloadReader.TrackIdGenerator)( https://developer.android.com/reference/androidx/media3/extractor/ExtractorOutput extractorOutput, https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.TrackIdGenerator idGenerator )` Initializes the reader by providing outputs and ids for the tracks. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#packetFinished()()` Called when a PES packet ends. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#packetStarted(long,int)(long pesTimeUs, @https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.Flags int flags)` Called when a packet starts. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/DvbSubtitleReader#seek()()` Notifies the reader that a seek has occurred. |

| ### Inherited methods |
|---|
| From [androidx.media3.extractor.ts.ElementaryStreamReader](https://developer.android.com/reference/androidx/media3/extractor/ts/ElementaryStreamReader) |---|---| | `void` | `https://developer.android.com/reference/androidx/media3/extractor/ts/ElementaryStreamReader#endOfInputReached()()` Called when there will be no further packets (unless a seek occurs) because the stream ended. | |

## Public constructors

### DvbSubtitleReader

```
public DvbSubtitleReader(
    List<TsPayloadReader.DvbSubtitleInfo> subtitleInfos,
    String containerMimeType
)
```

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.DvbSubtitleInfo> subtitleInfos` | Information about the DVB subtitles associated to the stream. |
| `https://developer.android.com/reference/java/lang/String.html containerMimeType` | The MIME type of the container holding the stream. |

## Public methods

### consume

```
public void consume(ParsableByteArray data)
```

Consumes (possibly partial) data from the current packet.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray data` | The data to consume. |

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/ParserException` | If the data could not be parsed. |

### createTracks

```
public void createTracks(
    ExtractorOutput extractorOutput,
    TsPayloadReader.TrackIdGenerator idGenerator
)
```

Initializes the reader by providing outputs and ids for the tracks.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/extractor/ExtractorOutput extractorOutput` | The `https://developer.android.com/reference/androidx/media3/extractor/ExtractorOutput` that receives the extracted data. |
| `https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.TrackIdGenerator idGenerator` | A `https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.TrackIdGenerator` that generates unique track ids for the `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput`s. |

### packetFinished

```
public void packetFinished()
```

Called when a PES packet ends. For PES packets with an unset length, this is called when the next packet starts or the stream ends.

### packetStarted

```
public void packetStarted(long pesTimeUs, @TsPayloadReader.Flags int flags)
```

Called when a packet starts.

| Parameters |
|---|---|
| `long pesTimeUs` | The timestamp associated with the packet. |
| `@https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.Flags int flags` | See `https://developer.android.com/reference/androidx/media3/extractor/ts/TsPayloadReader.Flags`. |

### seek

```
public void seek()
```

Notifies the reader that a seek has occurred.