# DecoderException

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

*** ** * ** ***


```
@UnstableApi
public class DecoderException extends Exception
```

<br />

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||||
| ↳ | [kotlin.Throwable](https://developer.android.com/reference/java/lang/Throwable.html) |||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception.html) ||
|   |   | ↳ | [androidx.media3.decoder.DecoderException](https://developer.android.com/reference/androidx/media3/decoder/DecoderException) |

Known direct subclasses [ImageDecoderException](https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageDecoderException), [MediaCodecDecoderException](https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecDecoderException), [SubtitleDecoderException](https://developer.android.com/reference/androidx/media3/extractor/text/SubtitleDecoderException)

|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/image/ImageDecoderException` | Thrown when an error occurs decoding image data. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/mediacodec/MediaCodecDecoderException` | Thrown when a failure occurs in a `https://developer.android.com/reference/android/media/MediaCodec.html` decoder. |
| `https://developer.android.com/reference/androidx/media3/extractor/text/SubtitleDecoderException` | Thrown when an error occurs decoding subtitle data. |

Known indirect subclasses [MediaCodecVideoDecoderException](https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoDecoderException)

|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/video/MediaCodecVideoDecoderException` | Thrown when a failure occurs in a `https://developer.android.com/reference/android/media/MediaCodec.html` video decoder. |

*** ** * ** ***

Thrown when a `https://developer.android.com/reference/androidx/media3/decoder/Decoder` error occurs.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderException#DecoderException(java.lang.Throwable)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Throwable.html cause)` Creates an instance. |
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderException#DecoderException(java.lang.String)(https://developer.android.com/reference/java/lang/String.html message)` Creates an instance. |
| `https://developer.android.com/reference/androidx/media3/decoder/DecoderException#DecoderException(java.lang.String,java.lang.Throwable)(https://developer.android.com/reference/java/lang/String.html message, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Throwable.html cause)` Creates an instance. |

### Inherited methods

From [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable.html) `synchronized final void` `https://developer.android.com/reference/java/lang/Throwable.html#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable.html exception)` `synchronized https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#fillInStackTrace()()` `synchronized https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#getCause()()` `https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/java/lang/Throwable.html#getLocalizedMessage()()` `https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/java/lang/Throwable.html#getMessage()()` `StackTraceElement[]` `https://developer.android.com/reference/java/lang/Throwable.html#getStackTrace()()` `synchronized final Throwable[]` `https://developer.android.com/reference/java/lang/Throwable.html#getSuppressed()()` `synchronized https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable.html cause)` `void` `https://developer.android.com/reference/java/lang/Throwable.html#printStackTrace()()` `void` `https://developer.android.com/reference/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[])(StackTraceElement[] stackTrace)` `https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/java/lang/Throwable.html#toString()()`

## Public constructors

### DecoderException

```
public DecoderException(@Nullable Throwable cause)
```

Creates an instance.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Throwable.html cause` | The cause of this exception, or `null`. |

### DecoderException

```
public DecoderException(String message)
```

Creates an instance.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html message` | The detail message for this exception. |

### DecoderException

```
public DecoderException(String message, @Nullable Throwable cause)
```

Creates an instance.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html message` | The detail message for this exception. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Throwable.html cause` | The cause of this exception, or `null`. |