Most visited

Recently visited

Added in API level 21

MediaCodec.CodecException

public static final class MediaCodec.CodecException
extends IllegalStateException

java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.lang.RuntimeException
         ↳ java.lang.IllegalStateException
           ↳ android.media.MediaCodec.CodecException


Thrown when an internal codec error occurs.

Summary

Constants

int ERROR_INSUFFICIENT_RESOURCE

This indicates required resource was not able to be allocated.

int ERROR_RECLAIMED

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

Public methods

String getDiagnosticInfo()

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

int getErrorCode()

Retrieve the error code associated with a CodecException

boolean isRecoverable()

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

boolean isTransient()

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.

Inherited methods

From class java.lang.Throwable
From class java.lang.Object

Constants

ERROR_INSUFFICIENT_RESOURCE

Added in API level 23
int ERROR_INSUFFICIENT_RESOURCE

This indicates required resource was not able to be allocated.

Constant Value: 1100 (0x0000044c)

ERROR_RECLAIMED

Added in API level 23
int ERROR_RECLAIMED

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.

Constant Value: 1101 (0x0000044d)

Public methods

getDiagnosticInfo

Added in API level 21
String getDiagnosticInfo ()

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.

Returns
String

getErrorCode

Added in API level 23
int getErrorCode ()

Retrieve the error code associated with a CodecException

Returns
int

isRecoverable

Added in API level 21
boolean isRecoverable ()

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

Returns
boolean

isTransient

Added in API level 21
boolean isTransient ()

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.

Returns
boolean

Hooray!