# MediaDrmCallback

# MediaDrmCallback

Artifact:[androidx.media3:media3-exoplayer](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/exoplayer/drm/MediaDrmCallback.java+class:androidx.media3.exoplayer.drm.MediaDrmCallback)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/exoplayer/drm/MediaDrmCallback "View this page in Java")

<br />

```
@UnstableApi
interface MediaDrmCallback
```

<br />

Known direct subclasses  
[FakeExoMediaDrm.LicenseServer](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/FakeExoMediaDrm.LicenseServer),[HttpMediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/HttpMediaDrmCallback),[LocalMediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/LocalMediaDrmCallback)  

|------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [FakeExoMediaDrm.LicenseServer](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/FakeExoMediaDrm.LicenseServer) | An license server implementation to interact with[FakeExoMediaDrm](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/FakeExoMediaDrm).                                                                                          |
| [HttpMediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/HttpMediaDrmCallback)                | A[MediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback)that makes requests using[DataSource](https://developer.android.com/reference/kotlin/androidx/media3/datasource/DataSource)instances. |
| [LocalMediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/LocalMediaDrmCallback)              | A[MediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback)that provides a fixed response to key requests.                                                                                       |

*** ** * ** ***

Performs[ExoMediaDrm](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/ExoMediaDrm)key and provisioning requests.

## Summary

|                                                                                                                                          ### Nested types                                                                                                                                           |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `class `[MediaDrmCallback.Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response) Response data from the[MediaDrmCallback](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback)requests.        |
| `class `[MediaDrmCallback.Response.Builder](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response.Builder) Builder for[Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)instances. |

|                                                          ### Public functions                                                          |
|----------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [MediaDrmCallback.Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)`!` | [executeKeyRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback#executeKeyRequest(java.util.UUID,androidx.media3.exoplayer.drm.ExoMediaDrm.KeyRequest))`(uuid: `[UUID](https://developer.android.com/reference/java/util/UUID.html)`!, request: `[ExoMediaDrm.KeyRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/ExoMediaDrm.KeyRequest)`!)` Executes a key request.                                                  |
| [MediaDrmCallback.Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)`!` | [executeProvisionRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback#executeProvisionRequest(java.util.UUID,androidx.media3.exoplayer.drm.ExoMediaDrm.ProvisionRequest))`(` ` uuid: `[UUID](https://developer.android.com/reference/java/util/UUID.html)`!,` ` request: `[ExoMediaDrm.ProvisionRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/ExoMediaDrm.ProvisionRequest)`!` `)` Executes a provisioning request. |

## Public functions

### executeKeyRequest

```
fun executeKeyRequest(uuid: UUID!, request: ExoMediaDrm.KeyRequest!): MediaDrmCallback.Response!
```

Executes a key request.

The[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)returned inside the[Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)will have the following fields unset, and they must be updated by caller before the[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)is used elsewhere:

- [loadTaskId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo#loadTaskId())
- [loadDurationMs](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo#loadDurationMs())

|                                                                 Parameters                                                                  |
|---------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|
| `uuid: `[UUID](https://developer.android.com/reference/java/util/UUID.html)`!`                                                              | The UUID of the content protection scheme. |
| `request: `[ExoMediaDrm.KeyRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/ExoMediaDrm.KeyRequest)`!` | The request.                               |

|                                                                Returns                                                                 |
|----------------------------------------------------------------------------------------------------------------------------------------|--------------------|
| [MediaDrmCallback.Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)`!` | The response data. |

|                                                                              Throws                                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------|
| [androidx.media3.exoplayer.drm.MediaDrmCallbackException](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallbackException) | If an error occurred executing the request. |

### executeProvisionRequest

```
fun executeProvisionRequest(
    uuid: UUID!,
    request: ExoMediaDrm.ProvisionRequest!
): MediaDrmCallback.Response!
```

Executes a provisioning request.

The[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)returned inside the[Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)will have the following fields unset, and they must be updated by caller before the[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)is used elsewhere:

- [loadTaskId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo#loadTaskId())
- [loadDurationMs](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo#loadDurationMs())

|                                                                       Parameters                                                                        |
|---------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|
| `uuid: `[UUID](https://developer.android.com/reference/java/util/UUID.html)`!`                                                                          | The UUID of the content protection scheme. |
| `request: `[ExoMediaDrm.ProvisionRequest](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/ExoMediaDrm.ProvisionRequest)`!` | The request.                               |

|                                                                Returns                                                                 |
|----------------------------------------------------------------------------------------------------------------------------------------|--------------------|
| [MediaDrmCallback.Response](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallback.Response)`!` | The response data. |

|                                                                              Throws                                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------|
| [androidx.media3.exoplayer.drm.MediaDrmCallbackException](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/MediaDrmCallbackException) | If an error occurred executing the request. |