ExoPlaybackException

Artifact: androidx.media3:media3-exoplayer

View Source

---

Kotlin |Java

class ExoPlaybackException : PlaybackException

kotlin.Any
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	androidx.media3.common.PlaybackException
			↳	androidx.media3.exoplayer.ExoPlaybackException

---

Thrown when a non locally recoverable playback failure occurs.

Summary

Nested types
@UnstableApi @Documented @Retention(value = RetentionPolicy.SOURCE) @Target(value = ) @IntDef(value = ) annotation ExoPlaybackException.Type The type of source that produced the error.

Constants
const Int	@UnstableApi TYPE_REMOTE = 3 The error occurred in a remote component.
const Int	@UnstableApi TYPE_RENDERER = 1 The error occurred in a Renderer.
const Int	@UnstableApi TYPE_SOURCE = 0 The error occurred loading data from a MediaSource.
const Int	@UnstableApi TYPE_UNEXPECTED = 2 The error was an unexpected RuntimeException.

Public functions
java-static ExoPlaybackException!	@UnstableApi createForRemote(message: String!) Creates an instance of type TYPE_REMOTE.
java-static ExoPlaybackException!	@UnstableApi createForRenderer(     cause: Throwable!,     rendererName: String!,     rendererIndex: Int,     rendererFormat: Format?,     @C.FormatSupport rendererFormatSupport: Int,     isRecoverable: Boolean,     @PlaybackException.ErrorCode errorCode: Int ) Creates an instance of type TYPE_RENDERER.
java-static ExoPlaybackException!	@UnstableApi createForSource(cause: IOException!, errorCode: Int) Creates an instance of type TYPE_SOURCE.
java-static ExoPlaybackException!	@UnstableApi createForUnexpected(cause: RuntimeException!) This function is deprecated. Use createForUnexpected(RuntimeException, ERROR_CODE_UNSPECIFIED) instead.
java-static ExoPlaybackException!	@UnstableApi createForUnexpected(     cause: RuntimeException!,     @PlaybackException.ErrorCode errorCode: Int ) Creates an instance of type TYPE_UNEXPECTED.
Boolean	errorInfoEquals(that: PlaybackException?) Returns whether the error data associated to this exception equals the error data associated to other.
java-static ExoPlaybackException!	@UnstableApi fromBundle(bundle: Bundle!) Restores a ExoPlaybackException from a Bundle.
Exception!	@UnstableApi getRendererException() Retrieves the underlying error when type is TYPE_RENDERER.
IOException!	@UnstableApi getSourceException() Retrieves the underlying error when type is TYPE_SOURCE.
RuntimeException!	@UnstableApi getUnexpectedException() Retrieves the underlying error when type is TYPE_UNEXPECTED.
Bundle!	@UnstableApi toBundle() Returns a representing the information stored in this exception.

Public properties
MediaSource.MediaPeriodId?	@UnstableApi mediaPeriodId The MediaPeriodId of the media associated with this error, or null if undetermined.
Format?	@UnstableApi 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	@UnstableApi @C.FormatSupport rendererFormatSupport If type is TYPE_RENDERER, this is the level of FormatSupport of the renderer for rendererFormat.
Int	@UnstableApi rendererIndex If type is TYPE_RENDERER, this is the index of the renderer.
String?	@UnstableApi rendererName If type is TYPE_RENDERER, this is the name of the renderer.
Int	@UnstableApi @ExoPlaybackException.Type type The Type of the playback failure.

Inherited Constants

From androidx.media3.common.PlaybackException const Int CUSTOM_ERROR_CODE_BASE = 1000000 Player implementations that want to surface custom errors can use error codes greater than this value, so as to avoid collision with other error codes defined in this class. const Int ERROR_CODE_AUDIO_TRACK_INIT_FAILED = 5001 Caused by an AudioTrack initialization failure. const Int ERROR_CODE_AUDIO_TRACK_OFFLOAD_INIT_FAILED = 5004 Caused by an AudioTrack init operation failure in offload mode. const Int ERROR_CODE_AUDIO_TRACK_OFFLOAD_WRITE_FAILED = 5003 Caused by an AudioTrack write operation failure in offload mode. const Int ERROR_CODE_AUDIO_TRACK_WRITE_FAILED = 5002 Caused by an AudioTrack write operation failure. const Int ERROR_CODE_AUTHENTICATION_EXPIRED = -102 Caused by expired authentication. const Int ERROR_CODE_BAD_VALUE = -3 Caused by an argument that is illegal. const Int ERROR_CODE_BEHIND_LIVE_WINDOW = 1002 Caused by the loading position falling behind the sliding window of available live content. const Int ERROR_CODE_CONCURRENT_STREAM_LIMIT = -104 Caused by too many concurrent streams. const Int ERROR_CODE_CONTENT_ALREADY_PLAYING = -110 Caused by a request for content that was already playing. const Int ERROR_CODE_DECODER_INIT_FAILED = 4001 Caused by a decoder initialization failure. const Int ERROR_CODE_DECODER_QUERY_FAILED = 4002 Caused by a decoder query failure. const Int ERROR_CODE_DECODING_FAILED = 4003 Caused by a failure while trying to decode media samples. const Int ERROR_CODE_DECODING_FORMAT_EXCEEDS_CAPABILITIES = 4004 Caused by trying to decode content whose format exceeds the capabilities of the device. const Int ERROR_CODE_DECODING_FORMAT_UNSUPPORTED = 4005 Caused by trying to decode content whose format is not supported. const Int @UnstableApi ERROR_CODE_DECODING_RESOURCES_RECLAIMED = 4006 Caused by higher priority task reclaiming resources needed for decoding. const Int ERROR_CODE_DISCONNECTED = -100 Caused by a disconnected component. const Int ERROR_CODE_DRM_CONTENT_ERROR = 6003 Caused by attempting to play incompatible DRM-protected content. const Int ERROR_CODE_DRM_DEVICE_REVOKED = 6007 Caused by the device having revoked DRM privileges. const Int ERROR_CODE_DRM_DISALLOWED_OPERATION = 6005 Caused by an operation being disallowed by a license policy. const Int ERROR_CODE_DRM_LICENSE_ACQUISITION_FAILED = 6004 Caused by a failure while trying to obtain a license. const Int ERROR_CODE_DRM_LICENSE_EXPIRED = 6008 Caused by an expired DRM license being loaded into an open DRM session. const Int ERROR_CODE_DRM_PROVISIONING_FAILED = 6002 Caused by a failure while provisioning the device. const Int ERROR_CODE_DRM_SCHEME_UNSUPPORTED = 6001 Caused by a chosen DRM protection scheme not being supported by the device. const Int ERROR_CODE_DRM_SYSTEM_ERROR = 6006 Caused by an error in the DRM system. const Int ERROR_CODE_DRM_UNSPECIFIED = 6000 Caused by an unspecified error related to DRM protection. const Int ERROR_CODE_END_OF_PLAYLIST = -109 Caused by navigation that failed because the playlist was exhausted. const Int ERROR_CODE_FAILED_RUNTIME_CHECK = 1004 Caused by a failed runtime check. const Int ERROR_CODE_INVALID_STATE = -2 Caused by a command that cannot be completed because the current state is not valid. const Int ERROR_CODE_IO_BAD_HTTP_STATUS = 2004 Caused by an HTTP server returning an unexpected HTTP response status code. const Int ERROR_CODE_IO_CLEARTEXT_NOT_PERMITTED = 2007 Caused by the player trying to access cleartext HTTP traffic (meaning http:// rather than https://) when the app's Network Security Configuration does not permit it. const Int ERROR_CODE_IO_FILE_NOT_FOUND = 2005 Caused by a non-existent file. const Int ERROR_CODE_IO_INVALID_HTTP_CONTENT_TYPE = 2003 Caused by a server returning a resource with an invalid "Content-Type" HTTP header value. const Int ERROR_CODE_IO_NETWORK_CONNECTION_FAILED = 2001 Caused by a network connection failure. const Int ERROR_CODE_IO_NETWORK_CONNECTION_TIMEOUT = 2002 Caused by a network timeout, meaning the server is taking too long to fulfill a request. const Int ERROR_CODE_IO_NO_PERMISSION = 2006 Caused by lack of permission to perform an IO operation. const Int ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE = 2008 Caused by reading data out of the data bound. const Int ERROR_CODE_IO_UNSPECIFIED = 2000 Caused by an Input/Output error which could not be identified. const Int ERROR_CODE_NOT_AVAILABLE_IN_REGION = -106 Caused by the content being blocked due to being regionally unavailable. const Int ERROR_CODE_NOT_SUPPORTED = -6 Caused by a command that is not supported. const Int ERROR_CODE_PARENTAL_CONTROL_RESTRICTED = -105 Caused by the content being blocked due to parental controls. const Int ERROR_CODE_PARSING_CONTAINER_MALFORMED = 3001 Caused by a parsing error associated with a media container format bitstream. const Int ERROR_CODE_PARSING_CONTAINER_UNSUPPORTED = 3003 Caused by attempting to extract a file with an unsupported media container format, or an unsupported media container feature. const Int ERROR_CODE_PARSING_MANIFEST_MALFORMED = 3002 Caused by a parsing error associated with a media manifest. const Int ERROR_CODE_PARSING_MANIFEST_UNSUPPORTED = 3004 Caused by an unsupported feature in a media manifest. const Int ERROR_CODE_PERMISSION_DENIED = -4 Caused by a command that is not allowed. const Int ERROR_CODE_PREMIUM_ACCOUNT_REQUIRED = -103 Caused by a premium account that is required but the user is not subscribed. const Int ERROR_CODE_REMOTE_ERROR = 1001 Caused by an unidentified error in a remote Player, which is a Player that runs on a different host or process. const Int ERROR_CODE_SETUP_REQUIRED = -108 Caused by playback that needs manual user intervention. const Int ERROR_CODE_SKIP_LIMIT_REACHED = -107 Caused by the skip limit that is exhausted. const Int ERROR_CODE_TIMEOUT = 1003 Caused by a generic timeout. const Int ERROR_CODE_UNSPECIFIED = 1000 Caused by an error whose cause could not be identified. const Int @UnstableApi ERROR_CODE_VIDEO_FRAME_PROCESSING_FAILED = 7001 Caused by a failure when processing a video frame. const Int @UnstableApi ERROR_CODE_VIDEO_FRAME_PROCESSOR_INIT_FAILED = 7000 Caused by a failure when initializing a VideoFrameProcessor. const Int @UnstableApi FIELD_CUSTOM_ID_BASE = 1000 Defines a minimum field ID value for subclasses to use when implementing toBundle and delegating to PlaybackException.

Inherited functions
From androidx.media3.common.PlaybackException java-static PlaybackException! @UnstableApi fromBundle(bundle: Bundle!) Restores a PlaybackException from a Bundle. String! getErrorCodeName() Equivalent to PlaybackException.getErrorCodeName(this.errorCode). java-static String! getErrorCodeName(@PlaybackException.ErrorCode errorCode: Int) Returns the name of a given errorCode.
From java.lang.Throwable synchronized Unit addSuppressed(exception: Throwable!) synchronized Throwable! fillInStackTrace() synchronized Throwable! getCause() String! getLocalizedMessage() String! getMessage() Array<StackTraceElement!>! getStackTrace() synchronized Array<Throwable!>! getSuppressed() synchronized Throwable! initCause(cause: Throwable!) Unit printStackTrace() Unit setStackTrace(stackTrace: Array<StackTraceElement!>!) String! toString()

Inherited properties
From androidx.media3.common.PlaybackException Int @PlaybackException.ErrorCode errorCode An error code which identifies the cause of the playback failure. Bundle! @UnstableApi extras An extras Bundle. Long timestampMs The value of elapsedRealtime when this exception was created.

Constants

TYPE_REMOTE

@UnstableApi
const val TYPE_REMOTE = 3: Int

The error occurred in a remote component.

Call getMessage to retrieve the message associated with the error.

TYPE_RENDERER

@UnstableApi
const val TYPE_RENDERER = 1: Int

The error occurred in a Renderer.

Call getRendererException to retrieve the underlying cause.

TYPE_SOURCE

@UnstableApi
const val TYPE_SOURCE = 0: Int

The error occurred loading data from a MediaSource.

Call getSourceException to retrieve the underlying cause.

TYPE_UNEXPECTED

@UnstableApi
const val TYPE_UNEXPECTED = 2: Int

The error was an unexpected RuntimeException.

Call getUnexpectedException to retrieve the underlying cause.

Public functions

createForRemote

@UnstableApi
java-static fun createForRemote(message: String!): ExoPlaybackException!

Creates an instance of type TYPE_REMOTE.

Parameters
message: String!	The message associated with the error.

Returns
ExoPlaybackException!	The created instance.

createForRenderer

@UnstableApi
java-static fun createForRenderer(
    cause: Throwable!,
    rendererName: String!,
    rendererIndex: Int,
    rendererFormat: Format?,
    @C.FormatSupport rendererFormatSupport: Int,
    isRecoverable: Boolean,
    @PlaybackException.ErrorCode errorCode: Int
): ExoPlaybackException!

Creates an instance of type TYPE_RENDERER.

Parameters
cause: Throwable!	The cause of the failure.
rendererName: String!	The name of the renderer in which the failure occurred.
rendererIndex: Int	The index of the renderer in which the failure occurred.
rendererFormat: Format?	The Format the renderer was using at the time of the exception, or null if the renderer wasn't using a Format.
@C.FormatSupport rendererFormatSupport: Int	The FormatSupport of the renderer for rendererFormat. Ignored if rendererFormat is null.
isRecoverable: Boolean	If the failure can be recovered by disabling and re-enabling the renderer.
@PlaybackException.ErrorCode errorCode: Int	See errorCode.

Returns
ExoPlaybackException!	The created instance.

createForSource

@UnstableApi
java-static fun createForSource(cause: IOException!, errorCode: Int): ExoPlaybackException!

Creates an instance of type TYPE_SOURCE.

Parameters
cause: IOException!	The cause of the failure.
errorCode: Int	See errorCode.

Returns
ExoPlaybackException!	The created instance.

createForUnexpected

@UnstableApi
java-static fun createForUnexpected(cause: RuntimeException!): ExoPlaybackException!

This function is deprecated.

Use createForUnexpected(RuntimeException, ERROR_CODE_UNSPECIFIED) instead.

createForUnexpected

@UnstableApi
java-static fun createForUnexpected(
    cause: RuntimeException!,
    @PlaybackException.ErrorCode errorCode: Int
): ExoPlaybackException!

Creates an instance of type TYPE_UNEXPECTED.

Parameters
cause: RuntimeException!	The cause of the failure.
@PlaybackException.ErrorCode errorCode: Int	See errorCode.

Returns
ExoPlaybackException!	The created instance.

errorInfoEquals

fun errorInfoEquals(that: PlaybackException?): Boolean

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.

fromBundle

@UnstableApi
java-static fun fromBundle(bundle: Bundle!): ExoPlaybackException!

Restores a ExoPlaybackException from a Bundle.

getRendererException

@UnstableApi
fun getRendererException(): Exception!

Retrieves the underlying error when type is TYPE_RENDERER.

Throws
java.lang.IllegalStateException	If type is not TYPE_RENDERER.

getSourceException

@UnstableApi
fun getSourceException(): IOException!

Retrieves the underlying error when type is TYPE_SOURCE.

Throws
java.lang.IllegalStateException	If type is not TYPE_SOURCE.

getUnexpectedException

@UnstableApi
fun getUnexpectedException(): RuntimeException!

Retrieves the underlying error when type is TYPE_UNEXPECTED.

Throws
java.lang.IllegalStateException	If type is not TYPE_UNEXPECTED.

toBundle

@UnstableApi
fun toBundle(): Bundle!

Returns a representing the information stored in this exception.

It omits the mediaPeriodId field. The mediaPeriodId of an instance restored by fromBundle will always be null.

Public properties

mediaPeriodId

@UnstableApi
val mediaPeriodId: MediaSource.MediaPeriodId?

The MediaPeriodId of the media associated with this error, or null if undetermined.

rendererFormat

@UnstableApi
val rendererFormat: Format?

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

@UnstableApi
@C.FormatSupport
val rendererFormatSupport: Int

If type is TYPE_RENDERER, this is the level of FormatSupport of the renderer for rendererFormat. If rendererFormat is null, this is FORMAT_HANDLED.

rendererIndex

@UnstableApi
val rendererIndex: Int

If type is TYPE_RENDERER, this is the index of the renderer.

rendererName

@UnstableApi
val rendererName: String?

If type is TYPE_RENDERER, this is the name of the renderer.

type

@UnstableApi
@ExoPlaybackException.Type
val type: Int

The Type of the playback failure.