com.brightcove.player.drm

Interface DrmSession<T extends com.google.android.exoplayer.drm.ExoMediaCrypto>

All Superinterfaces:

BrightcoveDrmSession

All Known Implementing Classes:

ExoPlayerDrmSessionManager

Deprecated.

@Deprecated
public interface DrmSession<T extends com.google.android.exoplayer.drm.ExoMediaCrypto>
extends BrightcoveDrmSession

The contract of an ExoPlayer 1 compatible DRM Session.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DrmSession.DrmSessionException Deprecated. Describes an error condition related to the DrmSession

Method Summary

Modifier and Type	Method and Description
DrmSession.DrmSessionException	getError() Deprecated. Returns the cause of the error state.
T	getMediaCrypto() Deprecated. Provides reference to the current DRM session.
byte[]	getOfflineLicenseKeySetId() Deprecated. Returns the key set id of the offline license loaded into this session, if there is one.
int	getState() Deprecated. Returns the current state of the session.
java.util.Map<java.lang.String,java.lang.String>	queryKeyStatus() Deprecated. Returns an informative description of the key status for the session.
boolean	requiresSecureDecoderComponent(java.lang.String mimeType) Deprecated. Whether the session requires a secure decoder for the specified mime type.

Methods inherited from interface com.brightcove.player.drm.BrightcoveDrmSession

getDrmError, getPropertyByteArray, getPropertyString, setPropertyByteArray, setPropertyString

Method Detail

getState

int getState()

Deprecated.

Returns the current state of the session.

Returns:

One of DrmSessionManager.STATE_ERROR, DrmSessionManager.STATE_CLOSED, DrmSessionManager.STATE_OPENING, DrmSessionManager.STATE_OPENED or DrmSessionManager.STATE_OPENED_WITH_KEYS.

getMediaCrypto

T getMediaCrypto()

Deprecated.

Provides reference to the current DRM session.

This method may be called when the session is in the following states: DrmSessionManager.STATE_OPENED, DrmSessionManager.STATE_OPENED_WITH_KEYS

Returns:

A ExoMediaCrypto for the open session.

Throws:

java.lang.IllegalStateException - If called when a session isn't opened.

requiresSecureDecoderComponent

boolean requiresSecureDecoderComponent(java.lang.String mimeType)

Deprecated.

Whether the session requires a secure decoder for the specified mime type.

Normally this method should return ExoMediaCrypto.requiresSecureDecoderComponent(String), however in some cases implementations may wish to modify the return value (i.e. to force a secure decoder even when one is not required).

This method may be called when the session is in the following states: DrmSessionManager.STATE_OPENED, DrmSessionManager.STATE_OPENED_WITH_KEYS

Returns:

Whether the open session requires a secure decoder for the specified mime type.

Throws:

java.lang.IllegalStateException - If called when a session isn't opened.

getError

DrmSession.DrmSessionException getError()

Deprecated.

Returns the cause of the error state.

This method may be called when the session is in any state.

Returns:

An exception if the state is DrmSessionManager.STATE_ERROR. Null otherwise.

queryKeyStatus

java.util.Map<java.lang.String,java.lang.String> queryKeyStatus()

Deprecated.

Returns an informative description of the key status for the session. The status is in the form of {name, value} pairs.

Since DRM license policies vary by vendor, the specific status field names are determined by each DRM vendor. Refer to your DRM provider documentation for definitions of the field names for a particular DRM engine plugin.

Specified by:

queryKeyStatus in interface BrightcoveDrmSession

Returns:

A map of key status.

Throws:

java.lang.IllegalStateException - If called when the session isn't opened.

See Also:

MediaDrm#queryKeyStatus(byte[])

getOfflineLicenseKeySetId

byte[] getOfflineLicenseKeySetId()

Deprecated.

Returns the key set id of the offline license loaded into this session, if there is one. Null otherwise.

Specified by:

getOfflineLicenseKeySetId in interface BrightcoveDrmSession