com.google.android.exoplayer2.drm

Class FrameworkMediaDrm

java.lang.Object

com.google.android.exoplayer2.drm.FrameworkMediaDrm

All Implemented Interfaces:

ExoMediaDrm<FrameworkMediaCrypto>

public final class FrameworkMediaDrm
extends java.lang.Object
implements ExoMediaDrm<FrameworkMediaCrypto>

An ExoMediaDrm implementation that wraps the framework MediaDrm.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.drm.ExoMediaDrm

ExoMediaDrm.KeyRequest, ExoMediaDrm.KeyStatus, ExoMediaDrm.OnEventListener<T extends ExoMediaCrypto>, ExoMediaDrm.OnKeyStatusChangeListener<T extends ExoMediaCrypto>, ExoMediaDrm.ProvisionRequest

Field Summary

Fields inherited from interface com.google.android.exoplayer2.drm.ExoMediaDrm

EVENT_KEY_EXPIRED, EVENT_KEY_REQUIRED, EVENT_PROVISION_REQUIRED, KEY_TYPE_OFFLINE, KEY_TYPE_RELEASE, KEY_TYPE_STREAMING

Method Summary

Modifier and Type	Method and Description
void	closeSession(byte[] sessionId)
FrameworkMediaCrypto	createMediaCrypto(byte[] initData)
ExoMediaDrm.KeyRequest	getKeyRequest(byte[] scope, java.util.List<DrmInitData.SchemeData> schemeDatas, int keyType, java.util.HashMap<java.lang.String,java.lang.String> optionalParameters) Generates a key request.
byte[]	getPropertyByteArray(java.lang.String propertyName)
java.lang.String	getPropertyString(java.lang.String propertyName)
ExoMediaDrm.ProvisionRequest	getProvisionRequest()
static FrameworkMediaDrm	newInstance(java.util.UUID uuid) Creates an instance for the specified scheme UUID.
byte[]	openSession()
byte[]	provideKeyResponse(byte[] scope, byte[] response)
void	provideProvisionResponse(byte[] response)
java.util.Map<java.lang.String,java.lang.String>	queryKeyStatus(byte[] sessionId)
void	release()
void	restoreKeys(byte[] sessionId, byte[] keySetId)
void	setOnEventListener(ExoMediaDrm.OnEventListener<? super FrameworkMediaCrypto> listener)
void	setOnKeyStatusChangeListener(ExoMediaDrm.OnKeyStatusChangeListener<? super FrameworkMediaCrypto> listener)
void	setPropertyByteArray(java.lang.String propertyName, byte[] value)
void	setPropertyString(java.lang.String propertyName, java.lang.String value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newInstance

public static FrameworkMediaDrm newInstance(java.util.UUID uuid)
                                     throws UnsupportedDrmException

Creates an instance for the specified scheme UUID.

Parameters:

uuid - The scheme uuid.

Returns:

The created instance.

Throws:

UnsupportedDrmException - If the DRM scheme is unsupported or cannot be instantiated.

setOnEventListener

public void setOnEventListener(ExoMediaDrm.OnEventListener<? super FrameworkMediaCrypto> listener)

Specified by:

setOnEventListener in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.setOnEventListener(MediaDrm.OnEventListener)

setOnKeyStatusChangeListener

public void setOnKeyStatusChangeListener(ExoMediaDrm.OnKeyStatusChangeListener<? super FrameworkMediaCrypto> listener)

Specified by:

setOnKeyStatusChangeListener in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.setOnKeyStatusChangeListener(MediaDrm.OnKeyStatusChangeListener, Handler)

openSession

public byte[] openSession()
                   throws android.media.MediaDrmException

Specified by:

openSession in interface ExoMediaDrm<FrameworkMediaCrypto>

Throws:

android.media.MediaDrmException

See Also:

MediaDrm.openSession()

closeSession

public void closeSession(byte[] sessionId)

Specified by:

closeSession in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.closeSession(byte[])

getKeyRequest

public ExoMediaDrm.KeyRequest getKeyRequest(byte[] scope,
                                            @Nullable
                                            java.util.List<DrmInitData.SchemeData> schemeDatas,
                                            int keyType,
                                            @Nullable
                                            java.util.HashMap<java.lang.String,java.lang.String> optionalParameters)
                                     throws android.media.NotProvisionedException

Description copied from interface: ExoMediaDrm

Generates a key request.

Specified by:

getKeyRequest in interface ExoMediaDrm<FrameworkMediaCrypto>

Parameters:

scope - If keyType is ExoMediaDrm.KEY_TYPE_STREAMING or ExoMediaDrm.KEY_TYPE_OFFLINE, the session id that the keys will be provided to. If keyType is ExoMediaDrm.KEY_TYPE_RELEASE, the keySetId of the keys to release.

schemeDatas - If key type is ExoMediaDrm.KEY_TYPE_STREAMING or ExoMediaDrm.KEY_TYPE_OFFLINE, a list of DrmInitData.SchemeData instances extracted from the media. Null otherwise.

keyType - The type of the request. Either ExoMediaDrm.KEY_TYPE_STREAMING to acquire keys for streaming, ExoMediaDrm.KEY_TYPE_OFFLINE to acquire keys for offline usage, or ExoMediaDrm.KEY_TYPE_RELEASE to release acquired keys. Releasing keys invalidates them for all sessions.

optionalParameters - Are included in the key request message to allow a client application to provide additional message parameters to the server. This may be null if no additional parameters are to be sent.

Returns:

The generated key request.

Throws:

android.media.NotProvisionedException

See Also:

MediaDrm.getKeyRequest(byte[], byte[], String, int, HashMap)

provideKeyResponse

public byte[] provideKeyResponse(byte[] scope,
                                 byte[] response)
                          throws android.media.NotProvisionedException,
                                 android.media.DeniedByServerException

Specified by:

provideKeyResponse in interface ExoMediaDrm<FrameworkMediaCrypto>

Throws:

android.media.NotProvisionedException

android.media.DeniedByServerException

See Also:

MediaDrm.provideKeyResponse(byte[], byte[])

getProvisionRequest

public ExoMediaDrm.ProvisionRequest getProvisionRequest()

Specified by:

getProvisionRequest in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.getProvisionRequest()

provideProvisionResponse

public void provideProvisionResponse(byte[] response)
                              throws android.media.DeniedByServerException

Specified by:

provideProvisionResponse in interface ExoMediaDrm<FrameworkMediaCrypto>

Throws:

android.media.DeniedByServerException

See Also:

MediaDrm.provideProvisionResponse(byte[])

queryKeyStatus

public java.util.Map<java.lang.String,java.lang.String> queryKeyStatus(byte[] sessionId)

Specified by:

queryKeyStatus in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.queryKeyStatus(byte[])

release

public void release()

Specified by:

release in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.release()

restoreKeys

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

Specified by:

restoreKeys in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.restoreKeys(byte[], byte[])

getPropertyString

public java.lang.String getPropertyString(java.lang.String propertyName)

Specified by:

getPropertyString in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.getPropertyString(String)

getPropertyByteArray

public byte[] getPropertyByteArray(java.lang.String propertyName)

Specified by:

getPropertyByteArray in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.getPropertyByteArray(String)

setPropertyString

public void setPropertyString(java.lang.String propertyName,
                              java.lang.String value)

Specified by:

setPropertyString in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.setPropertyString(String, String)

setPropertyByteArray

public void setPropertyByteArray(java.lang.String propertyName,
                                 byte[] value)

Specified by:

setPropertyByteArray in interface ExoMediaDrm<FrameworkMediaCrypto>

See Also:

MediaDrm.setPropertyByteArray(String, byte[])

createMediaCrypto

public FrameworkMediaCrypto createMediaCrypto(byte[] initData)
                                       throws android.media.MediaCryptoException

Specified by:

createMediaCrypto in interface ExoMediaDrm<FrameworkMediaCrypto>

Parameters:

initData - Opaque initialization data specific to the crypto scheme.

Returns:

An object extends ExoMediaCrypto, using opaque crypto scheme specific data.

Throws:

android.media.MediaCryptoException - If the instance can't be created.

See Also:

MediaCrypto.MediaCrypto(UUID, byte[])