public static final String PLAYREADY_CUSTOM_DATA_KEY

A key for specifying PlayReady custom data in the key request parameters passed to DefaultDrmSessionManager.Builder.setKeyRequestParameters(Map).

public static final int MODE_PLAYBACK

Loads and refreshes (if necessary) a license for playback. Supports streaming and offline licenses.

public static final int MODE_QUERY

Restores an offline license to allow its status to be queried.

public static final int MODE_DOWNLOAD

Downloads an offline license or renews an existing one.

public static final int MODE_RELEASE

Releases an existing offline license.

public static final int INITIAL_DRM_REQUEST_RETRY_COUNT

Number of times to retry for initial provisioning and key request for reporting error.

public void setMode​(@com.google.android.exoplayer2.drm.DefaultDrmSessionManager.Mode int mode,
                    @Nullable
                    byte[] offlineLicenseKeySetId)

Sets the mode, which determines the role of sessions acquired from the instance. This must be called before acquireSession(DrmSessionEventListener.EventDispatcher, Format) is called.

By default, the mode is MODE_PLAYBACK and a streaming license is requested when required.

mode must be one of these:

• MODE_PLAYBACK: If offlineLicenseKeySetId is null then a streaming license is requested. Otherwise, the offline license is restored.
• MODE_QUERY: offlineLicenseKeySetId cannot be null. The offline license is restored to allow its status to be queried.
• MODE_DOWNLOAD: If offlineLicenseKeySetId is null then an offline license is requested. Otherwise, the offline license is renewed.
• MODE_RELEASE: offlineLicenseKeySetId cannot be null. The offline license is released.

public final void prepare()

Acquires any required resources.

DrmSessionManager.release() must be called to ensure the acquired resources are released. After releasing, an instance may be re-prepared.

public final void release()

Releases any acquired resources.

public void setPlayer​(Looper playbackLooper,
                      PlayerId playerId)

Sets information about the player using this DRM session manager.

public DrmSessionManager.DrmSessionReference preacquireSession​(@Nullable
                                                               DrmSessionEventListener.EventDispatcher eventDispatcher,
                                                               Format format)

Pre-acquires a DRM session for the specified Format.

This notifies the manager that a subsequent call to DrmSessionManager.acquireSession( DrmSessionEventListener.EventDispatcher, Format) with the same Format is likely, allowing a manager that supports pre-acquisition to get the required DrmSession ready in the background.

The caller must call DrmSessionManager.DrmSessionReference.release() on the returned instance when they no longer require the pre-acquisition (i.e. they know they won't be making a matching call to DrmSessionManager.acquireSession(DrmSessionEventListener.EventDispatcher, Format) in the near future).

This manager may silently release the underlying session in order to allow another operation to complete. This will result in a subsequent call to DrmSessionManager.acquireSession( DrmSessionEventListener.EventDispatcher, Format) re-initializing a new session, including repeating key loads and other async initialization steps.

The caller must separately call DrmSessionManager.acquireSession( DrmSessionEventListener.EventDispatcher, Format) in order to obtain a session suitable for playback. The pre-acquired DrmSessionManager.DrmSessionReference and full DrmSession instances are distinct. The caller must release both, and can release the DrmSessionManager.DrmSessionReference before the DrmSession without affecting playback.

This can be called from any thread.

Implementations that do not support pre-acquisition always return an empty DrmSessionManager.DrmSessionReference instance.

@Nullable
public DrmSession acquireSession​(@Nullable
                                 DrmSessionEventListener.EventDispatcher eventDispatcher,
                                 Format format)

Returns a DrmSession for the specified Format, with an incremented reference count. May return null if the Format.drmInitData is null and the DRM session manager is not configured to attach a DrmSession to clear content. When the caller no longer needs to use a returned DrmSession, it must call DrmSession.release(DrmSessionEventListener.EventDispatcher) to decrement the reference count.

If the provided Format contains a null Format.drmInitData, the returned DrmSession (if not null) will be a placeholder session which does not execute key requests, and cannot be used to handle encrypted content. However, a placeholder session may be used to configure secure decoders for playback of clear content periods, which can reduce the cost of transitioning between clear and encrypted content.