java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - com.google.android.exoplayer2.PlaybackException
    - - com.google.android.exoplayer2.ExoPlaybackException

All Implemented Interfaces:

Bundleable, Serializable
```
public final class ExoPlaybackException
extends PlaybackException
```
Thrown when a non locally recoverable playback failure occurs.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static interface ExoPlaybackException.Type
The type of source that produced the error.
- Nested classes/interfaces inherited from class com.google.android.exoplayer2.PlaybackException
  PlaybackException.ErrorCode, PlaybackException.FieldNumber
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Bundleable
  Bundleable.Creator<T extends Bundleable>

Field Summary

Fields
Modifier and Type	Field	Description
`static Bundleable.Creator<ExoPlaybackException>`	`CREATOR`	Object that can restore `ExoPlaybackException` from a `Bundle`.
`MediaPeriodId`	`mediaPeriodId`	The `MediaPeriodId` of the media associated with this error, or null if undetermined.
`Format`	`rendererFormat`	If `type` is `TYPE_RENDERER`, this is the `Format` the renderer was using at the time of the exception, or null if the renderer wasn't using a `Format`.
`int`	`rendererFormatSupport`	If `type` is `TYPE_RENDERER`, this is the level of `C.FormatSupport` of the renderer for `rendererFormat`.
`int`	`rendererIndex`	If `type` is `TYPE_RENDERER`, this is the index of the renderer.
`String`	`rendererName`	If `type` is `TYPE_RENDERER`, this is the name of the renderer.
`int`	`type`	The `ExoPlaybackException.Type` of the playback failure.
`static int`	`TYPE_REMOTE`	The error occurred in a remote component.
`static int`	`TYPE_RENDERER`	The error occurred in a `Renderer`.
`static int`	`TYPE_SOURCE`	The error occurred loading data from a `MediaSource`.
`static int`	`TYPE_UNEXPECTED`	The error was an unexpected `RuntimeException`.

Fields inherited from class com.google.android.exoplayer2.PlaybackException
CUSTOM_ERROR_CODE_BASE, ERROR_CODE_AUDIO_TRACK_INIT_FAILED, ERROR_CODE_AUDIO_TRACK_WRITE_FAILED, ERROR_CODE_BEHIND_LIVE_WINDOW, ERROR_CODE_DECODER_INIT_FAILED, ERROR_CODE_DECODER_QUERY_FAILED, ERROR_CODE_DECODING_FAILED, ERROR_CODE_DECODING_FORMAT_EXCEEDS_CAPABILITIES, ERROR_CODE_DECODING_FORMAT_UNSUPPORTED, ERROR_CODE_DRM_CONTENT_ERROR, ERROR_CODE_DRM_DEVICE_REVOKED, ERROR_CODE_DRM_DISALLOWED_OPERATION, ERROR_CODE_DRM_LICENSE_ACQUISITION_FAILED, ERROR_CODE_DRM_LICENSE_EXPIRED, ERROR_CODE_DRM_PROVISIONING_FAILED, ERROR_CODE_DRM_SCHEME_UNSUPPORTED, ERROR_CODE_DRM_SYSTEM_ERROR, ERROR_CODE_DRM_UNSPECIFIED, ERROR_CODE_FAILED_RUNTIME_CHECK, ERROR_CODE_IO_BAD_HTTP_STATUS, ERROR_CODE_IO_CLEARTEXT_NOT_PERMITTED, ERROR_CODE_IO_FILE_NOT_FOUND, ERROR_CODE_IO_INVALID_HTTP_CONTENT_TYPE, ERROR_CODE_IO_NETWORK_CONNECTION_FAILED, ERROR_CODE_IO_NETWORK_CONNECTION_TIMEOUT, ERROR_CODE_IO_NO_PERMISSION, ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE, ERROR_CODE_IO_UNSPECIFIED, ERROR_CODE_PARSING_CONTAINER_MALFORMED, ERROR_CODE_PARSING_CONTAINER_UNSUPPORTED, ERROR_CODE_PARSING_MANIFEST_MALFORMED, ERROR_CODE_PARSING_MANIFEST_UNSUPPORTED, ERROR_CODE_REMOTE_ERROR, ERROR_CODE_TIMEOUT, ERROR_CODE_UNSPECIFIED, errorCode, FIELD_CUSTOM_ID_BASE, timestampMs

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`static ExoPlaybackException`	`createForRemote(String message)`	Creates an instance of type `TYPE_REMOTE`.
`static ExoPlaybackException`	`createForRenderer(Throwable cause, String rendererName, int rendererIndex, Format rendererFormat, int rendererFormatSupport, boolean isRecoverable, @com.google.android.exoplayer2.PlaybackException.ErrorCode int errorCode)`	Creates an instance of type `TYPE_RENDERER`.
`static ExoPlaybackException`	`createForSource(IOException cause, int errorCode)`	Creates an instance of type `TYPE_SOURCE`.
`static ExoPlaybackException`	`createForUnexpected(RuntimeException cause)`	Deprecated. Use `createForUnexpected(RuntimeException, ERROR_CODE_UNSPECIFIED)` instead.
`static ExoPlaybackException`	`createForUnexpected(RuntimeException cause, @com.google.android.exoplayer2.PlaybackException.ErrorCode int errorCode)`	Creates an instance of type `TYPE_UNEXPECTED`.
`boolean`	`errorInfoEquals(PlaybackException that)`	Returns whether the error data associated to this exception equals the error data associated to `other`.
`Exception`	`getRendererException()`	Retrieves the underlying error when `type` is `TYPE_RENDERER`.
`IOException`	`getSourceException()`	Retrieves the underlying error when `type` is `TYPE_SOURCE`.
`RuntimeException`	`getUnexpectedException()`	Retrieves the underlying error when `type` is `TYPE_UNEXPECTED`.
`Bundle`	`toBundle()`	Returns a `Bundle` representing the information stored in this object.

Methods inherited from class com.google.android.exoplayer2.PlaybackException
getErrorCodeName, getErrorCodeName, keyForField

Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - TYPE_SOURCE
```
public static final int TYPE_SOURCE
```
    The error occurred loading data from a MediaSource.
    Call getSourceException() to retrieve the underlying cause.
    
    See Also:
    
    Constant Field Values
  - TYPE_RENDERER
```
public static final int TYPE_RENDERER
```
    The error occurred in a Renderer.
    Call getRendererException() to retrieve the underlying cause.
    
    See Also:
    
    Constant Field Values
  - TYPE_UNEXPECTED
```
public static final int TYPE_UNEXPECTED
```
    The error was an unexpected RuntimeException.
    Call getUnexpectedException() to retrieve the underlying cause.
    
    See Also:
    
    Constant Field Values
  - TYPE_REMOTE
```
public static final int TYPE_REMOTE
```
    The error occurred in a remote component.
    Call Throwable.getMessage() to retrieve the message associated with the error.
    
    See Also:
    
    Constant Field Values
  - type
```
@Type
public final int type
```
    The ExoPlaybackException.Type of the playback failure.
  - rendererName
```
@Nullable
public final String rendererName
```
    If type is TYPE_RENDERER, this is the name of the renderer.
  - rendererIndex
```
public final int rendererIndex
```
    If type is TYPE_RENDERER, this is the index of the renderer.
  - rendererFormat
```
@Nullable
public final Format rendererFormat
```
    If type is TYPE_RENDERER, this is the Format the renderer was using at the time of the exception, or null if the renderer wasn't using a Format.
  - rendererFormatSupport
```
@FormatSupport
public final int rendererFormatSupport
```
    If type is TYPE_RENDERER, this is the level of C.FormatSupport of the renderer for rendererFormat. If rendererFormat is null, this is C.FORMAT_HANDLED.
  - mediaPeriodId
```
@Nullable
public final MediaPeriodId mediaPeriodId
```
    The MediaPeriodId of the media associated with this error, or null if undetermined.
  - CREATOR
```
public static final Bundleable.Creator<ExoPlaybackException> CREATOR
```
    Object that can restore ExoPlaybackException from a Bundle.
- Method Detail
  - createForSource
```
public static ExoPlaybackException createForSource(IOException cause,
                                                   int errorCode)
```
    Creates an instance of type TYPE_SOURCE.
    
    Parameters:
    
    cause - The cause of the failure.
    
    errorCode - See PlaybackException.errorCode.
    
    Returns:
    
    The created instance.
  - createForRenderer
```
public static ExoPlaybackException createForRenderer(Throwable cause,
                                                     String rendererName,
                                                     int rendererIndex,
                                                     @Nullable
                                                     Format rendererFormat,
                                                     @FormatSupport
                                                     int rendererFormatSupport,
                                                     boolean isRecoverable,
                                                     @ErrorCode
                                                     @com.google.android.exoplayer2.PlaybackException.ErrorCode int errorCode)
```
    Creates an instance of type TYPE_RENDERER.
    
    Parameters:
    
    cause - The cause of the failure.
    
    rendererIndex - The index of the renderer in which the failure occurred.
    
    rendererFormat - The Format the renderer was using at the time of the exception, or null if the renderer wasn't using a Format.
    
    rendererFormatSupport - The C.FormatSupport of the renderer for rendererFormat. Ignored if rendererFormat is null.
    
    isRecoverable - If the failure can be recovered by disabling and re-enabling the renderer.
    
    errorCode - See PlaybackException.errorCode.
    
    Returns:
    
    The created instance.
  - createForUnexpected
```
@Deprecated
public static ExoPlaybackException createForUnexpected(RuntimeException cause)
```
    Deprecated.
    Use createForUnexpected(RuntimeException, ERROR_CODE_UNSPECIFIED) instead.
  - createForUnexpected
```
public static ExoPlaybackException createForUnexpected(RuntimeException cause,
                                                       @ErrorCode
                                                       @com.google.android.exoplayer2.PlaybackException.ErrorCode int errorCode)
```
    Creates an instance of type TYPE_UNEXPECTED.
    
    Parameters:
    
    cause - The cause of the failure.
    
    errorCode - See PlaybackException.errorCode.
    
    Returns:
    
    The created instance.
  - createForRemote
```
public static ExoPlaybackException createForRemote(String message)
```
    Creates an instance of type TYPE_REMOTE.
    
    Parameters:
    
    message - The message associated with the error.
    
    Returns:
    
    The created instance.
  - getSourceException
```
public IOException getSourceException()
```
    Retrieves the underlying error when type is TYPE_SOURCE.
    
    Throws:
    
    IllegalStateException - If type is not TYPE_SOURCE.
  - getRendererException
```
public Exception getRendererException()
```
    Retrieves the underlying error when type is TYPE_RENDERER.
    
    Throws:
    
    IllegalStateException - If type is not TYPE_RENDERER.
  - getUnexpectedException
```
public RuntimeException getUnexpectedException()
```
    Retrieves the underlying error when type is TYPE_UNEXPECTED.
    
    Throws:
    
    IllegalStateException - If type is not TYPE_UNEXPECTED.
  - errorInfoEquals
```
public boolean errorInfoEquals(@Nullable
                               PlaybackException that)
```
    Description copied from class: PlaybackException
    
    Returns whether the error data associated to this exception equals the error data associated to other.
    Note that this method does not compare the exceptions' stacktraces.
    
    Overrides:
    
    errorInfoEquals in class PlaybackException
  - toBundle
```
public Bundle toBundle()
```
    Returns a Bundle representing the information stored in this object.
    It omits the mediaPeriodId field. The mediaPeriodId of an instance restored by CREATOR will always be null.
    
    Specified by:
    
    toBundle in interface Bundleable
    
    Overrides:
    
    toBundle in class PlaybackException

Class ExoPlaybackException

Nested Class Summary

Nested classes/interfaces inherited from class com.google.android.exoplayer2.PlaybackException

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Bundleable

Field Summary

Fields inherited from class com.google.android.exoplayer2.PlaybackException

Method Summary

Methods inherited from class com.google.android.exoplayer2.PlaybackException

Methods inherited from class java.lang.Throwable

Methods inherited from class java.lang.Object

Field Detail

TYPE_SOURCE

TYPE_RENDERER

TYPE_UNEXPECTED

TYPE_REMOTE

type

rendererName

rendererIndex

rendererFormat

rendererFormatSupport

mediaPeriodId

CREATOR

Method Detail

createForSource

createForRenderer

createForUnexpected

createForUnexpected

createForRemote

getSourceException

getRendererException

getUnexpectedException

errorInfoEquals

toBundle