lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

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

Constants

ERROR_INSUFFICIENT_RESOURCE

added in API level 23
public static final 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
public static final 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
public 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

This value will never be null.

getErrorCode

added in API level 23
public int getErrorCode ()

Retrieve the error code associated with a CodecException

Returns
int

isRecoverable

added in API level 21
public 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
public 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