# DtsReader

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/DtsReader.java+class:androidx.media3.extractor.ts.DtsReader)

*** ** * ** ***


```
@UnstableApi
class DtsReader : ElementaryStreamReader
```

<br />

*** ** * ** ***

Parses a continuous DTS or DTS UHD byte stream and extracts individual samples.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#DtsReader(java.lang.String,int,int,java.lang.String)( language: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html?, @https://developer.android.com/reference/kotlin/androidx/media3/common/C.RoleFlags roleFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html, maxHeaderSize: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html, containerMimeType: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html! )` Constructs a new reader for DTS elementary streams. |

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#consume(androidx.media3.common.util.ParsableByteArray)(data: https://developer.android.com/reference/kotlin/androidx/media3/common/util/ParsableByteArray!)` Consumes (possibly partial) data from the current packet. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#createTracks(androidx.media3.extractor.ExtractorOutput,androidx.media3.extractor.ts.TsPayloadReader.TrackIdGenerator)( extractorOutput: https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput!, idGenerator: https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/TsPayloadReader.TrackIdGenerator! )` Initializes the reader by providing outputs and ids for the tracks. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#endOfInputReached()()` Called when there will be no further packets (unless a seek occurs) because the stream ended. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#packetStarted(long,int)(pesTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, @https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/TsPayloadReader.Flags flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Called when a packet starts. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/DtsReader#seek()()` Notifies the reader that a seek has occurred. |

| ### Inherited functions |
|---|
| From [androidx.media3.extractor.ts.ElementaryStreamReader](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/ElementaryStreamReader) |---|---| | `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/ElementaryStreamReader#packetFinished()()` Called when a PES packet ends. | |

## Public constructors

### DtsReader

```
DtsReader(
    language: String?,
    @C.RoleFlags roleFlags: Int,
    maxHeaderSize: Int,
    containerMimeType: String!
)
```

Constructs a new reader for DTS elementary streams.

| Parameters |
|---|---|
| `language: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html?` | Track language. |
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/C.RoleFlags roleFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | Track role flags. |
| `maxHeaderSize: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | Maximum size of the header in a frame. |
| `containerMimeType: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The MIME type of the container holding the stream. |

## Public functions

### consume

```
fun consume(data: ParsableByteArray!): Unit
```

Consumes (possibly partial) data from the current packet.

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

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

### createTracks

```
fun createTracks(
    extractorOutput: ExtractorOutput!,
    idGenerator: TsPayloadReader.TrackIdGenerator!
): Unit
```

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

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

### endOfInputReached

```
fun endOfInputReached(): Unit
```

Called when there will be no further packets (unless a seek occurs) because the stream ended.

### packetStarted

```
fun packetStarted(pesTimeUs: Long, @TsPayloadReader.Flags flags: Int): Unit
```

Called when a packet starts.

| Parameters |
|---|---|
| `pesTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The timestamp associated with the packet. |
| `@https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/TsPayloadReader.Flags flags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | See `https://developer.android.com/reference/kotlin/androidx/media3/extractor/ts/TsPayloadReader.Flags`. |

### seek

```
fun seek(): Unit
```

Notifies the reader that a seek has occurred.