From 0e092f806b0a4b81785a52da8ba22d2d47087de5 Mon Sep 17 00:00:00 2001 From: Bill Gruber Date: Thu, 17 Mar 2011 16:04:18 -0700 Subject: [PATCH] DRM API doc scrub This change contains information contributed by Sony Corporation. Bug: 4119363 Change-Id: I6f565c15d512d675993dc65f7fee19bd3d0bc0fa --- docs/html/images/drm_arch.png | Bin 0 -> 24108 bytes drm/java/android/drm/DrmConvertedStatus.java | 23 +- drm/java/android/drm/DrmErrorEvent.java | 45 ++- drm/java/android/drm/DrmEvent.java | 53 +-- drm/java/android/drm/DrmInfo.java | 70 ++-- drm/java/android/drm/DrmInfoEvent.java | 38 +- drm/java/android/drm/DrmInfoRequest.java | 61 ++-- drm/java/android/drm/DrmInfoStatus.java | 34 +- drm/java/android/drm/DrmManagerClient.java | 348 ++++++++++--------- drm/java/android/drm/DrmRights.java | 92 ++--- drm/java/android/drm/DrmStore.java | 82 +++-- drm/java/android/drm/DrmSupportInfo.java | 66 ++-- drm/java/android/drm/DrmUtils.java | 24 +- drm/java/android/drm/ProcessedData.java | 34 +- drm/java/android/drm/package.html | 85 +++++ 15 files changed, 589 insertions(+), 466 deletions(-) create mode 100755 docs/html/images/drm_arch.png mode change 100644 => 100755 drm/java/android/drm/DrmConvertedStatus.java mode change 100644 => 100755 drm/java/android/drm/DrmErrorEvent.java mode change 100644 => 100755 drm/java/android/drm/DrmEvent.java mode change 100644 => 100755 drm/java/android/drm/DrmInfo.java mode change 100644 => 100755 drm/java/android/drm/DrmInfoEvent.java mode change 100644 => 100755 drm/java/android/drm/DrmInfoRequest.java mode change 100644 => 100755 drm/java/android/drm/DrmInfoStatus.java mode change 100644 => 100755 drm/java/android/drm/DrmManagerClient.java mode change 100644 => 100755 drm/java/android/drm/DrmRights.java mode change 100644 => 100755 drm/java/android/drm/DrmStore.java mode change 100644 => 100755 drm/java/android/drm/DrmSupportInfo.java mode change 100644 => 100755 drm/java/android/drm/DrmUtils.java mode change 100644 => 100755 drm/java/android/drm/ProcessedData.java create mode 100755 drm/java/android/drm/package.html diff --git a/docs/html/images/drm_arch.png b/docs/html/images/drm_arch.png new file mode 100755 index 0000000000000000000000000000000000000000..1696a97781a2a2ac97c204b75fefc672fcc86144 GIT binary patch literal 24108 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 bi`Ue5DrmConvertedStatus object with the specified parameters. * - * @param _statusCode Status of the conversion - * @param _convertedData Converted data/checksum data - * @param _offset Offset value + * @param _statusCode Conversion status. + * @param _convertedData Converted data. + * @param _offset Offset value for appending the header and body signature. */ public DrmConvertedStatus(int _statusCode, byte[] _convertedData, int _offset) { statusCode = _statusCode; diff --git a/drm/java/android/drm/DrmErrorEvent.java b/drm/java/android/drm/DrmErrorEvent.java old mode 100644 new mode 100755 index 7cc9a876df828..2cb82e67e14b9 --- a/drm/java/android/drm/DrmErrorEvent.java +++ b/drm/java/android/drm/DrmErrorEvent.java @@ -19,70 +19,69 @@ package android.drm; import java.util.HashMap; /** - * This is an entity class which would be passed to caller in - * {@link DrmManagerClient.OnErrorListener#onError(DrmManagerClient, DrmErrorEvent)} + * An entity class that is passed to the + * {@link DrmManagerClient.OnErrorListener#onError onError()} callback. * */ public class DrmErrorEvent extends DrmEvent { /** - * TYPE_RIGHTS_NOT_INSTALLED, when something went wrong installing the rights. + * Something went wrong installing the rights. */ public static final int TYPE_RIGHTS_NOT_INSTALLED = 2001; /** - * TYPE_RIGHTS_RENEWAL_NOT_ALLOWED, when the server rejects renewal of rights. + * The server rejected the renewal of rights. */ public static final int TYPE_RIGHTS_RENEWAL_NOT_ALLOWED = 2002; /** - * TYPE_NOT_SUPPORTED, when answer from server can not be handled by the native agent. + * Response from the server cannot be handled by the DRM plug-in (agent). */ public static final int TYPE_NOT_SUPPORTED = 2003; /** - * TYPE_OUT_OF_MEMORY, when memory allocation fail during renewal. - * Can in the future perhaps be used to trigger garbage collector. + * Memory allocation failed during renewal. Can in the future perhaps be used to trigger + * garbage collector. */ public static final int TYPE_OUT_OF_MEMORY = 2004; /** - * TYPE_NO_INTERNET_CONNECTION, when the Internet connection is missing and no attempt - * can be made to renew rights. + * An Internet connection is not available and no attempt can be made to renew rights. */ public static final int TYPE_NO_INTERNET_CONNECTION = 2005; /** - * TYPE_PROCESS_DRM_INFO_FAILED, when failed to process DrmInfo. + * Failed to process {@link DrmInfo}. This error event is sent when a + * {@link DrmManagerClient#processDrmInfo processDrmInfo()} call fails. */ public static final int TYPE_PROCESS_DRM_INFO_FAILED = 2006; /** - * TYPE_REMOVE_ALL_RIGHTS_FAILED, when failed to remove all the rights objects - * associated with all DRM schemes. + * Failed to remove all the rights objects associated with all DRM schemes. */ public static final int TYPE_REMOVE_ALL_RIGHTS_FAILED = 2007; /** - * TYPE_ACQUIRE_DRM_INFO_FAILED, when failed to acquire DrmInfo. + * Failed to acquire {@link DrmInfo}. This error event is sent when an + * {@link DrmManagerClient#acquireDrmInfo acquireDrmInfo()} call fails. */ public static final int TYPE_ACQUIRE_DRM_INFO_FAILED = 2008; /** - * constructor to create DrmErrorEvent object with given parameters + * Creates a DrmErrorEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of the event. It could be one of the types defined above - * @param message Message description + * @param uniqueId Unique session identifier. + * @param type Type of the event. Could be any of the event types defined above. + * @param message Message description. */ public DrmErrorEvent(int uniqueId, int type, String message) { super(uniqueId, type, message); } /** - * constructor to create DrmErrorEvent object with given parameters + * Creates a DrmErrorEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of the event. It could be one of the types defined above - * @param message Message description + * @param uniqueId Unique session identifier. + * @param type Type of the event. Could be any of the event types defined above. + * @param message Message description. * @param attributes Attributes for extensible information. Could be any - * information provided by the plugin + * information provided by the plug-in. */ public DrmErrorEvent(int uniqueId, int type, String message, HashMap attributes) { super(uniqueId, type, message, attributes); } } - diff --git a/drm/java/android/drm/DrmEvent.java b/drm/java/android/drm/DrmEvent.java old mode 100644 new mode 100755 index eba458bf5525b..4053eb39e7992 --- a/drm/java/android/drm/DrmEvent.java +++ b/drm/java/android/drm/DrmEvent.java @@ -19,22 +19,26 @@ package android.drm; import java.util.HashMap; /** - * This is the base class which would be used to notify the caller - * about any event occurred in DRM framework. + * A base class that is used to send asynchronous event information from the DRM framework. * */ public class DrmEvent { /** - * Constant field signifies that all the rights information associated with - * all DRM schemes are removed successfully + * All of the rights information associated with all DRM schemes have been successfully removed. */ public static final int TYPE_ALL_RIGHTS_REMOVED = 1001; /** - * Constant field signifies that given information is processed successfully + * The given DRM information has been successfully processed. */ public static final int TYPE_DRM_INFO_PROCESSED = 1002; - + /** + * The key that is used in the attributes HashMap to pass the return status. + */ public static final String DRM_INFO_STATUS_OBJECT = "drm_info_status_object"; + /** + * The key that is used in the attributes HashMap to pass the + * {@link DrmInfo} object. + */ public static final String DRM_INFO_OBJECT = "drm_info_object"; private final int mUniqueId; @@ -44,12 +48,12 @@ public class DrmEvent { private HashMap mAttributes = new HashMap(); /** - * constructor for DrmEvent class + * Creates a DrmEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of information - * @param message Message description - * @param attributes Attributes for extensible information + * @param uniqueId Unique session identifier. + * @param type Type of information. + * @param message Message description. + * @param attributes Attributes for extensible information. */ protected DrmEvent(int uniqueId, int type, String message, HashMap attributes) { @@ -66,11 +70,11 @@ public class DrmEvent { } /** - * constructor for DrmEvent class + * Creates a DrmEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of information - * @param message Message description + * @param uniqueId Unique session identifier. + * @param type Type of information. + * @param message Message description. */ protected DrmEvent(int uniqueId, int type, String message) { mUniqueId = uniqueId; @@ -82,40 +86,39 @@ public class DrmEvent { } /** - * Returns the Unique Id associated with this object + * Retrieves the unique session identifier associated with this object. * - * @return Unique Id + * @return The unique session identifier. */ public int getUniqueId() { return mUniqueId; } /** - * Returns the Type of information associated with this object + * Retrieves the type of information that is associated with this object. * - * @return Type of information + * @return The type of information. */ public int getType() { return mType; } /** - * Returns the message description associated with this object + * Retrieves the message description associated with this object. * - * @return message description + * @return The message description. */ public String getMessage() { return mMessage; } /** - * Returns the attribute corresponding to the specified key + * Retrieves the attribute associated with the specified key. * - * @return one of the attributes or null if no mapping for - * the key is found + * @return One of the attributes or null if no mapping for + * the key is found. */ public Object getAttribute(String key) { return mAttributes.get(key); } } - diff --git a/drm/java/android/drm/DrmInfo.java b/drm/java/android/drm/DrmInfo.java old mode 100644 new mode 100755 index 7d3fbf1fd8486..8812bfe5a11e6 --- a/drm/java/android/drm/DrmInfo.java +++ b/drm/java/android/drm/DrmInfo.java @@ -21,14 +21,13 @@ import java.util.HashMap; import java.util.Iterator; /** - * This is an entity class in which necessary information required to transact - * between device and online DRM server is described. DRM Framework achieves - * server registration, license acquisition and any other server related transaction - * by passing an instance of this class to {@link DrmManagerClient#processDrmInfo(DrmInfo)}. - * - * Caller can retrieve the {@link DrmInfo} instance by using - * {@link DrmManagerClient#acquireDrmInfo(DrmInfoRequest)} - * by passing {@link DrmInfoRequest} instance. + * An entity class that describes the information required to send transactions + * between a device and an online DRM server. The DRM framework achieves + * server registration, license acquisition, and any other server-related transactions + * by passing an instance of this class to {@link DrmManagerClient#processDrmInfo}. + *

+ * The caller can retrieve the {@link DrmInfo} instance by passing a {@link DrmInfoRequest} + * instance to {@link DrmManagerClient#acquireDrmInfo}. * */ public class DrmInfo { @@ -40,11 +39,11 @@ public class DrmInfo { private final HashMap mAttributes = new HashMap(); /** - * constructor to create DrmInfo object with given parameters + * Creates a DrmInfo object with the given parameters. * - * @param infoType Type of information - * @param data Trigger data - * @param mimeType MIME type + * @param infoType The type of information. + * @param data The trigger data. + * @param mimeType The MIME type. */ public DrmInfo(int infoType, byte[] data, String mimeType) { mInfoType = infoType; @@ -53,11 +52,11 @@ public class DrmInfo { } /** - * constructor to create DrmInfo object with given parameters + * Creates a DrmInfo object with the given parameters. * - * @param infoType Type of information - * @param path Trigger data - * @param mimeType MIME type + * @param infoType The type of information. + * @param path The trigger data. + * @param mimeType The MIME type. */ public DrmInfo(int infoType, String path, String mimeType) { mInfoType = infoType; @@ -73,67 +72,70 @@ public class DrmInfo { } /** - * Adds optional information as pair to this object + * Adds optional information as key-value pairs to this object. To add a custom object + * to the DrmInfo object, you must override the {@link #toString} implementation. + * + * @param key Key to add. + * @param value Value to add. * - * @param key Key to add - * @param value Value to add - * To put custom object into DrmInfo, custom object has to - * override toString() implementation. */ public void put(String key, Object value) { mAttributes.put(key, value); } /** - * Retrieves the value of given key, if not found returns null + * Retrieves the value of a given key. * - * @param key Key whose value to be retrieved - * @return The value or null + * @param key The key whose value is being retrieved. + * + * @return The value of the key being retrieved. Returns null if the key cannot be found. */ public Object get(String key) { return mAttributes.get(key); } /** - * Returns Iterator object to walk through the keys associated with this instance + * Retrieves an iterator object that you can use to iterate over the keys associated with + * this DrmInfo object. * - * @return Iterator object + * @return The iterator object. */ public Iterator keyIterator() { return mAttributes.keySet().iterator(); } /** - * Returns Iterator object to walk through the values associated with this instance + * Retrieves an iterator object that you can use to iterate over the values associated with + * this DrmInfo object. * - * @return Iterator object + * @return The iterator object. */ public Iterator iterator() { return mAttributes.values().iterator(); } /** - * Returns the trigger data associated with this object + * Retrieves the trigger data associated with this object. * - * @return Trigger data + * @return The trigger data. */ public byte[] getData() { return mData; } /** - * Returns the mimetype associated with this object + * Retrieves the MIME type associated with this object. * - * @return MIME type + * @return The MIME type. */ public String getMimeType() { return mMimeType; } /** - * Returns information type associated with this instance + * Retrieves the information type associated with this object. * - * @return Information type + * @return The information type. */ public int getInfoType() { return mInfoType; diff --git a/drm/java/android/drm/DrmInfoEvent.java b/drm/java/android/drm/DrmInfoEvent.java old mode 100644 new mode 100755 index 190199a4a42c3..67aa0a96b6367 --- a/drm/java/android/drm/DrmInfoEvent.java +++ b/drm/java/android/drm/DrmInfoEvent.java @@ -19,58 +19,56 @@ package android.drm; import java.util.HashMap; /** - * This is an entity class which would be passed to caller in - * {@link DrmManagerClient.OnInfoListener#onInfo(DrmManagerClient, DrmInfoEvent)} + * An entity class that is passed to the + * {@link DrmManagerClient.OnInfoListener#onInfo onInfo()} callback. * */ public class DrmInfoEvent extends DrmEvent { /** - * TYPE_ALREADY_REGISTERED_BY_ANOTHER_ACCOUNT, when registration has been already done - * by another account ID. + * The registration has already been done by another account ID. */ public static final int TYPE_ALREADY_REGISTERED_BY_ANOTHER_ACCOUNT = 1; /** - * TYPE_REMOVE_RIGHTS, when the rights needs to be removed completely. + * The rights need to be removed completely. */ public static final int TYPE_REMOVE_RIGHTS = 2; /** - * TYPE_RIGHTS_INSTALLED, when the rights are downloaded and installed ok. + * The rights have been successfully downloaded and installed. */ public static final int TYPE_RIGHTS_INSTALLED = 3; /** - * TYPE_WAIT_FOR_RIGHTS, rights object is on it's way to phone, - * wait before calling checkRights again. + * The rights object is being delivered to the device. You must wait before + * calling {@link DrmManagerClient#acquireRights acquireRights()} again. */ public static final int TYPE_WAIT_FOR_RIGHTS = 4; /** - * TYPE_ACCOUNT_ALREADY_REGISTERED, when registration has been - * already done for the given account. + * The registration has already been done for the given account. */ public static final int TYPE_ACCOUNT_ALREADY_REGISTERED = 5; /** - * TYPE_RIGHTS_REMOVED, when the rights has been removed. + * The rights have been removed. */ public static final int TYPE_RIGHTS_REMOVED = 6; /** - * constructor to create DrmInfoEvent object with given parameters + * Creates a DrmInfoEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of the event. It could be one of the types defined above - * @param message Message description + * @param uniqueId Unique session identifier. + * @param type Type of the event. Could be any of the event types defined above. + * @param message Message description. */ public DrmInfoEvent(int uniqueId, int type, String message) { super(uniqueId, type, message); } /** - * constructor to create DrmInfoEvent object with given parameters + * Creates a DrmInfoEvent object with the specified parameters. * - * @param uniqueId Unique session identifier - * @param type Type of the event. It could be one of the types defined above - * @param message Message description + * @param uniqueId Unique session identifier. + * @param type Type of the event. Could be any of the event types defined above. + * @param message Message description. * @param attributes Attributes for extensible information. Could be any - * information provided by the plugin + * information provided by the plug-in. */ public DrmInfoEvent(int uniqueId, int type, String message, HashMap attributes) { diff --git a/drm/java/android/drm/DrmInfoRequest.java b/drm/java/android/drm/DrmInfoRequest.java old mode 100644 new mode 100755 index a5a799c438c27..9f86f5f5a7c37 --- a/drm/java/android/drm/DrmInfoRequest.java +++ b/drm/java/android/drm/DrmInfoRequest.java @@ -20,30 +20,37 @@ import java.util.HashMap; import java.util.Iterator; /** - * This is an entity class used to pass required parameters to get - * the necessary information to communicate with online DRM server - * - * An instance of this class is passed to {@link DrmManagerClient#acquireDrmInfo(DrmInfoRequest)} - * to get the instance of {@link DrmInfo} + * An entity class that is used to pass information to an online DRM server. An instance of this + * class is passed to the {@link DrmManagerClient#acquireDrmInfo acquireDrmInfo()} method to get an + * instance of a {@link DrmInfo}. * */ public class DrmInfoRequest { // Changes in following constants should be in sync with DrmInfoRequest.cpp /** - * Constants defines the type of {@link DrmInfoRequest} + * Acquires DRM server registration information. */ public static final int TYPE_REGISTRATION_INFO = 1; + /** + * Acquires information for unregistering the DRM server. + */ public static final int TYPE_UNREGISTRATION_INFO = 2; + /** + * Acquires rights information. + */ public static final int TYPE_RIGHTS_ACQUISITION_INFO = 3; + /** + * Acquires the progress of the rights acquisition. + */ public static final int TYPE_RIGHTS_ACQUISITION_PROGRESS_INFO = 4; /** - * Key to pass the unique id for the account or the user + * Key that is used to pass the unique session ID for the account or the user. */ public static final String ACCOUNT_ID = "account_id"; /** - * Key to pass the unique id used for subscription + * Key that is used to pass the unique session ID for the subscription. */ public static final String SUBSCRIPTION_ID = "subscription_id"; @@ -52,10 +59,10 @@ public class DrmInfoRequest { private final HashMap mRequestInformation = new HashMap(); /** - * constructor to create DrmInfoRequest object with type and mimetype + * Creates a DrmInfoRequest object with type and MIME type. * - * @param infoType Type of information - * @param mimeType MIME type + * @param infoType Type of information. + * @param mimeType MIME type. */ public DrmInfoRequest(int infoType, String mimeType) { mInfoType = infoType; @@ -63,56 +70,60 @@ public class DrmInfoRequest { } /** - * Returns the mimetype associated with this object + * Retrieves the MIME type associated with this object. * - * @return MIME type + * @return The MIME type. */ public String getMimeType() { return mMimeType; } /** - * Returns Information type associated with this instance + * Retrieves the information type associated with this object. * - * @return Information type + * @return The information type. */ public int getInfoType() { return mInfoType; } /** - * Adds optional information as pair to this object. + * Adds optional information as key-value pairs to this object. * - * @param key Key to add - * @param value Value to add + * @param key The key to add. + * @param value The value to add. */ public void put(String key, Object value) { mRequestInformation.put(key, value); } /** - * Retrieves the value of given key, if not found returns null + * Retrieves the value of a given key. * - * @param key Key whose value to be retrieved - * @return The value or null + * @param key The key whose value is being retrieved. + * + * @return The value of the key that is being retrieved. Returns null if the key cannot be + * found. */ public Object get(String key) { return mRequestInformation.get(key); } /** - * Returns Iterator object to walk through the keys associated with this instance + * Retrieves an iterator object that you can use to iterate over the keys associated with + * this DrmInfoRequest object. * - * @return Iterator object + * @return The iterator object. */ public Iterator keyIterator() { return mRequestInformation.keySet().iterator(); } /** - * Returns Iterator object to walk through the values associated with this instance + * Retrieves an iterator object that you can use to iterate over the values associated with + * this DrmInfoRequest object. * - * @return Iterator object + * @return The iterator object. */ public Iterator iterator() { return mRequestInformation.values().iterator(); diff --git a/drm/java/android/drm/DrmInfoStatus.java b/drm/java/android/drm/DrmInfoStatus.java old mode 100644 new mode 100755 index b37ea5180ac8e..b04694bb79fbf --- a/drm/java/android/drm/DrmInfoStatus.java +++ b/drm/java/android/drm/DrmInfoStatus.java @@ -17,12 +17,12 @@ package android.drm; /** - * This is an entity class which wraps the result of communication between device - * and online DRM server. - * - * As a result of {@link DrmManagerClient#processDrmInfo(DrmInfo)} an instance of DrmInfoStatus - * would be returned. This class holds {@link ProcessedData}, which could be used to instantiate - * {@link DrmRights#DrmRights(ProcessedData, String)} in license acquisition. + * An entity class that wraps the result of communication between a device and an online DRM + * server. Specifically, when the {@link DrmManagerClient#processDrmInfo processDrmInfo()} method + * is called, an instance of DrmInfoStatus is returned. + *

+ * This class contains the {@link ProcessedData} object, which can be used to instantiate a + * {@link DrmRights} object during license acquisition. * */ public class DrmInfoStatus { @@ -30,18 +30,30 @@ public class DrmInfoStatus { public static final int STATUS_OK = 1; public static final int STATUS_ERROR = 2; + /** + * The status of the communication. + */ public final int statusCode; + /** + * The type of DRM information processed. + */ public final int infoType; + /** + * The MIME type of the content. + */ public final String mimeType; + /** + * The processed data. + */ public final ProcessedData data; /** - * constructor to create DrmInfoStatus object with given parameters + * Creates a DrmInfoStatus object with the specified parameters. * - * @param _statusCode Status of the communication - * @param _infoType Type of the DRM information processed - * @param _data The processed data - * @param _mimeType MIME type + * @param _statusCode The status of the communication. + * @param _infoType The type of the DRM information processed. + * @param _data The processed data. + * @param _mimeType The MIME type. */ public DrmInfoStatus(int _statusCode, int _infoType, ProcessedData _data, String _mimeType) { statusCode = _statusCode; diff --git a/drm/java/android/drm/DrmManagerClient.java b/drm/java/android/drm/DrmManagerClient.java old mode 100644 new mode 100755 index f7479b5c46fe7..f3a034307ad94 --- a/drm/java/android/drm/DrmManagerClient.java +++ b/drm/java/android/drm/DrmManagerClient.java @@ -35,18 +35,17 @@ import java.util.ArrayList; import java.util.HashMap; /** - * Interface of DRM Framework. - * Java application will instantiate this class - * to access DRM agent through DRM Framework. + * The main programming interface for the DRM framework. An application must instantiate this class + * to access DRM agents through the DRM framework. * */ public class DrmManagerClient { /** - * Constant field signifies the success or no error occurred + * Indicates that a request was successful or that no error occurred. */ public static final int ERROR_NONE = 0; /** - * Constant field signifies that error occurred and the reason is not known + * Indicates that an error occurred and the reason is not known. */ public static final int ERROR_UNKNOWN = -2000; @@ -58,43 +57,45 @@ public class DrmManagerClient { } /** - * Interface definition of a callback to be invoked to communicate - * some info and/or warning about DrmManagerClient. + * Interface definition for a callback that receives status messages and warnings + * during registration and rights acquisition. */ public interface OnInfoListener { /** - * Called to indicate an info or a warning. + * Called when the DRM framework sends status or warning information during registration + * and rights acquisition. * - * @param client DrmManagerClient instance - * @param event instance which wraps reason and necessary information + * @param client The DrmManagerClient instance. + * @param event The {@link DrmInfoEvent} instance that wraps the status information or + * warnings. */ public void onInfo(DrmManagerClient client, DrmInfoEvent event); } /** - * Interface definition of a callback to be invoked to communicate - * the result of time consuming APIs asynchronously + * Interface definition for a callback that receives information + * about DRM processing events. */ public interface OnEventListener { /** - * Called to indicate the result of asynchronous APIs. + * Called when the DRM framework sends information about a DRM processing request. * - * @param client DrmManagerClient instance - * @param event instance which wraps type and message + * @param client The DrmManagerClient instance. + * @param event The {@link DrmEvent} instance that wraps the information being + * conveyed, such as the information type and message. */ public void onEvent(DrmManagerClient client, DrmEvent event); } /** - * Interface definition of a callback to be invoked to communicate - * the error occurred + * Interface definition for a callback that receives information about DRM framework errors. */ public interface OnErrorListener { /** - * Called to indicate the error occurred. + * Called when the DRM framework sends error information. * - * @param client DrmManagerClient instance - * @param event instance which wraps error type and message + * @param client The DrmManagerClient instance. + * @param event The {@link DrmErrorEvent} instance that wraps the error type and message. */ public void onError(DrmManagerClient client, DrmErrorEvent event); } @@ -231,9 +232,9 @@ public class DrmManagerClient { } /** - * To instantiate DrmManagerClient + * Creates a DrmManagerClient. * - * @param context context of the caller + * @param context Context of the caller. */ public DrmManagerClient(Context context) { mContext = context; @@ -257,10 +258,10 @@ public class DrmManagerClient { } /** - * Register a callback to be invoked when the caller required to receive - * supplementary information. + * Registers an {@link DrmManagerClient.OnInfoListener} callback, which is invoked when the + * DRM framework sends status or warning information during registration or rights acquisition. * - * @param infoListener + * @param infoListener Interface definition for the callback. */ public synchronized void setOnInfoListener(OnInfoListener infoListener) { if (null != infoListener) { @@ -269,10 +270,10 @@ public class DrmManagerClient { } /** - * Register a callback to be invoked when the caller required to receive - * the result of asynchronous APIs. + * Registers an {@link DrmManagerClient.OnEventListener} callback, which is invoked when the + * DRM framework sends information about DRM processing. * - * @param eventListener + * @param eventListener Interface definition for the callback. */ public synchronized void setOnEventListener(OnEventListener eventListener) { if (null != eventListener) { @@ -281,10 +282,10 @@ public class DrmManagerClient { } /** - * Register a callback to be invoked when the caller required to receive - * error result of asynchronous APIs. + * Registers an {@link DrmManagerClient.OnErrorListener} callback, which is invoked when + * the DRM framework sends error information. * - * @param errorListener + * @param errorListener Interface definition for the callback. */ public synchronized void setOnErrorListener(OnErrorListener errorListener) { if (null != errorListener) { @@ -293,9 +294,10 @@ public class DrmManagerClient { } /** - * Retrieves informations about all the plug-ins registered with DrmFramework. + * Retrieves information about all the DRM plug-ins (agents) that are registered with + * the DRM framework. * - * @return Array of DrmEngine plug-in strings + * @return A String array of DRM plug-in descriptions. */ public String[] getAvailableDrmEngines() { DrmSupportInfo[] supportInfos = _getAllSupportInfo(mUniqueId); @@ -310,12 +312,13 @@ public class DrmManagerClient { } /** - * Get constraints information evaluated from DRM content + * Retrieves constraint information for rights-protected content. * - * @param path Content path from where DRM constraints would be retrieved. - * @param action Actions defined in {@link DrmStore.Action} - * @return ContentValues instance in which constraints key-value pairs are embedded - * or null in case of failure + * @param path Path to the content from which you are retrieving DRM constraints. + * @param action Action defined in {@link DrmStore.Action}. + * + * @return A {@link android.content.ContentValues} instance that contains + * key-value pairs representing the constraints. Null in case of failure. */ public ContentValues getConstraints(String path, int action) { if (null == path || path.equals("") || !DrmStore.Action.isValid(action)) { @@ -325,11 +328,12 @@ public class DrmManagerClient { } /** - * Get metadata information from DRM content + * Retrieves metadata information for rights-protected content. * - * @param path Content path from where DRM metadata would be retrieved. - * @return ContentValues instance in which metadata key-value pairs are embedded - * or null in case of failure + * @param path Path to the content from which you are retrieving metadata information. + * + * @return A {@link android.content.ContentValues} instance that contains + * key-value pairs representing the metadata. Null in case of failure. */ public ContentValues getMetadata(String path) { if (null == path || path.equals("")) { @@ -339,12 +343,13 @@ public class DrmManagerClient { } /** - * Get constraints information evaluated from DRM content + * Retrieves constraint information for rights-protected content. * - * @param uri Content URI from where DRM constraints would be retrieved. - * @param action Actions defined in {@link DrmStore.Action} - * @return ContentValues instance in which constraints key-value pairs are embedded - * or null in case of failure + * @param uri URI for the content from which you are retrieving DRM constraints. + * @param action Action defined in {@link DrmStore.Action}. + * + * @return A {@link android.content.ContentValues} instance that contains + * key-value pairs representing the constraints. Null in case of failure. */ public ContentValues getConstraints(Uri uri, int action) { if (null == uri || Uri.EMPTY == uri) { @@ -354,11 +359,12 @@ public class DrmManagerClient { } /** - * Get metadata information from DRM content + * Retrieves metadata information for rights-protected content. * - * @param uri Content URI from where DRM metadata would be retrieved. - * @return ContentValues instance in which metadata key-value pairs are embedded - * or null in case of failure + * @param uri URI for the content from which you are retrieving metadata information. + * + * @return A {@link android.content.ContentValues} instance that contains + * key-value pairs representing the constraints. Null in case of failure. */ public ContentValues getMetadata(Uri uri) { if (null == uri || Uri.EMPTY == uri) { @@ -368,18 +374,19 @@ public class DrmManagerClient { } /** - * Save DRM rights to specified rights path - * and make association with content path. + * Saves rights to a specified path and associates that path with the content path. + * + *

Note: For OMA or WM-DRM, rightsPath and + * contentPath can be null.

* - *

In case of OMA or WM-DRM, rightsPath and contentPath could be null.

+ * @param drmRights The {@link DrmRights} to be saved. + * @param rightsPath File path where rights will be saved. + * @param contentPath File path where content is saved. * - * @param drmRights DrmRights to be saved - * @param rightsPath File path where rights to be saved - * @param contentPath File path where content was saved - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure - * @throws IOException if failed to save rights information in the given path + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. + * + * @throws IOException If the call failed to save rights information at the given + * rightsPath. */ public int saveRights( DrmRights drmRights, String rightsPath, String contentPath) throws IOException { @@ -393,9 +400,10 @@ public class DrmManagerClient { } /** - * Install new DRM Engine Plug-in at the runtime + * Installs a new DRM plug-in (agent) at runtime. + * + * @param engineFilePath File path to the plug-in file to be installed. * - * @param engineFilePath Path of the plug-in file to be installed * {@hide} */ public void installDrmEngine(String engineFilePath) { @@ -407,13 +415,12 @@ public class DrmManagerClient { } /** - * Check whether the given mimetype or path can be handled. + * Checks whether the given MIME type or path can be handled. * - * @param path Path of the content to be handled - * @param mimeType Mimetype of the object to be handled - * @return - * true - if the given mimeType or path can be handled - * false - cannot be handled. + * @param path Path of the content to be handled. + * @param mimeType MIME type of the object to be handled. + * + * @return True if the given MIME type or path can be handled; false if they cannot be handled. */ public boolean canHandle(String path, String mimeType) { if ((null == path || path.equals("")) && (null == mimeType || mimeType.equals(""))) { @@ -423,13 +430,12 @@ public class DrmManagerClient { } /** - * Check whether the given mimetype or uri can be handled. + * Checks whether the given MIME type or URI can be handled. * - * @param uri Content URI of the data to be handled. - * @param mimeType Mimetype of the object to be handled - * @return - * true - if the given mimeType or path can be handled - * false - cannot be handled. + * @param uri URI for the content to be handled. + * @param mimeType MIME type of the object to be handled + * + * @return True if the given MIME type or URI can be handled; false if they cannot be handled. */ public boolean canHandle(Uri uri, String mimeType) { if ((null == uri || Uri.EMPTY == uri) && (null == mimeType || mimeType.equals(""))) { @@ -439,12 +445,10 @@ public class DrmManagerClient { } /** - * Executes given drm information based on its type + * Processes the given DRM information based on the information type. * - * @param drmInfo Information needs to be processed - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure + * @param drmInfo The {@link DrmInfo} to be processed. + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. */ public int processDrmInfo(DrmInfo drmInfo) { if (null == drmInfo || !drmInfo.isValid()) { @@ -459,10 +463,12 @@ public class DrmManagerClient { } /** - * Retrieves necessary information for register, unregister or rights acquisition. + * Retrieves information for registering, unregistering, or acquiring rights. * - * @param drmInfoRequest Request information to retrieve drmInfo - * @return DrmInfo Instance as a result of processing given input + * @param drmInfoRequest The {@link DrmInfoRequest} that specifies the type of DRM + * information being retrieved. + * + * @return A {@link DrmInfo} instance. */ public DrmInfo acquireDrmInfo(DrmInfoRequest drmInfoRequest) { if (null == drmInfoRequest || !drmInfoRequest.isValid()) { @@ -472,17 +478,18 @@ public class DrmManagerClient { } /** - * Executes given DrmInfoRequest and returns the rights information asynchronously. - * This is a utility API which consists of {@link #acquireDrmInfo(DrmInfoRequest)} - * and {@link #processDrmInfo(DrmInfo)}. - * It can be used if selected DRM agent can work with this combined sequences. - * In case of some DRM schemes, such as OMA DRM, application needs to invoke - * {@link #acquireDrmInfo(DrmInfoRequest)} and {@link #processDrmInfo(DrmInfo)}, separately. + * Processes a given {@link DrmInfoRequest} and returns the rights information asynchronously. + *

+ * This is a utility method that consists of an + * {@link #acquireDrmInfo(DrmInfoRequest) acquireDrmInfo()} and a + * {@link #processDrmInfo(DrmInfo) processDrmInfo()} method call. This utility method can be + * used only if the selected DRM plug-in (agent) supports this sequence of calls. Some DRM + * agents, such as OMA, do not support this utility method, in which case an application must + * invoke {@link #acquireDrmInfo(DrmInfoRequest) acquireDrmInfo()} and + * {@link #processDrmInfo(DrmInfo) processDrmInfo()} separately. * - * @param drmInfoRequest Request information to retrieve drmInfo - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure + * @param drmInfoRequest The {@link DrmInfoRequest} used to acquire the rights. + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. */ public int acquireRights(DrmInfoRequest drmInfoRequest) { DrmInfo drmInfo = acquireDrmInfo(drmInfoRequest); @@ -493,14 +500,14 @@ public class DrmManagerClient { } /** - * Retrieves the type of the protected object (content, rights, etc..) - * using specified path or mimetype. At least one parameter should be non null - * to retrieve DRM object type + * Retrieves the type of rights-protected object (for example, content object, rights + * object, and so on) using the specified path or MIME type. At least one parameter must + * be specified to retrieve the DRM object type. * - * @param path Path of the content or null. - * @param mimeType Mimetype of the content or null. - * @return Type of the DRM content. - * @see DrmStore.DrmObjectType + * @param path Path to the content or null. + * @param mimeType MIME type of the content or null. + * + * @return An int that corresponds to a {@link DrmStore.DrmObjectType}. */ public int getDrmObjectType(String path, String mimeType) { if ((null == path || path.equals("")) && (null == mimeType || mimeType.equals(""))) { @@ -510,14 +517,14 @@ public class DrmManagerClient { } /** - * Retrieves the type of the protected object (content, rights, etc..) - * using specified uri or mimetype. At least one parameter should be non null - * to retrieve DRM object type + * Retrieves the type of rights-protected object (for example, content object, rights + * object, and so on) using the specified URI or MIME type. At least one parameter must + * be specified to retrieve the DRM object type. * - * @param uri The content URI of the data - * @param mimeType Mimetype of the content or null. - * @return Type of the DRM content. - * @see DrmStore.DrmObjectType + * @param uri URI for the content or null. + * @param mimeType MIME type of the content or null. + * + * @return An int that corresponds to a {@link DrmStore.DrmObjectType}. */ public int getDrmObjectType(Uri uri, String mimeType) { if ((null == uri || Uri.EMPTY == uri) && (null == mimeType || mimeType.equals(""))) { @@ -534,10 +541,11 @@ public class DrmManagerClient { } /** - * Retrieves the mime type embedded inside the original content + * Retrieves the MIME type embedded in the original content. * - * @param path Path of the protected content - * @return Mimetype of the original content, such as "video/mpeg" + * @param path Path to the rights-protected content. + * + * @return The MIME type of the original content, such as video/mpeg. */ public String getOriginalMimeType(String path) { if (null == path || path.equals("")) { @@ -547,10 +555,11 @@ public class DrmManagerClient { } /** - * Retrieves the mime type embedded inside the original content + * Retrieves the MIME type embedded in the original content. * - * @param uri The content URI of the data - * @return Mimetype of the original content, such as "video/mpeg" + * @param uri URI of the rights-protected content. + * + * @return MIME type of the original content, such as video/mpeg. */ public String getOriginalMimeType(Uri uri) { if (null == uri || Uri.EMPTY == uri) { @@ -560,22 +569,22 @@ public class DrmManagerClient { } /** - * Check whether the given content has valid rights or not + * Checks whether the given content has valid rights. * - * @param path Path of the protected content - * @return Status of the rights for the protected content - * @see DrmStore.RightsStatus + * @param path Path to the rights-protected content. + * + * @return An int representing the {@link DrmStore.RightsStatus} of the content. */ public int checkRightsStatus(String path) { return checkRightsStatus(path, DrmStore.Action.DEFAULT); } /** - * Check whether the given content has valid rights or not + * Check whether the given content has valid rights. * - * @param uri The content URI of the data - * @return Status of the rights for the protected content - * @see DrmStore.RightsStatus + * @param uri URI of the rights-protected content. + * + * @return An int representing the {@link DrmStore.RightsStatus} of the content. */ public int checkRightsStatus(Uri uri) { if (null == uri || Uri.EMPTY == uri) { @@ -585,12 +594,13 @@ public class DrmManagerClient { } /** - * Check whether the given content has valid rights or not for specified action. + * Checks whether the given rights-protected content has valid rights for the specified + * {@link DrmStore.Action}. * - * @param path Path of the protected content - * @param action Action to perform - * @return Status of the rights for the protected content - * @see DrmStore.RightsStatus + * @param path Path to the rights-protected content. + * @param action The {@link DrmStore.Action} to perform. + * + * @return An int representing the {@link DrmStore.RightsStatus} of the content. */ public int checkRightsStatus(String path, int action) { if (null == path || path.equals("") || !DrmStore.Action.isValid(action)) { @@ -600,12 +610,13 @@ public class DrmManagerClient { } /** - * Check whether the given content has valid rights or not for specified action. + * Checks whether the given rights-protected content has valid rights for the specified + * {@link DrmStore.Action}. * - * @param uri The content URI of the data - * @param action Action to perform - * @return Status of the rights for the protected content - * @see DrmStore.RightsStatus + * @param uri URI for the rights-protected content. + * @param action The {@link DrmStore.Action} to perform. + * + * @return An int representing the {@link DrmStore.RightsStatus} of the content. */ public int checkRightsStatus(Uri uri, int action) { if (null == uri || Uri.EMPTY == uri) { @@ -615,12 +626,11 @@ public class DrmManagerClient { } /** - * Removes the rights associated with the given protected content + * Removes the rights associated with the given rights-protected content. * - * @param path Path of the protected content - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure + * @param path Path to the rights-protected content. + * + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. */ public int removeRights(String path) { if (null == path || path.equals("")) { @@ -630,12 +640,11 @@ public class DrmManagerClient { } /** - * Removes the rights associated with the given protected content + * Removes the rights associated with the given rights-protected content. * - * @param uri The content URI of the data - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure + * @param uri URI for the rights-protected content. + * + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. */ public int removeRights(Uri uri) { if (null == uri || Uri.EMPTY == uri) { @@ -645,12 +654,10 @@ public class DrmManagerClient { } /** - * Removes all the rights information of every plug-in associated with - * DRM framework. Will be used in master reset + * Removes all the rights information of every DRM plug-in (agent) associated with + * the DRM framework. Will be used during a master reset. * - * @return - * ERROR_NONE for success - * ERROR_UNKNOWN for failure + * @return ERROR_NONE for success; ERROR_UNKNOWN for failure. */ public int removeAllRights() { int result = ERROR_UNKNOWN; @@ -662,13 +669,14 @@ public class DrmManagerClient { } /** - * This API is for Forward Lock based DRM scheme. - * Each time the application tries to download a new DRM file - * which needs to be converted, then the application has to - * begin with calling this API. + * Initiates a new conversion session. An application must initiate a conversion session + * with this method each time it downloads a rights-protected file that needs to be converted. + *

+ * This method applies only to forward-locking (copy protection) DRM schemes. * - * @param mimeType Description/MIME type of the input data packet - * @return convert ID which will be used for maintaining convert session. + * @param mimeType MIME type of the input data packet. + * + * @return A convert ID that is used used to maintain the conversion session. */ public int openConvertSession(String mimeType) { if (null == mimeType || mimeType.equals("")) { @@ -678,16 +686,17 @@ public class DrmManagerClient { } /** - * Accepts and converts the input data which is part of DRM file. - * The resultant converted data and the status is returned in the DrmConvertedInfo - * object. This method will be called each time there are new block - * of data received by the application. + * Converts the input data (content) that is part of a rights-protected file. The converted + * data and status is returned in a {@link DrmConvertedStatus} object. This method should be + * called each time there is a new block of data received by the application. * - * @param convertId Handle for the convert session - * @param inputData Input Data which need to be converted - * @return Return object contains the status of the data conversion, - * the output converted data and offset. In this case the - * application will ignore the offset information. + * @param convertId Handle for the conversion session. + * @param inputData Input data that needs to be converted. + * + * @return A {@link DrmConvertedStatus} object that contains the status of the data conversion, + * the converted data, and offset for the header and body signature. An application can + * ignore the offset because it is only relevant to the + * {@link #closeConvertSession closeConvertSession()} method. */ public DrmConvertedStatus convertData(int convertId, byte[] inputData) { if (null == inputData || 0 >= inputData.length) { @@ -697,16 +706,15 @@ public class DrmManagerClient { } /** - * Informs the Drm Agent when there is no more data which need to be converted - * or when an error occurs. Upon successful conversion of the complete data, - * the agent will inform that where the header and body signature - * should be added. This signature appending is needed to integrity - * protect the converted file. + * Informs the DRM plug-in (agent) that there is no more data to convert or that an error + * has occurred. Upon successful conversion of the data, the DRM agent will provide an offset + * value indicating where the header and body signature should be added. Appending the + * signature is necessary to protect the integrity of the converted file. * - * @param convertId Handle for the convert session - * @return Return object contains the status of the data conversion, - * the header and body signature data. It also informs - * the application on which offset these signature data should be appended. + * @param convertId Handle for the conversion session. + * + * @return A {@link DrmConvertedStatus} object that contains the status of the data conversion, + * the converted data, and the offset for the header and body signature. */ public DrmConvertedStatus closeConvertSession(int convertId) { return _closeConvertSession(mUniqueId, convertId); diff --git a/drm/java/android/drm/DrmRights.java b/drm/java/android/drm/DrmRights.java old mode 100644 new mode 100755 index 103af0742f95a..59079562b07d1 --- a/drm/java/android/drm/DrmRights.java +++ b/drm/java/android/drm/DrmRights.java @@ -20,14 +20,16 @@ import java.io.File; import java.io.IOException; /** - * This is an entity class which wraps the license information which was - * retrieved from the online DRM server. - * - * Caller can instantiate {@link DrmRights} by - * invoking {@link DrmRights#DrmRights(ProcessedData, String)} - * constructor by using the result of {@link DrmManagerClient#processDrmInfo(DrmInfo)} interface. - * Caller can also instantiate {@link DrmRights} using the file path - * which contains rights information. + * An entity class that wraps the license information retrieved from the online DRM server. + *

+ * A caller can instantiate a {@link DrmRights} object by first invoking the + * {@link DrmManagerClient#processDrmInfo(DrmInfo)} method and then using the resulting + * {@link ProcessedData} object to invoke the {@link DrmRights#DrmRights(ProcessedData, String)} + * constructor. + *

+ * A caller can also instantiate a {@link DrmRights} object by using the + * {@link DrmRights#DrmRights(String, String)} constructor, which takes a path to a file + * containing rights information instead of a ProcessedData. * */ public class DrmRights { @@ -37,10 +39,10 @@ public class DrmRights { private String mSubscriptionId = ""; /** - * constructor to create DrmRights object with given parameters + * Creates a DrmRights object with the given parameters. * - * @param rightsFilePath Path of the file containing rights data - * @param mimeType MIME type + * @param rightsFilePath Path to the file containing rights information. + * @param mimeType MIME type. */ public DrmRights(String rightsFilePath, String mimeType) { File file = new File(rightsFilePath); @@ -48,11 +50,11 @@ public class DrmRights { } /** - * constructor to create DrmRights object with given parameters + * Creates a DrmRights object with the given parameters. * - * @param rightsFilePath Path of the file containing rights data - * @param mimeType MIME type - * @param accountId Account Id of the user + * @param rightsFilePath Path to the file containing rights information. + * @param mimeType MIME type. + * @param accountId Account ID of the user. */ public DrmRights(String rightsFilePath, String mimeType, String accountId) { this(rightsFilePath, mimeType); @@ -63,12 +65,12 @@ public class DrmRights { } /** - * constructor to create DrmRights object with given parameters + * Creates a DrmRights object with the given parameters. * - * @param rightsFilePath Path of the file containing rights data - * @param mimeType MIME type - * @param accountId Account Id of the user - * @param subscriptionId Subscription Id of the user + * @param rightsFilePath Path to the file containing rights information. + * @param mimeType MIME type. + * @param accountId Account ID of the user. + * @param subscriptionId Subscription ID of the user. */ public DrmRights( String rightsFilePath, String mimeType, String accountId, String subscriptionId) { @@ -84,10 +86,10 @@ public class DrmRights { } /** - * constructor to create DrmRights object with given parameters + * Creates a DrmRights object with the given parameters. * - * @param rightsFile File containing rights data - * @param mimeType MIME type + * @param rightsFile File containing rights information. + * @param mimeType MIME type. */ public DrmRights(File rightsFile, String mimeType) { instantiate(rightsFile, mimeType); @@ -104,16 +106,20 @@ public class DrmRights { } /** - * constructor to create DrmRights object with given parameters - * The user can pass String or binary data

- * Usage:

- * i) String(e.g. data is instance of String):
- * - new DrmRights(data.getBytes(), mimeType)

- * ii) Binary data
- * - new DrmRights(binaryData[], mimeType)
+ * Creates a DrmRights object with the given parameters. + *

+ * The application can pass the processed data as a String or as binary data. + *

+ * The following code snippet shows how to pass the processed data as a String: + *

+ * new DrmRights(data.getBytes(), mimeType) + *

+ * The following code snippet shows how to pass the processed data as binary data: + *

+ * new DrmRights(binaryData[], mimeType) * - * @param data Processed data - * @param mimeType MIME type + * @param data A {@link ProcessedData} object. + * @param mimeType The MIME type. */ public DrmRights(ProcessedData data, String mimeType) { mData = data.getData(); @@ -132,47 +138,45 @@ public class DrmRights { } /** - * Returns the rights data associated with this object + * Retrieves the rights data associated with this DrmRights object. * - * @return Rights data + * @return A byte array representing the rights data. */ public byte[] getData() { return mData; } /** - * Returns the mimetype associated with this object + * Retrieves the MIME type associated with this DrmRights object. * - * @return MIME type + * @return The MIME type. */ public String getMimeType() { return mMimeType; } /** - * Returns the account-id associated with this object + * Retrieves the account ID associated with this DrmRights object. * - * @return Account Id + * @return The account ID. */ public String getAccountId() { return mAccountId; } /** - * Returns the subscription-id associated with this object + * Retrieves the subscription ID associated with this DrmRights object. * - * @return Subscription Id + * @return The subscription ID. */ public String getSubscriptionId() { return mSubscriptionId; } /** - * Returns whether this instance is valid or not + * Determines whether this instance is valid or not. * - * @return - * true if valid - * false if invalid + * @return True if valid; false if invalid. */ /*package*/ boolean isValid() { return (null != mMimeType && !mMimeType.equals("") diff --git a/drm/java/android/drm/DrmStore.java b/drm/java/android/drm/DrmStore.java old mode 100644 new mode 100755 index 44df90c6687ce..ae311de738615 --- a/drm/java/android/drm/DrmStore.java +++ b/drm/java/android/drm/DrmStore.java @@ -17,91 +17,97 @@ package android.drm; /** - * This class defines all the constants used by DRM framework + * Defines constants that are used by the DRM framework. * */ public class DrmStore { /** - * Columns representing drm constraints + * Interface definition for the columns that represent DRM constraints. */ public interface ConstraintsColumns { /** - * The max repeat count - *

Type: INTEGER

+ * The maximum repeat count. + *

+ * Type: INTEGER */ public static final String MAX_REPEAT_COUNT = "max_repeat_count"; /** - * The remaining repeat count - *

Type: INTEGER

+ * The remaining repeat count. + *

+ * Type: INTEGER */ public static final String REMAINING_REPEAT_COUNT = "remaining_repeat_count"; /** - * The time before which the protected file can not be played/viewed - *

Type: TEXT

+ * The time before which the rights-protected file cannot be played/viewed. + *

+ * Type: TEXT */ public static final String LICENSE_START_TIME = "license_start_time"; /** - * The time after which the protected file can not be played/viewed - *

Type: TEXT

+ * The time after which the rights-protected file cannot be played/viewed. + *

+ * Type: TEXT */ public static final String LICENSE_EXPIRY_TIME = "license_expiry_time"; /** - * The available time for license - *

Type: TEXT

+ * The available time left before the license expires. + *

+ * Type: TEXT */ public static final String LICENSE_AVAILABLE_TIME = "license_available_time"; /** - * The data stream for extended metadata - *

Type: TEXT

+ * The data stream for extended metadata. + *

+ * Type: TEXT */ public static final String EXTENDED_METADATA = "extended_metadata"; } /** - * Defines constants related to DRM types + * Defines DRM object types. */ public static class DrmObjectType { /** - * Field specifies the unknown type + * An unknown object type. */ public static final int UNKNOWN = 0x00; /** - * Field specifies the protected content type + * A rights-protected file object type. */ public static final int CONTENT = 0x01; /** - * Field specifies the rights information + * A rights information object type. */ public static final int RIGHTS_OBJECT = 0x02; /** - * Field specifies the trigger information + * A trigger information object type. */ public static final int TRIGGER_OBJECT = 0x03; } /** - * Defines constants related to playback + * Defines playback states for content. */ public static class Playback { /** - * Constant field signifies playback start + * Playback started. */ public static final int START = 0x00; /** - * Constant field signifies playback stop + * Playback stopped. */ public static final int STOP = 0x01; /** - * Constant field signifies playback paused + * Playback paused. */ public static final int PAUSE = 0x02; /** - * Constant field signifies playback resumed + * Playback resumed. */ public static final int RESUME = 0x03; @@ -120,39 +126,39 @@ public class DrmStore { } /** - * Defines actions that can be performed on protected content + * Defines actions that can be performed on rights-protected content. */ public static class Action { /** - * Constant field signifies that the default action + * The default action. */ public static final int DEFAULT = 0x00; /** - * Constant field signifies that the content can be played + * The rights-protected content can be played. */ public static final int PLAY = 0x01; /** - * Constant field signifies that the content can be set as ring tone + * The rights-protected content can be set as a ringtone. */ public static final int RINGTONE = 0x02; /** - * Constant field signifies that the content can be transfered + * The rights-protected content can be transferred. */ public static final int TRANSFER = 0x03; /** - * Constant field signifies that the content can be set as output + * The rights-protected content can be set as output. */ public static final int OUTPUT = 0x04; /** - * Constant field signifies that preview is allowed + * The rights-protected content can be previewed. */ public static final int PREVIEW = 0x05; /** - * Constant field signifies that the content can be executed + * The rights-protected content can be executed. */ public static final int EXECUTE = 0x06; /** - * Constant field signifies that the content can displayed + * The rights-protected content can be displayed. */ public static final int DISPLAY = 0x07; @@ -175,23 +181,23 @@ public class DrmStore { } /** - * Defines constants related to status of the rights + * Defines status notifications for digital rights. */ public static class RightsStatus { /** - * Constant field signifies that the rights are valid + * The digital rights are valid. */ public static final int RIGHTS_VALID = 0x00; /** - * Constant field signifies that the rights are invalid + * The digital rights are invalid. */ public static final int RIGHTS_INVALID = 0x01; /** - * Constant field signifies that the rights are expired for the content + * The digital rights have expired. */ public static final int RIGHTS_EXPIRED = 0x02; /** - * Constant field signifies that the rights are not acquired for the content + * The digital rights have not been acquired for the rights-protected content. */ public static final int RIGHTS_NOT_ACQUIRED = 0x03; } diff --git a/drm/java/android/drm/DrmSupportInfo.java b/drm/java/android/drm/DrmSupportInfo.java old mode 100644 new mode 100755 index 0886af8e8da03..720c545282a96 --- a/drm/java/android/drm/DrmSupportInfo.java +++ b/drm/java/android/drm/DrmSupportInfo.java @@ -20,11 +20,11 @@ import java.util.ArrayList; import java.util.Iterator; /** - * This is an entity class which wraps the capability of each plug-in, - * such as mimetype's and file suffixes it could handle. - * - * Plug-in developer could return the capability of the plugin by passing - * {@link DrmSupportInfo} instance. + * An entity class that wraps the capability of each DRM plug-in (agent), + * such as the MIME type and file suffix the DRM plug-in can handle. + *

+ * Plug-in developers can expose the capability of their plug-in by passing an instance of this + * class to an application. * */ public class DrmSupportInfo { @@ -33,47 +33,47 @@ public class DrmSupportInfo { private String mDescription = ""; /** - * Add the mime-type to the support info such that respective plug-in is - * capable of handling the given mime-type. + * Adds the specified MIME type to the list of MIME types this DRM plug-in supports. * - * @param mimeType MIME type + * @param mimeType MIME type that can be handles by this DRM plug-in. */ public void addMimeType(String mimeType) { mMimeTypeList.add(mimeType); } /** - * Add the file suffix to the support info such that respective plug-in is - * capable of handling the given file suffix. + * Adds the specified file suffix to the list of file suffixes this DRM plug-in supports. * - * @param fileSuffix File suffix which can be handled + * @param fileSuffix File suffix that can be handled by this DRM plug-in. */ public void addFileSuffix(String fileSuffix) { mFileSuffixList.add(fileSuffix); } /** - * Returns the iterator to walk to through mime types of this object + * Retrieves an iterator object that you can use to iterate over the MIME types that + * this DRM plug-in supports. * - * @return Iterator object + * @return The iterator object */ public Iterator getMimeTypeIterator() { return mMimeTypeList.iterator(); } /** - * Returns the iterator to walk to through file suffixes of this object + * Retrieves an iterator object that you can use to iterate over the file suffixes that + * this DRM plug-in supports. * - * @return Iterator object + * @return The iterator object. */ public Iterator getFileSuffixIterator() { return mFileSuffixList.iterator(); } /** - * Set the unique description about the plugin + * Sets a description for the DRM plug-in (agent). * - * @param description Unique description + * @param description Unique description of plug-in. */ public void setDescription(String description) { if (null != description) { @@ -82,30 +82,28 @@ public class DrmSupportInfo { } /** - * Returns the unique description associated with the plugin + * Retrieves the DRM plug-in (agent) description. * - * @return Unique description + * @return The plug-in description. */ public String getDescriprition() { return mDescription; } /** - * Overridden hash code implementation + * Overridden hash code implementation. * - * @return Hash code value + * @return The hash code value. */ public int hashCode() { return mFileSuffixList.hashCode() + mMimeTypeList.hashCode() + mDescription.hashCode(); } /** - * Overridden equals implementation + * Overridden equals implementation. * - * @param object The object to be compared - * @return - * true if equal - * false if not equal + * @param object The object to be compared. + * @return True if equal; false if not equal. */ public boolean equals(Object object) { boolean result = false; @@ -119,12 +117,10 @@ public class DrmSupportInfo { } /** - * Returns whether given mime-type is supported or not + * Determines whether a given MIME type is supported. * - * @param mimeType MIME type - * @return - * true if mime type is supported - * false if mime type is not supported + * @param mimeType MIME type. + * @return True if Mime type is supported; false if MIME type is not supported. */ /* package */ boolean isSupportedMimeType(String mimeType) { if (null != mimeType && !mimeType.equals("")) { @@ -139,12 +135,10 @@ public class DrmSupportInfo { } /** - * Returns whether given file suffix is supported or not + * Determines whether a given file suffix is supported. * - * @param fileSuffix File suffix - * @return - * true - if file suffix is supported - * false - if file suffix is not supported + * @param fileSuffix File suffix. + * @return True if file suffix is supported; false if file suffix is not supported. */ /* package */ boolean isSupportedFileSuffix(String fileSuffix) { return mFileSuffixList.contains(fileSuffix); diff --git a/drm/java/android/drm/DrmUtils.java b/drm/java/android/drm/DrmUtils.java old mode 100644 new mode 100755 index 8903485aeead3..dc5f1fa3d087f --- a/drm/java/android/drm/DrmUtils.java +++ b/drm/java/android/drm/DrmUtils.java @@ -28,9 +28,11 @@ import java.util.HashMap; import java.util.Iterator; /** - * The utility class used in the DRM Framework. This inclueds APIs for file operations - * and ExtendedMetadataParser for parsing extended metadata BLOB in DRM constraints. - * + * A utility class that provides operations for parsing extended metadata embedded in + * DRM constraint information. If a DRM scheme has specific constraints beyond the standard + * constraints, the constraints will show up in the + * {@link DrmStore.ConstraintsColumns#EXTENDED_METADATA} key. You can use + * {@link DrmUtils.ExtendedMetadataParser} to iterate over those values. */ public class DrmUtils { /* Should be used when we need to read from local file */ @@ -99,13 +101,10 @@ public class DrmUtils { } /** - * Get an instance of ExtendedMetadataParser to be used for parsing - * extended metadata BLOB in DRM constraints.
+ * Gets an instance of {@link DrmUtils.ExtendedMetadataParser}, which can be used to parse + * extended metadata embedded in DRM constraint information. * - * extendedMetadata BLOB is retrieved by specifing - * key DrmStore.ConstraintsColumns.EXTENDED_METADATA. - * - * @param extendedMetadata BLOB in which key-value pairs of extended metadata are embedded. + * @param extendedMetadata Object in which key-value pairs of extended metadata are embedded. * */ public static ExtendedMetadataParser getExtendedMetadataParser(byte[] extendedMetadata) { @@ -113,9 +112,10 @@ public class DrmUtils { } /** - * Utility parser to parse the extended meta-data embedded inside DRM constraints

- * - * Usage example
+ * Utility that parses extended metadata embedded in DRM constraint information. + *

+ * Usage example: + *

* byte[] extendedMetadata
*      = * constraints.getAsByteArray(DrmStore.ConstraintsColumns.EXTENDED_METADATA);
diff --git a/drm/java/android/drm/ProcessedData.java b/drm/java/android/drm/ProcessedData.java old mode 100644 new mode 100755 index 579264f00ba2f..06e03e73be91e --- a/drm/java/android/drm/ProcessedData.java +++ b/drm/java/android/drm/ProcessedData.java @@ -17,11 +17,11 @@ package android.drm; /** - * This is an entity class which wraps the result of transaction between - * device and online DRM server by using {@link DrmManagerClient#processDrmInfo(DrmInfo)} + * An entity class that wraps the result of a + * {@link DrmManagerClient#processDrmInfo(DrmInfo) processDrmInfo()} + * transaction between a device and a DRM server. * - * In license acquisition scenario this class would hold the binary data - * of rights information. + * In a license acquisition scenario this class holds the rights information in binary form. * */ public class ProcessedData { @@ -30,10 +30,10 @@ public class ProcessedData { private String mSubscriptionId = ""; /** - * constructor to create ProcessedData object with given parameters + * Creates a ProcessedData object with the given parameters. * - * @param data Rights data - * @param accountId Account Id of the user + * @param data Rights data. + * @param accountId Account ID of the user. */ /* package */ ProcessedData(byte[] data, String accountId) { mData = data; @@ -41,11 +41,11 @@ public class ProcessedData { } /** - * constructor to create ProcessedData object with given parameters + * Creates a ProcessedData object with the given parameters. * - * @param data Rights data - * @param accountId Account Id of the user - * @param subscriptionId Subscription Id of the user + * @param data Rights data. + * @param accountId Account ID of the user. + * @param subscriptionId Subscription ID of the user. */ /* package */ ProcessedData(byte[] data, String accountId, String subscriptionId) { mData = data; @@ -54,27 +54,27 @@ public class ProcessedData { } /** - * Returns the processed data as a result. + * Retrieves the processed data. * - * @return Rights data associated + * @return The rights data. */ public byte[] getData() { return mData; } /** - * Returns the account-id associated with this object + * Retrieves the account ID associated with this object. * - * @return Account Id associated + * @return The account ID of the user. */ public String getAccountId() { return mAccountId; } /** - * Returns the subscription-id associated with this object + * Returns the subscription ID associated with this object. * - * @return Subscription Id associated + * @return The subscription ID of the user. */ public String getSubscriptionId() { return mSubscriptionId; diff --git a/drm/java/android/drm/package.html b/drm/java/android/drm/package.html new file mode 100755 index 0000000000000..161d6e0bd1bf0 --- /dev/null +++ b/drm/java/android/drm/package.html @@ -0,0 +1,85 @@ + + +

Provides classes for managing DRM content and determining the capabilities of DRM plugins +(agents). Common uses of the DRM API include:

+
    +
  • Determining which DRM plug-ins (agents) are installed on a device.
    • +
  • Retrieving information about specific plug-ins, such as the MIME types and file suffixes + they support.
    • +
  • Registering a user or a device with an online DRM service.
    • +
  • Retrieving license constraints for rights-protected content.
    • +
  • Checking whether a user has the proper rights to play or use rights-protected + content.
    • +
  • Associating rights-protected content with its license so you can use the + {@link android.media.MediaPlayer} API to play the content.
    • +
+ +

DRM Overview

+ +

The Android platform provides an extensible DRM framework that lets applications manage +rights-protected content according to the license constraints that are associated with the +content. The DRM framework supports many DRM schemes; which DRM schemes a device supports +is up to the device manufacturer.

+ +

The Android DRM framework is implemented in two architectural layers (see figure below):

+
    +
  • A DRM framework API, which is exposed to applications through the Android +application framework and runs through the Dalvik VM for standard applications.
    • +
  • A native code DRM manager, which implements the DRM framework and exposes an +interface for DRM plug-ins (agents) to handle rights management and decryption for various +DRM schemes.
    • +
+ +DRM architecture diagram + +

For application developers, the DRM framework offers an abstract, unified API that +simplifies the management of rights-protected content. The API hides the complexity of DRM +operations and allows a consistent operation mode for both rights-protected and unprotected content +across a variety of DRM schemes. For device manufacturers, content owners, and Internet digital +media providers the DRM framework’s plugin architecture provides a means of adding support for a +specific DRM scheme to the Android system.

+ +

Using the DRM API

+ +

In a typical DRM session, an Android application uses the DRM framework API to +instantiate a {@link android.drm.DrmManagerClient}. The application calls various methods +on the DRM client to query rights and perform other DRM-related tasks. Each +{@link android.drm.DrmManagerClient} instance has its own unique ID, so the DRM manager is able to +differentiate callers.

+ +

Although each DRM plug-in may require a different sequence +of API calls, the general call sequence for an application is as follows:

+ +
    +
  • Register the device with an online DRM service. +

    You can do this by first using the {@link android.drm.DrmManagerClient#acquireDrmInfo +acquireDrmInfo()} method to acquire the registration information, and then using the {@link +android.drm.DrmManagerClient#processDrmInfo processDrmInfo()} method to process the +registration information.

    +
    • +
  • Acquire the license that's associated with the rights-protected content. +

    You can do this by first using the {@link android.drm.DrmManagerClient#acquireDrmInfo +acquireDrmInfo()} method to acquire the license information, and then using the {@link +android.drm.DrmManagerClient#processDrmInfo processDrmInfo()} method to process the +license information. You can also use the {@link +android.drm.DrmManagerClient#acquireRights acquireRights()} method.

    +
    • +
  • Extract constraint information from the license. +

    You can use the {@link android.drm.DrmManagerClient#getConstraints getConstraints()} + method to do this.

    +
    • +
  • Associate the rights-protected content with its license. +

    You can use the {@link android.drm.DrmManagerClient#saveRights saveRights()} method + to do this.

    +
    • +
+ +

After you make an association between the rights-protected content and its license, +the DRM manager automatically handles rights management for that content. Specifically, the +DRM manager will handle all further licensing checks when you attempt to play the content using +the {@link android.media.MediaPlayer} API.

+ +

To learn how to use the DRM API with a specific DRM plug-in, see the documentation provided +by the plug-in developer.

+ +