com.google.android.exoplayer2.drm

Class OfflineLicenseHelper<T extends ExoMediaCrypto>

java.lang.Object

com.google.android.exoplayer2.drm.OfflineLicenseHelper<T>

public final class OfflineLicenseHelper<T extends ExoMediaCrypto>
extends java.lang.Object

Helper class to download, renew and release offline licenses.

Constructor Summary

Constructors

Constructor and Description
OfflineLicenseHelper(ExoMediaDrm<T> mediaDrm, MediaDrmCallback callback, java.util.HashMap<java.lang.String,java.lang.String> optionalKeyRequestParameters) Constructs an instance.

Method Summary

Modifier and Type	Method and Description
byte[]	downloadLicense(DrmInitData drmInitData) Downloads an offline license.
android.util.Pair<java.lang.Long,java.lang.Long>	getLicenseDurationRemainingSec(byte[] offlineLicenseKeySetId) Returns the remaining license and playback durations in seconds, for an offline license.
static OfflineLicenseHelper<FrameworkMediaCrypto>	newWidevineInstance(MediaDrmCallback callback, java.util.HashMap<java.lang.String,java.lang.String> optionalKeyRequestParameters) Instantiates a new instance which uses Widevine CDM.
static OfflineLicenseHelper<FrameworkMediaCrypto>	newWidevineInstance(java.lang.String licenseUrl, HttpDataSource.Factory httpDataSourceFactory) Instantiates a new instance which uses Widevine CDM.
void	release() Releases the helper.
void	releaseLicense(byte[] offlineLicenseKeySetId) Releases an offline license.
byte[]	renewLicense(byte[] offlineLicenseKeySetId) Renews an offline license.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OfflineLicenseHelper

public OfflineLicenseHelper(ExoMediaDrm<T> mediaDrm,
                            MediaDrmCallback callback,
                            java.util.HashMap<java.lang.String,java.lang.String> optionalKeyRequestParameters)

Constructs an instance. Call release() when the instance is no longer required.

Parameters:

mediaDrm - An underlying ExoMediaDrm for use by the manager.

callback - Performs key and provisioning requests.

optionalKeyRequestParameters - An optional map of parameters to pass as the last argument to MediaDrm.getKeyRequest(byte[], byte[], String, int, HashMap). May be null.

See Also:

DefaultDrmSessionManager.DefaultDrmSessionManager(java.util.UUID, ExoMediaDrm, MediaDrmCallback, HashMap, Handler, EventListener)

Method Detail

newWidevineInstance

public static OfflineLicenseHelper<FrameworkMediaCrypto> newWidevineInstance(java.lang.String licenseUrl,
                                                                             HttpDataSource.Factory httpDataSourceFactory)
                                                                      throws UnsupportedDrmException

Instantiates a new instance which uses Widevine CDM. Call release() when the instance is no longer required.

Parameters:

licenseUrl - The default license URL.

httpDataSourceFactory - A factory from which to obtain HttpDataSource instances.

Returns:

A new instance which uses Widevine CDM.

Throws:

UnsupportedDrmException - If the Widevine DRM scheme is unsupported or cannot be instantiated.

newWidevineInstance

public static OfflineLicenseHelper<FrameworkMediaCrypto> newWidevineInstance(MediaDrmCallback callback,
                                                                             java.util.HashMap<java.lang.String,java.lang.String> optionalKeyRequestParameters)
                                                                      throws UnsupportedDrmException

Instantiates a new instance which uses Widevine CDM. Call release() when the instance is no longer required.

Parameters:

callback - Performs key and provisioning requests.

optionalKeyRequestParameters - An optional map of parameters to pass as the last argument to MediaDrm.getKeyRequest(byte[], byte[], String, int, HashMap). May be null.

Returns:

A new instance which uses Widevine CDM.

Throws:

UnsupportedDrmException - If the Widevine DRM scheme is unsupported or cannot be instantiated.

See Also:

DefaultDrmSessionManager.DefaultDrmSessionManager(java.util.UUID, ExoMediaDrm, MediaDrmCallback, HashMap, Handler, EventListener)

release

public void release()

Releases the helper. Should be called when the helper is no longer required.

downloadLicense

public byte[] downloadLicense(DrmInitData drmInitData)
                       throws java.io.IOException,
                              java.lang.InterruptedException,
                              DrmSession.DrmSessionException

Downloads an offline license.

Parameters:

drmInitData - The DrmInitData for the content whose license is to be downloaded.

Returns:

The key set id for the downloaded license.

Throws:

java.io.IOException - If an error occurs reading data from the stream.

java.lang.InterruptedException - If the thread has been interrupted.

DrmSession.DrmSessionException - Thrown when a DRM session error occurs.

renewLicense

public byte[] renewLicense(byte[] offlineLicenseKeySetId)
                    throws DrmSession.DrmSessionException

Renews an offline license.

Parameters:

offlineLicenseKeySetId - The key set id of the license to be renewed.

Returns:

The renewed offline license key set id.

Throws:

DrmSession.DrmSessionException - Thrown when a DRM session error occurs.

releaseLicense

public void releaseLicense(byte[] offlineLicenseKeySetId)
                    throws DrmSession.DrmSessionException

Releases an offline license.

Parameters:

offlineLicenseKeySetId - The key set id of the license to be released.

Throws:

DrmSession.DrmSessionException - Thrown when a DRM session error occurs.

getLicenseDurationRemainingSec

public android.util.Pair<java.lang.Long,java.lang.Long> getLicenseDurationRemainingSec(byte[] offlineLicenseKeySetId)
                                                                                throws DrmSession.DrmSessionException

Returns the remaining license and playback durations in seconds, for an offline license.

Parameters:

offlineLicenseKeySetId - The key set id of the license.

Returns:

The remaining license and playback durations, in seconds.

Throws:

DrmSession.DrmSessionException - Thrown when a DRM session error occurs.