Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/media/MediaDrm.SessionException#constants) \| [Ctors](https://developer.android.com/reference/android/media/MediaDrm.SessionException#pubctors) \| [Methods](https://developer.android.com/reference/android/media/MediaDrm.SessionException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/media/MediaDrm.SessionException#inhmethods)
# MediaDrm.SessionException
*** ** * ** ***
` public static final class MediaDrm.SessionException `
` ` ` ` ` ` ` extends https://developer.android.com/reference/java/lang/RuntimeException ` ` implements 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) |||
| | | ↳ | [java.lang.RuntimeException](https://developer.android.com/reference/java/lang/RuntimeException) ||
| | | | ↳ | android.media.MediaDrm.SessionException |
*** ** * ** ***
`https://developer.android.com/reference/android/media/MediaDrm.SessionException` is a misnomer because it may occur in methods **without** a session context.
A `https://developer.android.com/reference/android/media/MediaDrm.SessionException` is most likely to be thrown when an operation failed in a way that is likely to succeed on a subsequent attempt; call `https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()` to determine whether the app should retry the failing operation.
## Summary
| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION` *This constant was deprecated in API level 31. Please use `https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()` instead of comparing the return value of `https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorCode()` against `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION`.* |
| `int` | `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_UNKNOWN` *This constant was deprecated in API level 31. Unused.* |
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#SessionException(int,%20java.lang.String)(int errorCode, https://developer.android.com/reference/java/lang/String detailMessage) ` |
| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorCode()() ` *This method was deprecated in API level 31. Please use `https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()` instead of comparing the return value of `https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorCode()` against `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION`.* |
| ` int` | ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorContext()() ` Returns `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error context associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`. |
| ` int` | ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#getOemError()() ` Returns OEM or SOC specific error code associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`. |
| ` int` | ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#getVendorError()() ` Returns `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error code associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`. |
| ` boolean` | ` https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()() ` Returns true if the `https://developer.android.com/reference/android/media/MediaDrm.SessionException` is a transient issue, perhaps due to resource constraints, and that the operation (e.g. provisioning, generating requests) may succeed on a subsequent attempt. |
### Inherited methods
From class ` https://developer.android.com/reference/java/lang/Throwable ` ` final void` ` https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.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.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()() `
Fills in the execution stack trace.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#getCause()() `
Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()() `
Creates a localized description of this throwable.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#getMessage()() `
Returns the detail message string of this throwable.
` https://developer.android.com/reference/java/lang/StackTraceElement` ` https://developer.android.com/reference/java/lang/Throwable#getStackTrace()() `
Provides programmatic access to the stack trace information printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`.
` final https://developer.android.com/reference/java/lang/Throwable` ` 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.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) `
Initializes the *cause* of this throwable to the specified value.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace()() `
Prints this throwable and its backtrace to the standard error stream.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s) `
Prints this throwable and its backtrace to the specified print writer.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s) `
Prints this throwable and its backtrace to the specified print stream.
` void` ` https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace) `
Sets the stack trace elements that will be returned by `https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()` and related methods.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#toString()() `
Returns a short description of this throwable.
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `
Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `
Indicates whether some other object is "equal to" this one.
` void` ` 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 https://developer.android.com/reference/java/lang/Class` ` https://developer.android.com/reference/java/lang/Object#getClass()() `
Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `
Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `
Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `
Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `
Returns a string representation of the object.
` final void` ` 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` ` 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` ` 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 ` https://developer.android.com/reference/android/media/MediaDrmThrowable ` ` default int` ` https://developer.android.com/reference/android/media/MediaDrmThrowable#getErrorContext()() `
Returns `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error context associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
` default int` ` https://developer.android.com/reference/android/media/MediaDrmThrowable#getOemError()() `
Returns OEM or SOC specific error code associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
` default int` ` https://developer.android.com/reference/android/media/MediaDrmThrowable#getVendorError()() `
Returns `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error code associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
## Constants
### ERROR_RESOURCE_CONTENTION
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_RESOURCE_CONTENTION
```
**This constant was deprecated in API level 31.**
Please use `https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()` instead of comparing the return value of `https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorCode()` against `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION`.
This indicates that apps using MediaDrm sessions are temporarily exceeding the capacity of available crypto resources. The app should retry the operation later.
Constant Value: 1 (0x00000001)
### ERROR_UNKNOWN
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_UNKNOWN
```
**This constant was deprecated in API level 31.**
Unused.
The SessionException has an unknown error code.
Constant Value: 0 (0x00000000)
## Public constructors
### SessionException
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public SessionException (int errorCode,
String detailMessage)
```
| Parameters ||
|---|---|
| `errorCode` | `int`
|
| `detailMessage` | `String`: This value may be `null`.
|
## Public methods
### getErrorCode
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getErrorCode ()
```
**This method was deprecated in API level 31.**
Please use `https://developer.android.com/reference/android/media/MediaDrm.SessionException#isTransient()` instead of comparing the return value of `https://developer.android.com/reference/android/media/MediaDrm.SessionException#getErrorCode()` against `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION`.
Retrieve the error code associated with the SessionException
| Returns ||
|---|---|
| `int` | Value is one of the following: - `https://developer.android.com/reference/android/media/MediaDrm.SessionException#ERROR_RESOURCE_CONTENTION` |
### getErrorContext
Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getErrorContext ()
```
Returns `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error context associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
Please consult the `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 @`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 `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
Please consult the `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 `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor defined error code associated with this `https://developer.android.com/reference/android/media/MediaDrmThrowable`.
Please consult the `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor for details on the error code.
| Returns ||
|---|---|
| `int` | an error code defined by the `https://developer.android.com/reference/android/media/MediaDrm` plugin vendor if available, otherwise 0.
|
### isTransient
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isTransient ()
```
Returns true if the `https://developer.android.com/reference/android/media/MediaDrm.SessionException` is a transient issue, perhaps due to resource constraints, and that the operation (e.g. provisioning, generating requests) may succeed on a subsequent attempt.
| Returns ||
|---|---|
| `boolean` |
|