FrameworkMediaDrm

@UnstableApi
public static final ExoMediaDrm.Provider DEFAULT_PROVIDER

ExoMediaDrm.Provider that returns a new FrameworkMediaDrm for the requested UUID. Returns a DummyExoMediaDrm if the protection scheme identified by the given UUID is not supported by the device.

@UnstableApi
synchronized public void acquire()

Increments the reference count. When the caller no longer needs to use the instance, it must call release to decrement the reference count.

A new instance will have an initial reference count of 1, and therefore it is not normally necessary for application code to call this method.

@UnstableApi
public void closeSession(byte[] sessionId)

Closes a DRM session.

@UnstableApi
public FrameworkCryptoConfig createCryptoConfig(byte[] sessionId)

Creates a CryptoConfig that can be passed to a compatible decoder to allow decryption of protected content using the specified session.

@UnstableApi
@C.CryptoType
public int getCryptoType()

Returns the type of CryptoConfig instances returned by createCryptoConfig.

@UnstableApi
public ExoMediaDrm.KeyRequest getKeyRequest(
    byte[] scope,
    @Nullable List<DrmInitData.SchemeData> schemeDatas,
    int keyType,
    @Nullable HashMap<String, String> optionalParameters
)

Generates a key request.

@UnstableApi
public @Nullable PersistableBundle getMetrics()

Returns metrics data for this ExoMediaDrm instance, or null if metrics are unavailable.

@UnstableApi
@RequiresApi(value = 29)
public List<byte[]> getOfflineLicenseKeySetIds()

Returns a list of the keySetIds for all offline licenses.

This is an optional method, and some implementations may only support it on certain Android API levels.

See getOfflineLicenseKeySetIds for more details.

@UnstableApi
public byte[] getPropertyByteArray(String propertyName)

Returns the value of a byte array property. For standard property names, see getPropertyByteArray.

@UnstableApi
public String getPropertyString(String propertyName)

Returns the value of a string property. For standard property names, see getPropertyString.

@UnstableApi
public ExoMediaDrm.ProvisionRequest getProvisionRequest()

Generates a provisioning request.

public static boolean isCryptoSchemeSupported(UUID uuid)

Returns whether the DRM scheme with the given UUID is supported on this device.

@UnstableApi
public static FrameworkMediaDrm newInstance(UUID uuid)

Creates an instance with an initial reference count of 1. release must be called on the instance when it's no longer required.

@UnstableApi
public byte[] openSession()

Opens a new DRM session. A session ID is returned.

@UnstableApi
public @Nullable byte[] provideKeyResponse(byte[] scope, byte[] response)

Provides a key response for the last request to be generated using getKeyRequest.

@UnstableApi
public void provideProvisionResponse(byte[] response)

Provides a provisioning response for the last request to be generated using getProvisionRequest.

@UnstableApi
public Map<String, String> queryKeyStatus(byte[] sessionId)

Returns the key status for a given session, as {name, value} pairs. Since DRM license policies vary by vendor, the returned entries depend on the DRM plugin being used. Refer to your DRM provider's documentation for more information.

@UnstableApi
synchronized public void release()

Decrements the reference count. If the reference count drops to 0 underlying resources are released, and the instance cannot be re-used.

@UnstableApi
@RequiresApi(value = 29)
public void removeOfflineLicense(byte[] keySetId)

Removes an offline license.

This method is generally not needed, and should only be used if the preferred approach of generating a license release request by passing KEY_TYPE_RELEASE to getKeyRequest is not possible.

This is an optional method, and some implementations may only support it on certain Android API levels.

See removeOfflineLicense for more details.

@UnstableApi
public boolean requiresSecureDecoder(byte[] sessionId, String mimeType)

Returns whether the given session requires use of a secure decoder for the given MIME type. Assumes a license policy that requires the highest level of security supported by the session.

@UnstableApi
public void restoreKeys(byte[] sessionId, byte[] keySetId)

Restores persisted offline keys into a session.

@UnstableApi
public void setOnEventListener(@Nullable ExoMediaDrm.OnEventListener listener)

Sets the listener for DRM events.

This is an optional method, and some implementations may only support it on certain Android API levels.

@UnstableApi
@RequiresApi(value = 23)
public void setOnExpirationUpdateListener(
    @Nullable ExoMediaDrm.OnExpirationUpdateListener listener
)

Sets the listener for session expiration events.

This is an optional method, and some implementations may only support it on certain Android API levels.

@UnstableApi
@RequiresApi(value = 23)
public void setOnKeyStatusChangeListener(
    @Nullable ExoMediaDrm.OnKeyStatusChangeListener listener
)

Sets the listener for key status change events.

This is an optional method, and some implementations may only support it on certain Android API levels.

@UnstableApi
public void setPlayerIdForSession(byte[] sessionId, PlayerId playerId)

Sets the PlayerId of the player using a session.

@UnstableApi
public void setPropertyByteArray(String propertyName, byte[] value)

Sets the value of a byte array property.

@UnstableApi
public void setPropertyString(String propertyName, String value)

Sets the value of a string property.