# MediaDrmException
Added in[API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Ctors](https://developer.android.com/reference/android/media/MediaDrmException#pubctors)\|[Methods](https://developer.android.com/reference/android/media/MediaDrmException#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/media/MediaDrmException#inhmethods)
# MediaDrmException
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/media/MediaDrmException "View this page in Kotlin")\|Java
`
public
class
MediaDrmException
`
`
``
``
extends `[Exception](https://developer.android.com/reference/java/lang/Exception)`
``
implements
`[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable)`
`
|---|---|---|---------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) |||
| | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) ||
| | | ↳ | android.media.MediaDrmException |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known direct subclasses [DeniedByServerException](https://developer.android.com/reference/android/media/DeniedByServerException),[MediaPlayer.NoDrmSchemeException](https://developer.android.com/reference/android/media/MediaPlayer.NoDrmSchemeException),[MediaPlayer.ProvisioningNetworkErrorException](https://developer.android.com/reference/android/media/MediaPlayer.ProvisioningNetworkErrorException),[MediaPlayer.ProvisioningServerErrorException](https://developer.android.com/reference/android/media/MediaPlayer.ProvisioningServerErrorException),[NotProvisionedException](https://developer.android.com/reference/android/media/NotProvisionedException),[ResourceBusyException](https://developer.android.com/reference/android/media/ResourceBusyException),[UnsupportedSchemeException](https://developer.android.com/reference/android/media/UnsupportedSchemeException) |------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| | [DeniedByServerException](https://developer.android.com/reference/android/media/DeniedByServerException) | Exception thrown when the provisioning server or key server denies a certficate or license for a device. | | [MediaPlayer.NoDrmSchemeException](https://developer.android.com/reference/android/media/MediaPlayer.NoDrmSchemeException) | Thrown when a DRM method is called before preparing a DRM scheme through prepareDrm(). | | [MediaPlayer.ProvisioningNetworkErrorException](https://developer.android.com/reference/android/media/MediaPlayer.ProvisioningNetworkErrorException) | Thrown when the device requires DRM provisioning but the provisioning attempt has failed due to a network error (Internet reachability, timeout, etc.). | | [MediaPlayer.ProvisioningServerErrorException](https://developer.android.com/reference/android/media/MediaPlayer.ProvisioningServerErrorException) | Thrown when the device requires DRM provisioning but the provisioning attempt has failed due to the provisioning server denying the request. | | [NotProvisionedException](https://developer.android.com/reference/android/media/NotProvisionedException) | Exception thrown when an operation on a MediaDrm object is attempted and the device does not have a certificate. | | [ResourceBusyException](https://developer.android.com/reference/android/media/ResourceBusyException) | Exception thrown when an operation on a MediaDrm object is attempted and hardware resources are not available, due to being in use. | | [UnsupportedSchemeException](https://developer.android.com/reference/android/media/UnsupportedSchemeException) | Exception thrown when an attempt is made to construct a MediaDrm object using a crypto scheme UUID that is not supported by the device | |
*** ** * ** ***
Base class for MediaDrm exceptions
## Summary
| ### Public constructors ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[MediaDrmException](https://developer.android.com/reference/android/media/MediaDrmException#MediaDrmException(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` detailMessage) ` |
| ### Public methods ||
|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` int` | ` `[getErrorContext](https://developer.android.com/reference/android/media/MediaDrmException#getErrorContext())`() ` Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error context associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). |
| ` int` | ` `[getOemError](https://developer.android.com/reference/android/media/MediaDrmException#getOemError())`() ` Returns OEM or SOC specific error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). |
| ` int` | ` `[getVendorError](https://developer.android.com/reference/android/media/MediaDrmException#getVendorError())`() ` Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable)` ` |-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` final void` | ` `[addSuppressed](https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[fillInStackTrace](https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace())`() ` Fills in the execution stack trace. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[getCause](https://developer.android.com/reference/java/lang/Throwable#getCause())`() ` Returns the cause of this throwable or`null`if the cause is nonexistent or unknown. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getLocalizedMessage](https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage())`() ` Creates a localized description of this throwable. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getMessage](https://developer.android.com/reference/java/lang/Throwable#getMessage())`() ` Returns the detail message string of this throwable. | | ` `[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement) | ` `[getStackTrace](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())`() ` Provides programmatic access to the stack trace information printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace()). | | ` final `[Throwable[]](https://developer.android.com/reference/java/lang/Throwable) | ` `[getSuppressed](https://developer.android.com/reference/java/lang/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](https://developer.android.com/reference/java/lang/Throwable) | ` `[initCause](https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` Initializes the*cause*of this throwable to the specified value. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())`() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter))`(`[PrintWriter](https://developer.android.com/reference/java/io/PrintWriter)` s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream))`(`[PrintStream](https://developer.android.com/reference/java/io/PrintStream)` s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` `[setStackTrace](https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[]))`(`[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement)` stackTrace) ` Sets the stack trace elements that will be returned by[getStackTrace()](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())and printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())and related methods. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Throwable#toString())`() ` Returns a short description of this throwable. | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
| From interface` `[android.media.MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable)` ` |----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` default int` | ` `[getErrorContext](https://developer.android.com/reference/android/media/MediaDrmThrowable#getErrorContext())`() ` Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error context associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). | | ` default int` | ` `[getOemError](https://developer.android.com/reference/android/media/MediaDrmThrowable#getOemError())`() ` Returns OEM or SOC specific error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). | | ` default int` | ` `[getVendorError](https://developer.android.com/reference/android/media/MediaDrmThrowable#getVendorError())`() ` Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable). | ||
## Public constructors
### MediaDrmException
Added in[API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public MediaDrmException (String detailMessage)
```
| Parameters ||
|-----------------|-----------------|
| `detailMessage` | `String`
|
## Public methods
### getErrorContext
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getErrorContext ()
```
Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error context associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable).
Please consult the[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor for details on the error context.
| Returns ||
|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | an opaque integer that would help the @[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)vendor locate the source of the error if available, otherwise 0.
|
### getOemError
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getOemError ()
```
Returns OEM or SOC specific error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable).
Please consult the[MediaDrm](https://developer.android.com/reference/android/media/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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getVendorError ()
```
Returns[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor defined error code associated with this[MediaDrmThrowable](https://developer.android.com/reference/android/media/MediaDrmThrowable).
Please consult the[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor for details on the error code.
| Returns ||
|-------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | an error code defined by the[MediaDrm](https://developer.android.com/reference/android/media/MediaDrm)plugin vendor if available, otherwise 0.
|