com.google.android.exoplayer.drm

Interface DrmSessionManager<T extends ExoMediaCrypto>

All Known Implementing Classes:

StreamingDrmSessionManager

public interface DrmSessionManager<T extends ExoMediaCrypto>

Manages a DRM session.

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATE_CLOSED The session is closed.
static int	STATE_ERROR The error state.
static int	STATE_OPENED The session is open, but does not yet have the keys required for decryption.
static int	STATE_OPENED_WITH_KEYS The session is open and has the keys required for decryption.
static int	STATE_OPENING The session is being opened (i.e.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the session.
Exception	getError() Gets the cause of the error state.
T	getMediaCrypto() Gets an ExoMediaCrypto for the open session.
int	getState() Gets the current state of the session.
void	open(DrmInitData drmInitData) Opens the session, possibly asynchronously.
boolean	requiresSecureDecoderComponent(String mimeType) Whether the session requires a secure decoder for the specified mime type.

Field Detail

STATE_ERROR

static final int STATE_ERROR

The error state. getError() can be used to retrieve the cause.

See Also:

Constant Field Values

STATE_CLOSED

static final int STATE_CLOSED

The session is closed.

See Also:

Constant Field Values

STATE_OPENING

static final int STATE_OPENING

The session is being opened (i.e. open(DrmInitData) has been called, but the session is not yet open).

See Also:

Constant Field Values

STATE_OPENED

static final int STATE_OPENED

The session is open, but does not yet have the keys required for decryption.

See Also:

Constant Field Values

STATE_OPENED_WITH_KEYS

static final int STATE_OPENED_WITH_KEYS

The session is open and has the keys required for decryption.

See Also:

Constant Field Values

Method Detail

open

void open(DrmInitData drmInitData)

Opens the session, possibly asynchronously.

Parameters:

drmInitData - DRM initialization data.

close

void close()

Closes the session.

getState

int getState()

Gets the current state of the session.

Returns:

One of STATE_ERROR, STATE_CLOSED, STATE_OPENING, STATE_OPENED and STATE_OPENED_WITH_KEYS.

getMediaCrypto

T getMediaCrypto()

Gets an ExoMediaCrypto for the open session.

This method may be called when the manager is in the following states: STATE_OPENED, STATE_OPENED_WITH_KEYS

Returns:

An ExoMediaCrypto for the open session.

Throws:

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

requiresSecureDecoderComponent

boolean requiresSecureDecoderComponent(String mimeType)

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

Normally this method should return MediaCrypto.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 manager is in the following states: STATE_OPENED, STATE_OPENED_WITH_KEYS

Returns:

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

Throws:

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

getError

Exception getError()

Gets the cause of the error state.

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

Returns:

An exception if the state is STATE_ERROR. Null otherwise.