# SubtitleDecoderFactory

# SubtitleDecoderFactory

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

*** ** * ** ***

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

<br />

```
@UnstableApi
interface SubtitleDecoderFactory
```

<br />

*** ** * ** ***

A factory for[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)instances.

## Summary

|                                                               ### Constants                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `const `[SubtitleDecoderFactory](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory)`!` | [DEFAULT](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory#DEFAULT()) Default[SubtitleDecoderFactory](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory)implementation. |

|                                                ### Public functions                                                 |
|---------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)`!` | [createDecoder](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory#createDecoder(androidx.media3.common.Format))`(format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!)` Creates a[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)for the given[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format).                                              |
| [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)                                 | [supportsFormat](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory#supportsFormat(androidx.media3.common.Format))`(format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!)` Returns whether the factory is able to instantiate a[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)for the given[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format). |

## Constants

### DEFAULT

```
const val DEFAULT: SubtitleDecoderFactory!
```

Default[SubtitleDecoderFactory](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/text/SubtitleDecoderFactory)implementation.

Supports formats supported by[DefaultSubtitleParserFactory](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/DefaultSubtitleParserFactory)as well as the following:

- Cea608 ([Cea608Decoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/cea/Cea608Decoder))
- Cea708 ([Cea708Decoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/cea/Cea708Decoder))  

## Public functions

### createDecoder

```
fun createDecoder(format: Format!): SubtitleDecoder!
```

Creates a[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)for the given[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format).  

|                                             Parameters                                              |
|-----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| `format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!` | The[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format). |

|                                                       Returns                                                       |
|---------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| [SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)`!` | A new[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder). |

|                                                        Throws                                                         |
|-----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|
| [java.lang.IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException.html) | If the[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)is not supported. |

### supportsFormat

```
fun supportsFormat(format: Format!): Boolean
```

Returns whether the factory is able to instantiate a[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder)for the given[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format).  

|                                             Parameters                                              |
|-----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| `format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!` | The[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format). |

|                                       Returns                                       |
|-------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html) | Whether the factory can instantiate a suitable[SubtitleDecoder](https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/SubtitleDecoder). |