DrmUtil

Artifact: androidx.media3:media3-exoplayer

View Source

---

Kotlin |Java

@UnstableApi
public final class DrmUtil

---

DRM-related utility methods.

Summary

Nested types
@Documented @Retention(value = RetentionPolicy.SOURCE) @Target(value = ) @IntDef(value = ) public annotation DrmUtil.ErrorSource Identifies the operation which caused a DRM-related error.

Constants
static final int	ERROR_SOURCE_EXO_MEDIA_DRM = 1 Corresponds to failures caused by an ExoMediaDrm method call.
static final int	ERROR_SOURCE_LICENSE_ACQUISITION = 2 Corresponds to failures caused by an operation related to obtaining DRM licenses.
static final int	ERROR_SOURCE_PROVISIONING = 3 Corresponds to failures caused by an operation related to provisioning the device.

Public methods
static byte[]	executePost(     DataSource dataSource,     String url,     @Nullable byte[] httpBody,     Map<String, String> requestProperties ) Executes a HTTP POST request with retry handling and returns the entire response in a byte buffer.
static int	@PlaybackException.ErrorCode getErrorCodeForMediaDrmException(     Throwable exception,     @DrmUtil.ErrorSource int errorSource ) Returns the PlaybackException.ErrorCode that corresponds to the given DRM-related exception.
static boolean	isFailureToConstructNotProvisionedException(@Nullable Throwable e) Returns true if e represents a failure to construct a NotProvisionedException.
static boolean	isFailureToConstructResourceBusyException(@Nullable Throwable e) Returns true if e represents a failure to construct a ResourceBusyException.

Constants

ERROR_SOURCE_EXO_MEDIA_DRM

public static final int ERROR_SOURCE_EXO_MEDIA_DRM = 1

Corresponds to failures caused by an ExoMediaDrm method call.

ERROR_SOURCE_LICENSE_ACQUISITION

public static final int ERROR_SOURCE_LICENSE_ACQUISITION = 2

Corresponds to failures caused by an operation related to obtaining DRM licenses.

ERROR_SOURCE_PROVISIONING

public static final int ERROR_SOURCE_PROVISIONING = 3

Corresponds to failures caused by an operation related to provisioning the device.

Public methods

executePost

public static byte[] executePost(
    DataSource dataSource,
    String url,
    @Nullable byte[] httpBody,
    Map<String, String> requestProperties
)

Executes a HTTP POST request with retry handling and returns the entire response in a byte buffer.

Note that this method is executing the request synchronously and blocks until finished.

Parameters
DataSource dataSource	A DataSource.
String url	The requested URL.
@Nullable byte[] httpBody	The HTTP request payload.
Map<String, String> requestProperties	A keyed map of HTTP header request properties.

Returns
byte[]	A byte array that holds the response payload.

Throws
androidx.media3.exoplayer.drm.MediaDrmCallbackException	if an exception was encountered during the download.

getErrorCodeForMediaDrmException

@PlaybackException.ErrorCode
public static int getErrorCodeForMediaDrmException(
    Throwable exception,
    @DrmUtil.ErrorSource int errorSource
)

Returns the PlaybackException.ErrorCode that corresponds to the given DRM-related exception.

Parameters
Throwable exception	The DRM-related exception for which to obtain a corresponding .
@DrmUtil.ErrorSource int errorSource	The ErrorSource for the given exception.

Returns
int	The PlaybackException.ErrorCode that corresponds to the given DRM-related exception.

isFailureToConstructNotProvisionedException

public static boolean isFailureToConstructNotProvisionedException(@Nullable Throwable e)

Returns true if e represents a failure to construct a NotProvisionedException. See b/291440132.

isFailureToConstructResourceBusyException

public static boolean isFailureToConstructResourceBusyException(@Nullable Throwable e)

Returns true if e represents a failure to construct a ResourceBusyException. See b/291440132.