ExoMediaDrm (ijkplayer-drm API)

所有已知实现类:

DummyExoMediaDrm, FrameworkMediaDrm
```
public interface ExoMediaDrm
```
Used to obtain keys for decrypting protected media streams.
Reference counting

Access to an instance is managed by reference counting, where acquire() increments the reference count and release() decrements it. When the reference count drops to 0 underlying resources are released, and the instance cannot be re-used.
Each new instance has an initial reference count of 1. Hence application code that creates a new instance does not normally need to call acquire(), and must call release() when the instance is no longer required.

另请参阅:

MediaDrm

嵌套类概要

嵌套类
限定符和类型	接口和说明
`static class`	`ExoMediaDrm.AppManagedProvider` Provides an `ExoMediaDrm` instance owned by the app.
`static class`	`ExoMediaDrm.KeyRequest` Contains data used to request keys from a license server.
`static class`	`ExoMediaDrm.KeyStatus` Defines the status of a key.
`static interface`	`ExoMediaDrm.OnEventListener` Called when a DRM event occurs.
`static interface`	`ExoMediaDrm.OnExpirationUpdateListener` Called when a session expiration update occurs.
`static interface`	`ExoMediaDrm.OnKeyStatusChangeListener` Called when the keys in a DRM session change state.
`static interface`	`ExoMediaDrm.Provider` Provider for `ExoMediaDrm` instances.
`static class`	`ExoMediaDrm.ProvisionRequest` Contains data to request a certificate from a provisioning server.

字段概要

字段
限定符和类型	字段和说明
`static int`	`EVENT_KEY_EXPIRED` Event indicating that keys have expired, and are no longer usable.
`static int`	`EVENT_KEY_REQUIRED` Event indicating that keys need to be requested from the license server.
`static int`	`EVENT_PROVISION_REQUIRED` Event indicating that a certificate needs to be requested from the provisioning server.
`static int`	`KEY_TYPE_OFFLINE` Key request type for keys that will be used for offline use.
`static int`	`KEY_TYPE_RELEASE` Key request type indicating that saved offline keys should be released.
`static int`	`KEY_TYPE_STREAMING` Key request type for keys that will be used for online use.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`void`	`acquire()` Increments the reference count.
`void`	`closeSession(byte[] sessionId)` Closes a DRM session.
`ExoMediaCrypto`	`createMediaCrypto(byte[] sessionId)` Creates an `ExoMediaCrypto` for a given session.
`java.lang.Class<? extends ExoMediaCrypto>`	`getExoMediaCryptoType()` Returns the `ExoMediaCrypto` type created by `createMediaCrypto(byte[])`.
`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.
`android.os.PersistableBundle`	`getMetrics()` Returns metrics data for this ExoMediaDrm instance, or `null` if metrics are unavailable.
`byte[]`	`getPropertyByteArray(java.lang.String propertyName)` Returns the value of a byte array property.
`java.lang.String`	`getPropertyString(java.lang.String propertyName)` Returns the value of a string property.
`ExoMediaDrm.ProvisionRequest`	`getProvisionRequest()` Generates a provisioning request.
`byte[]`	`openSession()` Opens a new DRM session.
`byte[]`	`provideKeyResponse(byte[] scope, byte[] response)` Provides a key response for the last request to be generated using `getKeyRequest(byte[], java.util.List<tv.danmaku.ijk.media.drm.DrmInitData.SchemeData>, int, java.util.HashMap<java.lang.String, java.lang.String>)`.
`void`	`provideProvisionResponse(byte[] response)` Provides a provisioning response for the last request to be generated using `getProvisionRequest()`.
`java.util.Map<java.lang.String,java.lang.String>`	`queryKeyStatus(byte[] sessionId)` Returns the key status for a given session, as {name, value} pairs.
`void`	`release()` Decrements the reference count.
`void`	`restoreKeys(byte[] sessionId, byte[] keySetId)` Restores persisted offline keys into a session.
`void`	`setOnEventListener(ExoMediaDrm.OnEventListener listener)` Sets the listener for DRM events.
`void`	`setOnExpirationUpdateListener(ExoMediaDrm.OnExpirationUpdateListener listener)` Sets the listener for session expiration events.
`void`	`setOnKeyStatusChangeListener(ExoMediaDrm.OnKeyStatusChangeListener listener)` Sets the listener for key status change events.
`void`	`setPropertyByteArray(java.lang.String propertyName, byte[] value)` Sets the value of a byte array property.
`void`	`setPropertyString(java.lang.String propertyName, java.lang.String value)` Sets the value of a string property.

- 字段详细资料
  - EVENT_KEY_REQUIRED
```
static final int EVENT_KEY_REQUIRED
```
    Event indicating that keys need to be requested from the license server.
    
    另请参阅:
    
    常量字段值
  - EVENT_KEY_EXPIRED
```
static final int EVENT_KEY_EXPIRED
```
    Event indicating that keys have expired, and are no longer usable.
    
    另请参阅:
    
    常量字段值
  - EVENT_PROVISION_REQUIRED
```
static final int EVENT_PROVISION_REQUIRED
```
    Event indicating that a certificate needs to be requested from the provisioning server.
    
    另请参阅:
    
    常量字段值
  - KEY_TYPE_STREAMING
```
static final int KEY_TYPE_STREAMING
```
    Key request type for keys that will be used for online use. Streaming keys will not be saved to the device for subsequent use when the device is not connected to a network.
    
    另请参阅:
    
    常量字段值
  - KEY_TYPE_OFFLINE
```
static final int KEY_TYPE_OFFLINE
```
    Key request type for keys that will be used for offline use. They will be saved to the device for subsequent use when the device is not connected to a network.
    
    另请参阅:
    
    常量字段值
  - KEY_TYPE_RELEASE
```
static final int KEY_TYPE_RELEASE
```
    Key request type indicating that saved offline keys should be released.
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - setOnEventListener
```
void setOnEventListener(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.
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    抛出:
    
    java.lang.UnsupportedOperationException - if the implementation doesn't support this method.
    
    另请参阅:
    
    MediaDrm.setOnEventListener(MediaDrm.OnEventListener)
  - setOnKeyStatusChangeListener
```
void setOnKeyStatusChangeListener(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.
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    抛出:
    
    java.lang.UnsupportedOperationException - if the implementation doesn't support this method.
    
    另请参阅:
    
    MediaDrm.setOnKeyStatusChangeListener(MediaDrm.OnKeyStatusChangeListener, Handler)
  - setOnExpirationUpdateListener
```
void setOnExpirationUpdateListener(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.
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    抛出:
    
    java.lang.UnsupportedOperationException - if the implementation doesn't support this method.
    
    另请参阅:
    
    MediaDrm.setOnExpirationUpdateListener(MediaDrm.OnExpirationUpdateListener, Handler)
  - openSession
```
byte[] openSession()
            throws android.media.MediaDrmException
```
    Opens a new DRM session. A session ID is returned.
    
    返回:
    
    The session ID.
    
    抛出:
    
    android.media.NotProvisionedException - If provisioning is needed.
    
    android.media.ResourceBusyException - If required resources are in use.
    
    android.media.MediaDrmException - If the session could not be opened.
  - closeSession
```
void closeSession(byte[] sessionId)
```
    Closes a DRM session.
    
    参数:
    
    sessionId - The ID of the session to close.
  - getKeyRequest
```
ExoMediaDrm.KeyRequest getKeyRequest(byte[] scope,
                                     java.util.List<DrmInitData.SchemeData> schemeDatas,
                                     int keyType,
                                     java.util.HashMap<java.lang.String,java.lang.String> optionalParameters)
                              throws android.media.NotProvisionedException
```
    Generates a key request.
    
    参数:
    
    scope - If keyType is KEY_TYPE_STREAMING or KEY_TYPE_OFFLINE, the ID of the session that the keys will be provided to. If keyType is KEY_TYPE_RELEASE, the keySetId of the keys to release.
    
    schemeDatas - If key type is KEY_TYPE_STREAMING or KEY_TYPE_OFFLINE, a list of DrmInitData.SchemeData instances extracted from the media. Null otherwise.
    
    keyType - The type of the request. Either KEY_TYPE_STREAMING to acquire keys for streaming, KEY_TYPE_OFFLINE to acquire keys for offline usage, or 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.
    
    返回:
    
    The generated key request.
    
    抛出:
    
    android.media.NotProvisionedException
    
    另请参阅:
    
    MediaDrm.getKeyRequest(byte[], byte[], String, int, HashMap)
  - provideKeyResponse
```
byte[] provideKeyResponse(byte[] scope,
                          byte[] response)
                   throws android.media.NotProvisionedException,
                          android.media.DeniedByServerException
```
    Provides a key response for the last request to be generated using getKeyRequest(byte[], java.util.List<tv.danmaku.ijk.media.drm.DrmInitData.SchemeData>, int, java.util.HashMap<java.lang.String, java.lang.String>).
    
    参数:
    
    scope - If the request had type KEY_TYPE_STREAMING or KEY_TYPE_OFFLINE, the ID of the session to provide the keys to. If keyType is KEY_TYPE_RELEASE, the keySetId of the keys being released.
    
    response - The response data from the server.
    
    返回:
    
    If the request had type KEY_TYPE_OFFLINE, the keySetId for the offline keys. An empty byte array or null may be returned for other cases.
    
    抛出:
    
    android.media.NotProvisionedException - If the response indicates that provisioning is needed.
    
    android.media.DeniedByServerException - If the response indicates that the server rejected the request.
  - getProvisionRequest
```
ExoMediaDrm.ProvisionRequest getProvisionRequest()
```
    Generates a provisioning request.
    
    返回:
    
    The generated provisioning request.
  - provideProvisionResponse
```
void provideProvisionResponse(byte[] response)
                       throws android.media.DeniedByServerException
```
    Provides a provisioning response for the last request to be generated using getProvisionRequest().
    
    参数:
    
    response - The response data from the server.
    
    抛出:
    
    android.media.DeniedByServerException - If the response indicates that the server rejected the request.
  - queryKeyStatus
```
java.util.Map<java.lang.String,java.lang.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.
    
    参数:
    
    sessionId - The ID of the session being queried.
    
    返回:
    
    The key status for the session.
  - acquire
```
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.
  - release
```
void release()
```
    Decrements the reference count. If the reference count drops to 0 underlying resources are released, and the instance cannot be re-used.
  - restoreKeys
```
void restoreKeys(byte[] sessionId,
                 byte[] keySetId)
```
    Restores persisted offline keys into a session.
    
    参数:
    
    sessionId - The ID of the session into which the keys will be restored.
    
    keySetId - The keySetId of the keys to restore, as provided by the call to provideKeyResponse(byte[], byte[]) that persisted them.
  - getMetrics
```
android.os.PersistableBundle getMetrics()
```
    Returns metrics data for this ExoMediaDrm instance, or null if metrics are unavailable.
  - getPropertyString
```
java.lang.String getPropertyString(java.lang.String propertyName)
```
    Returns the value of a string property. For standard property names, see MediaDrm.getPropertyString(java.lang.String).
    
    参数:
    
    propertyName - The property name.
    
    返回:
    
    The property value.
    
    抛出:
    
    java.lang.IllegalArgumentException - If the underlying DRM plugin does not support the property.
  - getPropertyByteArray
```
byte[] getPropertyByteArray(java.lang.String propertyName)
```
    Returns the value of a byte array property. For standard property names, see MediaDrm.getPropertyByteArray(java.lang.String).
    
    参数:
    
    propertyName - The property name.
    
    返回:
    
    The property value.
    
    抛出:
    
    java.lang.IllegalArgumentException - If the underlying DRM plugin does not support the property.
  - setPropertyString
```
void setPropertyString(java.lang.String propertyName,
                       java.lang.String value)
```
    Sets the value of a string property.
    
    参数:
    
    propertyName - The property name.
    
    value - The value.
    
    抛出:
    
    java.lang.IllegalArgumentException - If the underlying DRM plugin does not support the property.
  - setPropertyByteArray
```
void setPropertyByteArray(java.lang.String propertyName,
                          byte[] value)
```
    Sets the value of a byte array property.
    
    参数:
    
    propertyName - The property name.
    
    value - The value.
    
    抛出:
    
    java.lang.IllegalArgumentException - If the underlying DRM plugin does not support the property.
  - createMediaCrypto
```
ExoMediaCrypto createMediaCrypto(byte[] sessionId)
                          throws android.media.MediaCryptoException
```
    Creates an ExoMediaCrypto for a given session.
    
    参数:
    
    sessionId - The ID of the session.
    
    返回:
    
    An ExoMediaCrypto for the given session.
    
    抛出:
    
    android.media.MediaCryptoException - If an ExoMediaCrypto could not be created.
  - getExoMediaCryptoType
```
java.lang.Class<? extends ExoMediaCrypto> getExoMediaCryptoType()
```
    Returns the ExoMediaCrypto type created by createMediaCrypto(byte[]).

接口 ExoMediaDrm

Reference counting

嵌套类概要

字段概要

方法概要

字段详细资料

EVENT_KEY_REQUIRED

EVENT_KEY_EXPIRED

EVENT_PROVISION_REQUIRED

KEY_TYPE_STREAMING

KEY_TYPE_OFFLINE

KEY_TYPE_RELEASE

方法详细资料

setOnEventListener

setOnKeyStatusChangeListener

setOnExpirationUpdateListener

openSession

closeSession

getKeyRequest

provideKeyResponse

getProvisionRequest

provideProvisionResponse

queryKeyStatus

acquire

release

restoreKeys

getMetrics

getPropertyString

getPropertyByteArray

setPropertyString

setPropertyByteArray

createMediaCrypto

getExoMediaCryptoType