MediaDrm.MediaDrmStateException

Kotlin |Java

public static final class MediaDrm.MediaDrmStateException
extends IllegalStateException implements MediaDrmThrowable

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	java.lang.RuntimeException
			↳	java.lang.IllegalStateException
				↳	android.media.MediaDrm.MediaDrmStateException

Thrown when a general failure occurs during a MediaDrm operation. Extends IllegalStateException with the addition of an error code that may be useful in diagnosing the failure.

Please refer to ErrorCodes for the general error handling strategy and details about each possible return value from getErrorCode().

Summary

Public methods
`String`	`getDiagnosticInfo()` Retrieve a developer-readable diagnostic information string associated with the exception.
`int`	`getErrorCode()` Returns error code associated with this `MediaDrmStateException`.
`int`	`getErrorContext()` Returns `MediaDrm` plugin vendor defined error context associated with this `MediaDrmThrowable`.
`int`	`getOemError()` Returns OEM or SOC specific error code associated with this `MediaDrmThrowable`.
`int`	`getVendorError()` Returns `MediaDrm` plugin vendor defined error code associated with this `MediaDrmThrowable`.
`boolean`	`isTransient()` Returns true if the `MediaDrmStateException` is a transient issue, perhaps due to resource constraints, and that the operation (e.g. provisioning) may succeed on a subsequent attempt.

Inherited methods

From class


        
          java.lang.Throwable

`final void`	`addSuppressed(Throwable exception)` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.
`Throwable`	`fillInStackTrace()` Fills in the execution stack trace.
`Throwable`	`getCause()` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
`String`	`getLocalizedMessage()` Creates a localized description of this throwable.
`String`	`getMessage()` Returns the detail message string of this throwable.
`StackTraceElement[]`	`getStackTrace()` Provides programmatic access to the stack trace information printed by `printStackTrace()`.
`final Throwable[]`	`getSuppressed()` Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception.
`Throwable`	`initCause(Throwable cause)` Initializes the cause of this throwable to the specified value.
`void`	`printStackTrace()` Prints this throwable and its backtrace to the standard error stream.
`void`	`printStackTrace(PrintWriter s)` Prints this throwable and its backtrace to the specified print writer.
`void`	`printStackTrace(PrintStream s)` Prints this throwable and its backtrace to the specified print stream.
`void`	`setStackTrace(StackTraceElement[] stackTrace)` Sets the stack trace elements that will be returned by `getStackTrace()` and printed by `printStackTrace()` and related methods.
`String`	`toString()` Returns a short description of this throwable.

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface


        
          android.media.MediaDrmThrowable

`default int`	`getErrorContext()` Returns `MediaDrm` plugin vendor defined error context associated with this `MediaDrmThrowable`.
`default int`	`getOemError()` Returns OEM or SOC specific error code associated with this `MediaDrmThrowable`.
`default int`	`getVendorError()` Returns `MediaDrm` plugin vendor defined error code associated with this `MediaDrmThrowable`.

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 cannot be `null`.

getErrorCode

Added in API level 31

public int getErrorCode ()

Returns error code associated with this MediaDrmStateException.

Please refer to ErrorCodes for the general error handling strategy and details about each possible return value.

Returns

Returns
`int`	an error code defined in `MediaDrm.ErrorCodes`. Value is `MediaDrm.ErrorCodes.ERROR_NO_KEY`, `MediaDrm.ErrorCodes.ERROR_KEY_EXPIRED`, `MediaDrm.ErrorCodes.ERROR_RESOURCE_BUSY`, `MediaDrm.ErrorCodes.ERROR_INSUFFICIENT_OUTPUT_PROTECTION`, `MediaDrm.ErrorCodes.ERROR_SESSION_NOT_OPENED`, `MediaDrm.ErrorCodes.ERROR_UNSUPPORTED_OPERATION`, `MediaDrm.ErrorCodes.ERROR_INSUFFICIENT_SECURITY`, `MediaDrm.ErrorCodes.ERROR_FRAME_TOO_LARGE`, `MediaDrm.ErrorCodes.ERROR_LOST_STATE`, `MediaDrm.ErrorCodes.ERROR_CERTIFICATE_MALFORMED`, `MediaDrm.ErrorCodes.ERROR_CERTIFICATE_MISSING`, `MediaDrm.ErrorCodes.ERROR_CRYPTO_LIBRARY`, `MediaDrm.ErrorCodes.ERROR_GENERIC_OEM`, `MediaDrm.ErrorCodes.ERROR_GENERIC_PLUGIN`, `MediaDrm.ErrorCodes.ERROR_INIT_DATA`, `MediaDrm.ErrorCodes.ERROR_KEY_NOT_LOADED`, `MediaDrm.ErrorCodes.ERROR_LICENSE_PARSE`, `MediaDrm.ErrorCodes.ERROR_LICENSE_POLICY`, `MediaDrm.ErrorCodes.ERROR_LICENSE_RELEASE`, `MediaDrm.ErrorCodes.ERROR_LICENSE_REQUEST_REJECTED`, `MediaDrm.ErrorCodes.ERROR_LICENSE_RESTORE`, `MediaDrm.ErrorCodes.ERROR_LICENSE_STATE`, `MediaDrm.ErrorCodes.ERROR_MEDIA_FRAMEWORK`, `MediaDrm.ErrorCodes.ERROR_PROVISIONING_CERTIFICATE`, `MediaDrm.ErrorCodes.ERROR_PROVISIONING_CONFIG`, `MediaDrm.ErrorCodes.ERROR_PROVISIONING_PARSE`, `MediaDrm.ErrorCodes.ERROR_PROVISIONING_REQUEST_REJECTED`, `MediaDrm.ErrorCodes.ERROR_PROVISIONING_RETRY`, `MediaDrm.ErrorCodes.ERROR_SECURE_STOP_RELEASE`, `MediaDrm.ErrorCodes.ERROR_STORAGE_READ`, `MediaDrm.ErrorCodes.ERROR_STORAGE_WRITE`, or `MediaDrm.ErrorCodes.ERROR_ZERO_SUBSAMPLES`

int

an error code defined in MediaDrm.ErrorCodes. Value is MediaDrm.ErrorCodes.ERROR_NO_KEY, MediaDrm.ErrorCodes.ERROR_KEY_EXPIRED, MediaDrm.ErrorCodes.ERROR_RESOURCE_BUSY, MediaDrm.ErrorCodes.ERROR_INSUFFICIENT_OUTPUT_PROTECTION, MediaDrm.ErrorCodes.ERROR_SESSION_NOT_OPENED, MediaDrm.ErrorCodes.ERROR_UNSUPPORTED_OPERATION, MediaDrm.ErrorCodes.ERROR_INSUFFICIENT_SECURITY, MediaDrm.ErrorCodes.ERROR_FRAME_TOO_LARGE, MediaDrm.ErrorCodes.ERROR_LOST_STATE, MediaDrm.ErrorCodes.ERROR_CERTIFICATE_MALFORMED, MediaDrm.ErrorCodes.ERROR_CERTIFICATE_MISSING, MediaDrm.ErrorCodes.ERROR_CRYPTO_LIBRARY, MediaDrm.ErrorCodes.ERROR_GENERIC_OEM, MediaDrm.ErrorCodes.ERROR_GENERIC_PLUGIN, MediaDrm.ErrorCodes.ERROR_INIT_DATA, MediaDrm.ErrorCodes.ERROR_KEY_NOT_LOADED, MediaDrm.ErrorCodes.ERROR_LICENSE_PARSE, MediaDrm.ErrorCodes.ERROR_LICENSE_POLICY, MediaDrm.ErrorCodes.ERROR_LICENSE_RELEASE, MediaDrm.ErrorCodes.ERROR_LICENSE_REQUEST_REJECTED, MediaDrm.ErrorCodes.ERROR_LICENSE_RESTORE, MediaDrm.ErrorCodes.ERROR_LICENSE_STATE, MediaDrm.ErrorCodes.ERROR_MEDIA_FRAMEWORK, MediaDrm.ErrorCodes.ERROR_PROVISIONING_CERTIFICATE, MediaDrm.ErrorCodes.ERROR_PROVISIONING_CONFIG, MediaDrm.ErrorCodes.ERROR_PROVISIONING_PARSE, MediaDrm.ErrorCodes.ERROR_PROVISIONING_REQUEST_REJECTED, MediaDrm.ErrorCodes.ERROR_PROVISIONING_RETRY, MediaDrm.ErrorCodes.ERROR_SECURE_STOP_RELEASE, MediaDrm.ErrorCodes.ERROR_STORAGE_READ, MediaDrm.ErrorCodes.ERROR_STORAGE_WRITE, or MediaDrm.ErrorCodes.ERROR_ZERO_SUBSAMPLES

getErrorContext

Added in API level 34

public int getErrorContext ()

Returns MediaDrm plugin vendor defined error context associated with this MediaDrmThrowable.

Please consult the MediaDrm plugin vendor for details on the error context.

Returns
`int`	an opaque integer that would help the @`MediaDrm` vendor locate the source of the error if available, otherwise 0.

getOemError

Added in API level 34

public int getOemError ()

Returns OEM or SOC specific error code associated with this MediaDrmThrowable.

Please consult the MediaDrm plugin, chip, or device vendor for details on the error code.

Returns
`int`	an OEM or SOC specific error code if available, otherwise 0.

getVendorError

Added in API level 34

public int getVendorError ()

Returns MediaDrm plugin vendor defined error code associated with this MediaDrmThrowable.

Please consult the MediaDrm plugin vendor for details on the error code.

Returns
`int`	an error code defined by the `MediaDrm` plugin vendor if available, otherwise 0.

isTransient

Added in API level 31

public boolean isTransient ()

Returns true if the MediaDrmStateException is a transient issue, perhaps due to resource constraints, and that the operation (e.g. provisioning) may succeed on a subsequent attempt.

Returns
`boolean`