# SubtitleTranscodingExtractorOutput

# SubtitleTranscodingExtractorOutput

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

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput "View this page in Java")

<br />

```
@UnstableApi
class SubtitleTranscodingExtractorOutput : ExtractorOutput
```

<br />

*** ** * ** ***

A wrapping[ExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput)that transcodes[text samples](https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_TEXT())from supported subtitle formats to[APPLICATION_MEDIA3_CUES](https://developer.android.com/reference/kotlin/androidx/media3/common/MimeTypes#APPLICATION_MEDIA3_CUES()).

The resulting[APPLICATION_MEDIA3_CUES](https://developer.android.com/reference/kotlin/androidx/media3/common/MimeTypes#APPLICATION_MEDIA3_CUES())samples are emitted to the underlying[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput).

For non-text tracks (i.e. where[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)is not`C.TRACK_TYPE_TEXT`), samples are passed through to the underlying[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)without modification.

Support for subtitle formats is determined by[supportsFormat](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleParser.Factory#supportsFormat(androidx.media3.common.Format))on the[SubtitleParser.Factory](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleParser.Factory)passed to the constructor of this class.

## Summary

|                                                                                                                                                                                                                                                                                  ### Public constructors                                                                                                                                                                                                                                                                                   |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [SubtitleTranscodingExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput#SubtitleTranscodingExtractorOutput(androidx.media3.extractor.ExtractorOutput,androidx.media3.extractor.text.SubtitleParser.Factory))`(` ` delegate: `[ExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput)`!,` ` subtitleParserFactory: `[SubtitleParser.Factory](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleParser.Factory)`!` `)` |

|                                          ### Public functions                                          |
|--------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)                          | [endTracks](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput#endTracks())`()` Called when all tracks have been identified, meaning no new`trackId`values will be passed to[track](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput#track(int,int)).                                                                                                                                                                                                                                                                                                           |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)                          | [resetSubtitleParsers](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput#resetSubtitleParsers())`()`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)                          | [seekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput#seekMap(androidx.media3.extractor.SeekMap))`(seekMap: `[SeekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/SeekMap)`!)` Called when a[SeekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/SeekMap)has been extracted from the stream.                                                                                                                                                                                                                                         |
| [TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)`!` | [track](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleTranscodingExtractorOutput#track(int,int))`(id: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`, @`[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)` type: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called by the[Extractor](https://developer.android.com/reference/kotlin/androidx/media3/extractor/Extractor)to get the[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)for a specific track. |

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  ### Inherited Constants                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From[androidx.media3.extractor.ExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput) |------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `const `[ExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput)`!` | [PLACEHOLDER](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput#PLACEHOLDER()) Placeholder[ExtractorOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput)implementation throwing an[UnsupportedOperationException](https://developer.android.com/reference/java/lang/UnsupportedOperationException.html)in each method. | |

## Public constructors

### SubtitleTranscodingExtractorOutput

```
SubtitleTranscodingExtractorOutput(
    delegate: ExtractorOutput!,
    subtitleParserFactory: SubtitleParser.Factory!
)
```  

## Public functions

### endTracks

```
fun endTracks(): Unit
```

Called when all tracks have been identified, meaning no new`trackId`values will be passed to[track](https://developer.android.com/reference/kotlin/androidx/media3/extractor/ExtractorOutput#track(int,int)).  

### resetSubtitleParsers

```
fun resetSubtitleParsers(): Unit
```  

### seekMap

```
fun seekMap(seekMap: SeekMap!): Unit
```

Called when a[SeekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/SeekMap)has been extracted from the stream.  

|                                                Parameters                                                 |
|-----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|
| `seekMap: `[SeekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/SeekMap)`!` | The extracted[SeekMap](https://developer.android.com/reference/kotlin/androidx/media3/extractor/SeekMap). |

### track

```
fun track(id: Int, @C.TrackType type: Int): TrackOutput!
```

Called by the[Extractor](https://developer.android.com/reference/kotlin/androidx/media3/extractor/Extractor)to get the[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)for a specific track.

The same[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)is returned if multiple calls are made with the same`
id`.  

|                                                                                       Parameters                                                                                        |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|
| `id: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)                                                                                                       | A track identifier.                                                                                 |
| `@`[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)` type: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The[track type](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType). |

|                                                Returns                                                 |
|--------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| [TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)`!` | The[TrackOutput](https://developer.android.com/reference/kotlin/androidx/media3/extractor/TrackOutput)for the given track identifier. |