com.brightcove.player.drm

Class OfflineLicenseManager<T extends com.google.android.exoplayer2.drm.ExoMediaCrypto>

java.lang.Object

com.brightcove.player.drm.OfflineLicenseManager<T>

All Implemented Interfaces:

LicenseManager

public class OfflineLicenseManager<T extends com.google.android.exoplayer2.drm.ExoMediaCrypto>
extends java.lang.Object
implements LicenseManager

Offline license helper can be used to download, renew and release offline playback licenses.

Field Summary

Fields inherited from interface com.brightcove.player.drm.LicenseManager

CR_TOKEN_HEADER

Constructor Summary

Constructors

Constructor and Description
OfflineLicenseManager(com.google.android.exoplayer2.drm.ExoMediaDrm<T> mediaDrm, com.google.android.exoplayer2.drm.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(java.lang.String manifestUriString, CustomerRightsToken customerRightsToken) Downloads an offline license.
java.lang.String	getPropertyString(java.lang.String key) Gets the specified property.
android.util.Pair<java.lang.Long,java.lang.Long>	getRemainingLicenseDuration(byte[] licenseKeySetId) Returns license and playback durations remaining in seconds of the given offline license.
void	releaseLicense(byte[] licenseKeySetId) Releases an offline license.
void	releaseResources() Releases the used resources.
byte[]	renewLicense(byte[] licenseKeySetId) Renews an offline license.
void	setPropertyString(java.lang.String key, java.lang.String value) Sets the specified property.

Methods inherited from class java.lang.Object

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

Constructor Detail

OfflineLicenseManager

public OfflineLicenseManager(com.google.android.exoplayer2.drm.ExoMediaDrm<T> mediaDrm,
                             com.google.android.exoplayer2.drm.MediaDrmCallback callback,
                             java.util.HashMap<java.lang.String,java.lang.String> optionalKeyRequestParameters)

Constructs an instance. Call releaseResources() when you're done with it.

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.

Method Detail

releaseResources

public void releaseResources()

Description copied from interface: LicenseManager

Releases the used resources.

Specified by:

releaseResources in interface LicenseManager

setPropertyString

public void setPropertyString(java.lang.String key,
                              java.lang.String value)

Description copied from interface: LicenseManager

Sets the specified property.

Specified by:

setPropertyString in interface LicenseManager

getPropertyString

public java.lang.String getPropertyString(java.lang.String key)

Description copied from interface: LicenseManager

Gets the specified property.

Specified by:

getPropertyString in interface LicenseManager

downloadLicense

@Nullable
public byte[] downloadLicense(java.lang.String manifestUriString,
                                        @NonNull
                                        CustomerRightsToken customerRightsToken)
                                 throws java.io.IOException,
                                        java.lang.InterruptedException,
                                        DrmException

Description copied from interface: LicenseManager

Downloads an offline license.

Specified by:

downloadLicense in interface LicenseManager

Parameters:

manifestUriString - the URL to the DASH manifest file.

customerRightsToken - the customer rights token that describes the license type and limitations.

Returns:

The downloaded offline license key set id.

Throws:

java.io.IOException - If an error occurs while attempt to read the manifest from the stream.

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

DrmException - Thrown when there is an error during DRM session.

renewLicense

@Nullable
public byte[] renewLicense(byte[] licenseKeySetId)
                              throws DrmException

Description copied from interface: LicenseManager

Renews an offline license.

Specified by:

renewLicense in interface LicenseManager

Parameters:

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

Returns:

Renewed offline license key set id.

Throws:

DrmException - Thrown when there is an error during DRM session.

releaseLicense

public void releaseLicense(@Nullable
                           byte[] licenseKeySetId)
                    throws DrmException

Description copied from interface: LicenseManager

Releases an offline license.

Specified by:

releaseLicense in interface LicenseManager

Parameters:

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

Throws:

DrmException - Thrown when there is an error during DRM session.

getRemainingLicenseDuration

@Nullable
public android.util.Pair<java.lang.Long,java.lang.Long> getRemainingLicenseDuration(byte[] licenseKeySetId)
                                                                                       throws DrmException

Description copied from interface: LicenseManager

Returns license and playback durations remaining in seconds of the given offline license. The Pair.first value in the result will provide the remaining license duration as total number of seconds, while Pair.second value will provide the remain play duration as total number of seconds.

Specified by:

getRemainingLicenseDuration in interface LicenseManager

Parameters:

licenseKeySetId - The key set id of the license.

Throws:

DrmException