FrameworkMediaDrm (ijkplayer-drm API)

java.lang.Object
- tv.danmaku.ijk.media.drm.FrameworkMediaDrm

所有已实现的接口:

ExoMediaDrm
```
public final class FrameworkMediaDrm
extends java.lang.Object
implements ExoMediaDrm
```
An ExoMediaDrm implementation that wraps the framework MediaDrm.

嵌套类概要
- 从接口继承的嵌套类/接口 tv.danmaku.ijk.media.drm.ExoMediaDrm
  ExoMediaDrm.AppManagedProvider, ExoMediaDrm.KeyRequest, ExoMediaDrm.KeyStatus, ExoMediaDrm.OnEventListener, ExoMediaDrm.OnExpirationUpdateListener, ExoMediaDrm.OnKeyStatusChangeListener, ExoMediaDrm.Provider, ExoMediaDrm.ProvisionRequest

字段概要

字段
限定符和类型字段和说明

static ExoMediaDrm.Provider DEFAULT_PROVIDER
ExoMediaDrm.Provider that returns a new FrameworkMediaDrm for the requested UUID.
- 从接口继承的字段 tv.danmaku.ijk.media.drm.ExoMediaDrm
  EVENT_KEY_EXPIRED, EVENT_KEY_REQUIRED, EVENT_PROVISION_REQUIRED, KEY_TYPE_OFFLINE, KEY_TYPE_RELEASE, KEY_TYPE_STREAMING

字段
限定符和类型	字段和说明
`static ExoMediaDrm.Provider`	`DEFAULT_PROVIDER` `ExoMediaDrm.Provider` that returns a new `FrameworkMediaDrm` for the requested UUID.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`acquire()` Increments the reference count.
`void`	`closeSession(byte[] sessionId)` Closes a DRM session.
`FrameworkMediaCrypto`	`createMediaCrypto(byte[] initData)` Creates an `ExoMediaCrypto` for a given session.
`java.lang.Class<FrameworkMediaCrypto>`	`getExoMediaCryptoType()` Returns the `ExoMediaCrypto` type created by `ExoMediaDrm.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.
`static boolean`	`isCryptoSchemeSupported(java.util.UUID uuid)` Returns whether the DRM scheme with the given UUID is supported on this device.
`static FrameworkMediaDrm`	`newInstance(java.util.UUID uuid)` Creates an instance with an initial reference count of 1.
`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 `ExoMediaDrm.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 `ExoMediaDrm.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.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DEFAULT_PROVIDER
```
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.
- 方法详细资料
  - isCryptoSchemeSupported
```
public static boolean isCryptoSchemeSupported(java.util.UUID uuid)
```
    Returns whether the DRM scheme with the given UUID is supported on this device.
    
    另请参阅:
    
    MediaDrm.isCryptoSchemeSupported(UUID)
  - newInstance
```
public static FrameworkMediaDrm newInstance(java.util.UUID uuid)
                                     throws UnsupportedDrmException
```
    Creates an instance with an initial reference count of 1. release() must be called on the instance when it's no longer required.
    
    参数:
    
    uuid - The scheme uuid.
    
    返回:
    
    The created instance.
    
    抛出:
    
    UnsupportedDrmException - If the DRM scheme is unsupported or cannot be instantiated.
  - setOnEventListener
```
public void setOnEventListener(ExoMediaDrm.OnEventListener listener)
```
    从接口复制的说明: ExoMediaDrm
    
    Sets the listener for DRM events.
    This is an optional method, and some implementations may only support it on certain Android API levels.
    
    指定者:
    
    setOnEventListener 在接口中 ExoMediaDrm
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    另请参阅:
    
    MediaDrm.setOnEventListener(MediaDrm.OnEventListener)
  - setOnKeyStatusChangeListener
```
public 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.
    
    指定者:
    
    setOnKeyStatusChangeListener 在接口中 ExoMediaDrm
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    抛出:
    
    java.lang.UnsupportedOperationException - on API levels lower than 23.
    
    另请参阅:
    
    MediaDrm.setOnKeyStatusChangeListener(MediaDrm.OnKeyStatusChangeListener, Handler)
  - setOnExpirationUpdateListener
```
public 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.
    
    指定者:
    
    setOnExpirationUpdateListener 在接口中 ExoMediaDrm
    
    参数:
    
    listener - The listener to receive events, or null to stop receiving events.
    
    抛出:
    
    java.lang.UnsupportedOperationException - on API levels lower than 23.
    
    另请参阅:
    
    MediaDrm.setOnExpirationUpdateListener(MediaDrm.OnExpirationUpdateListener, Handler)
  - openSession
```
public byte[] openSession()
                   throws android.media.MediaDrmException
```
    从接口复制的说明: ExoMediaDrm
    
    Opens a new DRM session. A session ID is returned.
    
    指定者:
    
    openSession 在接口中 ExoMediaDrm
    
    返回:
    
    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
```
public void closeSession(byte[] sessionId)
```
    从接口复制的说明: ExoMediaDrm
    
    Closes a DRM session.
    
    指定者:
    
    closeSession 在接口中 ExoMediaDrm
    
    参数:
    
    sessionId - The ID of the session to close.
  - getKeyRequest
```
public 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
```
    从接口复制的说明: ExoMediaDrm
    
    Generates a key request.
    
    指定者:
    
    getKeyRequest 在接口中 ExoMediaDrm
    
    参数:
    
    scope - If keyType is ExoMediaDrm.KEY_TYPE_STREAMING or ExoMediaDrm.KEY_TYPE_OFFLINE, the ID of the session 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.
    
    返回:
    
    The generated key request.
    
    抛出:
    
    android.media.NotProvisionedException
    
    另请参阅:
    
    MediaDrm.getKeyRequest(byte[], byte[], String, int, HashMap)
  - provideKeyResponse
```
public byte[] provideKeyResponse(byte[] scope,
                                 byte[] response)
                          throws android.media.NotProvisionedException,
                                 android.media.DeniedByServerException
```
    从接口复制的说明: ExoMediaDrm
    
    Provides a key response for the last request to be generated using ExoMediaDrm.getKeyRequest(byte[], java.util.List<tv.danmaku.ijk.media.drm.DrmInitData.SchemeData>, int, java.util.HashMap<java.lang.String, java.lang.String>).
    
    指定者:
    
    provideKeyResponse 在接口中 ExoMediaDrm
    
    参数:
    
    scope - If the request had type ExoMediaDrm.KEY_TYPE_STREAMING or ExoMediaDrm.KEY_TYPE_OFFLINE, the ID of the session to provide the keys to. If keyType is ExoMediaDrm.KEY_TYPE_RELEASE, the keySetId of the keys being released.
    
    response - The response data from the server.
    
    返回:
    
    If the request had type ExoMediaDrm.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
```
public ExoMediaDrm.ProvisionRequest getProvisionRequest()
```
    从接口复制的说明: ExoMediaDrm
    
    Generates a provisioning request.
    
    指定者:
    
    getProvisionRequest 在接口中 ExoMediaDrm
    
    返回:
    
    The generated provisioning request.
  - provideProvisionResponse
```
public void provideProvisionResponse(byte[] response)
                              throws android.media.DeniedByServerException
```
    从接口复制的说明: ExoMediaDrm
    
    Provides a provisioning response for the last request to be generated using ExoMediaDrm.getProvisionRequest().
    
    指定者:
    
    provideProvisionResponse 在接口中 ExoMediaDrm
    
    参数:
    
    response - The response data from the server.
    
    抛出:
    
    android.media.DeniedByServerException - If the response indicates that the server rejected the request.
  - queryKeyStatus
```
public java.util.Map<java.lang.String,java.lang.String> queryKeyStatus(byte[] sessionId)
```
    从接口复制的说明: ExoMediaDrm
    
    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.
    
    指定者:
    
    queryKeyStatus 在接口中 ExoMediaDrm
    
    参数:
    
    sessionId - The ID of the session being queried.
    
    返回:
    
    The key status for the session.
  - acquire
```
public void acquire()
```
    从接口复制的说明: ExoMediaDrm
    
    Increments the reference count. When the caller no longer needs to use the instance, it must call ExoMediaDrm.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.
    
    指定者:
    
    acquire 在接口中 ExoMediaDrm
  - release
```
public void release()
```
    从接口复制的说明: ExoMediaDrm
    
    Decrements the reference count. If the reference count drops to 0 underlying resources are released, and the instance cannot be re-used.
    
    指定者:
    
    release 在接口中 ExoMediaDrm
  - restoreKeys
```
public void restoreKeys(byte[] sessionId,
                        byte[] keySetId)
```
    从接口复制的说明: ExoMediaDrm
    
    Restores persisted offline keys into a session.
    
    指定者:
    
    restoreKeys 在接口中 ExoMediaDrm
    
    参数:
    
    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 ExoMediaDrm.provideKeyResponse(byte[], byte[]) that persisted them.
  - getMetrics
```
public android.os.PersistableBundle getMetrics()
```
    从接口复制的说明: ExoMediaDrm
    
    Returns metrics data for this ExoMediaDrm instance, or null if metrics are unavailable.
    
    指定者:
    
    getMetrics 在接口中 ExoMediaDrm
  - getPropertyString
```
public java.lang.String getPropertyString(java.lang.String propertyName)
```
    从接口复制的说明: ExoMediaDrm
    
    Returns the value of a string property. For standard property names, see MediaDrm.getPropertyString(java.lang.String).
    
    指定者:
    
    getPropertyString 在接口中 ExoMediaDrm
    
    参数:
    
    propertyName - The property name.
    
    返回:
    
    The property value.
  - getPropertyByteArray
```
public byte[] getPropertyByteArray(java.lang.String propertyName)
```
    从接口复制的说明: ExoMediaDrm
    
    Returns the value of a byte array property. For standard property names, see MediaDrm.getPropertyByteArray(java.lang.String).
    
    指定者:
    
    getPropertyByteArray 在接口中 ExoMediaDrm
    
    参数:
    
    propertyName - The property name.
    
    返回:
    
    The property value.
  - setPropertyString
```
public void setPropertyString(java.lang.String propertyName,
                              java.lang.String value)
```
    从接口复制的说明: ExoMediaDrm
    
    Sets the value of a string property.
    
    指定者:
    
    setPropertyString 在接口中 ExoMediaDrm
    
    参数:
    
    propertyName - The property name.
    
    value - The value.
  - setPropertyByteArray
```
public void setPropertyByteArray(java.lang.String propertyName,
                                 byte[] value)
```
    从接口复制的说明: ExoMediaDrm
    
    Sets the value of a byte array property.
    
    指定者:
    
    setPropertyByteArray 在接口中 ExoMediaDrm
    
    参数:
    
    propertyName - The property name.
    
    value - The value.
  - createMediaCrypto
```
public FrameworkMediaCrypto createMediaCrypto(byte[] initData)
                                       throws android.media.MediaCryptoException
```
    从接口复制的说明: ExoMediaDrm
    
    Creates an ExoMediaCrypto for a given session.
    
    指定者:
    
    createMediaCrypto 在接口中 ExoMediaDrm
    
    参数:
    
    initData - The ID of the session.
    
    返回:
    
    An ExoMediaCrypto for the given session.
    
    抛出:
    
    android.media.MediaCryptoException - If an ExoMediaCrypto could not be created.
  - getExoMediaCryptoType
```
public java.lang.Class<FrameworkMediaCrypto> getExoMediaCryptoType()
```
    从接口复制的说明: ExoMediaDrm
    
    Returns the ExoMediaCrypto type created by ExoMediaDrm.createMediaCrypto(byte[]).
    
    指定者:
    
    getExoMediaCryptoType 在接口中 ExoMediaDrm

类 FrameworkMediaDrm

嵌套类概要

从接口继承的嵌套类/接口 tv.danmaku.ijk.media.drm.ExoMediaDrm

字段概要

从接口继承的字段 tv.danmaku.ijk.media.drm.ExoMediaDrm

方法概要

从类继承的方法 java.lang.Object

字段详细资料

DEFAULT_PROVIDER

方法详细资料

isCryptoSchemeSupported

newInstance

setOnEventListener

setOnKeyStatusChangeListener

setOnExpirationUpdateListener

openSession

closeSession

getKeyRequest

provideKeyResponse

getProvisionRequest

provideProvisionResponse

queryKeyStatus

acquire

release

restoreKeys

getMetrics

getPropertyString

getPropertyByteArray

setPropertyString

setPropertyByteArray

createMediaCrypto

getExoMediaCryptoType