Added in API level 21

CodecException


class CodecException : IllegalStateException
kotlin.Any
   ↳ kotlin.Throwable
   ↳ java.lang.Exception
   ↳ java.lang.RuntimeException
   ↳ java.lang.IllegalStateException
   ↳ android.media.MediaCodec.CodecException

Thrown when an internal codec error occurs.

Summary

Constants
static Int

This indicates required resource was not able to be allocated.

static Int

This indicates the resource manager reclaimed the media resource used by the codec.

Public methods
String

Retrieve a developer-readable diagnostic information string associated with the exception.

Int

Retrieve the error code associated with a CodecException

Boolean

Returns true if the codec cannot proceed further, but can be recovered by stopping, configuring, and starting again.

Boolean

Returns true if the codec exception is a transient issue, perhaps due to resource constraints, and that the method (or encoding/decoding) may be retried at a later time.

Constants

ERROR_INSUFFICIENT_RESOURCE

Added in API level 23
static val ERROR_INSUFFICIENT_RESOURCE: Int

This indicates required resource was not able to be allocated.

Value: 1100

ERROR_RECLAIMED

Added in API level 23
static val ERROR_RECLAIMED: Int

This indicates the resource manager reclaimed the media resource used by the codec.

With this exception, the codec must be released, as it has moved to terminal state.

Value: 1101

Public methods

getDiagnosticInfo

Added in API level 21
fun getDiagnosticInfo(): String

Retrieve a developer-readable diagnostic information string associated with the exception. Do not show this to end-users, since this string will not be localized or generally comprehensible to end-users.

Return
String This value cannot be null.

getErrorCode

Added in API level 23
fun getErrorCode(): Int

Retrieve the error code associated with a CodecException

isRecoverable

Added in API level 21
fun isRecoverable(): Boolean

Returns true if the codec cannot proceed further, but can be recovered by stopping, configuring, and starting again.

isTransient

Added in API level 21
fun isTransient(): Boolean

Returns true if the codec exception is a transient issue, perhaps due to resource constraints, and that the method (or encoding/decoding) may be retried at a later time.