diff --git a/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_common.h b/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_common.h index 8c4181d3538003e4b7e7aae4d4b2f21ecd797f1f..54b75da7d06d8e4abd2cb9fa319cabd74f520143 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_common.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_common.h @@ -84,23 +84,23 @@ typedef enum DRM_EventType { */ typedef enum DRM_ContentProtectionLevel { /** - * 未知级别 + * 未知级别。 */ CONTENT_PROTECTION_LEVEL_UNKNOWN = 0, /** - * 软件安全级别 + * 软件安全级别。 */ CONTENT_PROTECTION_LEVEL_SW_CRYPTO, /** - * 硬件安全级别 + * 硬件安全级别。 */ CONTENT_PROTECTION_LEVEL_HW_CRYPTO, /** - * 硬件增强级别 + * 硬件增强级别。 */ CONTENT_PROTECTION_LEVEL_ENHANCED_HW_CRYPTO, /** - * 最大安全级别 + * 最大安全级别。 */ CONTENT_PROTECTION_LEVEL_MAX, } DRM_ContentProtectionLevel; @@ -113,11 +113,11 @@ typedef enum DRM_ContentProtectionLevel { */ typedef enum DRM_MediaKeyType { /** - * 离线 + * 离线。 */ MEDIA_KEY_TYPE_OFFLINE = 0, /** - * 在线 + * 在线。 */ MEDIA_KEY_TYPE_ONLINE, } DRM_MediaKeyType; @@ -487,21 +487,22 @@ typedef struct DRM_MediaKeySystemInfo { } DRM_MediaKeySystemInfo; /** -* @brief 从媒体源获取媒体密钥系统信息的回调。 +* @brief 应用为从媒体源获取DRM信息而设置的回调。 +* @param mediaKeySystemInfo 从媒体源获取的DRM信息。 * @since 11 * @version 1.0 */ typedef void (*DRM_MediaKeySystemInfoCallback)(DRM_MediaKeySystemInfo *mediaKeySystemInfo); /** - * @brief 媒体键系统结构。 + * @brief 媒体密钥系统结构。 * @since 11 * @version 1.0 */ typedef struct MediaKeySystem MediaKeySystem; /** - * @brief 媒体键会话结构。 + * @brief 媒体密钥会话结构。 * @since 11 * @version 1.0 */ @@ -538,22 +539,6 @@ typedef struct DRM_MediaKeySystemDescription { uint8_t uuid[DRM_UUID_LEN]; } DRM_MediaKeySystemDescription; -typedef void (*DRM_MediaKeySystemInfoCallback)(DRM_MediaKeySystemInfo *mediaKeySystemInfo); - -/** - * @brief 媒体密钥系统结构。 - * @since 11 - * @version 1.0 - */ -typedef struct MediaKeySystem MediaKeySystem; - -/** - * @brief 媒体密钥会话结构。 - * @since 11 - * @version 1.0 - */ -typedef struct MediaKeySession MediaKeySession; - #ifdef __cplusplus } #endif diff --git a/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_err.h b/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_err.h index ae5528182cb80e0d794b3a25b0d4fa2d3ffc0b34..5fc7c723653f3b160e116b1324b45a24ad551921 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_err.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/common/native_drm_err.h @@ -26,7 +26,7 @@ /** * @file native_drm_err.h * @include - * @brief 定义DRM错误码 + * @brief 定义DRM错误码。 * @library libnative_drm.z.so * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 @@ -71,7 +71,7 @@ typedef enum Drm_ErrCode { */ DRM_ERR_INVALID_VAL = DRM_CAPI_ERR_BASE + 3, /** - * IO 错误。 + * IO错误。 */ DRM_ERR_IO = DRM_CAPI_ERR_BASE + 4, /** @@ -83,7 +83,7 @@ typedef enum Drm_ErrCode { */ DRM_ERR_UNKNOWN = DRM_CAPI_ERR_BASE + 6, /** - * drm服务挂死。 + * drm服务死亡。 */ DRM_ERR_SERVICE_DIED = DRM_CAPI_ERR_BASE + 7, /** diff --git a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h index b0b40add0bf5194cd1fd3dd6bf512c17500a86b5..7345e50c8188ee818c0c3bfc7aa4bbd422a0f3d9 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h @@ -26,9 +26,10 @@ /** * @file native_mediakeysession.h * @brief 定义Drm MediaKeySession API。提供以下功能：\n - * 生成媒体密钥请求、处理媒体密钥响应、事件侦听、获取内容保护级别、 + * 生成媒体密钥请求、处理媒体密钥响应、事件监听、获取内容保护级别、 * 检查媒体密钥状态、删除媒体密钥等。 * @library libnative_drm.z.so + * @include * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 @@ -49,7 +50,7 @@ extern "C" #endif /** - * @brief 事件触发时将调用的回调。 + * @brief MediaKeySession事件触发时将调用的回调，如密钥过期事件。 * @param eventType 事件类型。 * @param info 从媒体密钥会话获取的事件信息。 * @param infoLen 事件信息长度。 @@ -62,10 +63,11 @@ typedef Drm_ErrCode (*MediaKeySession_EventCallback)(DRM_EventType eventType, u int32_t infoLen, char *extra); /** - * @brief 密钥更改时将调用回调。 - * @param keysInfo 从媒体密钥系统获取的密钥信息。 - * @param newKeysAvailable 新密钥是否可用 - * @return 当参数检查失败时返回DRM_ERR_INVALID_VAL，当函数调用成功时返回DRM_ERR_OK。 + * @brief 密钥变换时将调用回调。 + * @param keysInfo 密钥信息。 + * @param newKeysAvailable 新密钥是否可用。 + * @return DRM_ERR_OK：执行成功。\n + * DRM_ERR_INVALID_VAL：参数检查失败。 * @since 11 * @version 1.0 */ @@ -88,11 +90,11 @@ typedef struct MediaKeySession_Callback { /** * @brief 事件触发时将调用的回调。 - * @param mediaKeySession 媒体密钥会话实例。 + * @param mediaKeySession 会话实例。 * @param eventType 事件类型。 - * @param info 从媒体密钥会话获取的事件信息。 + * @param info 事件信息。 * @param infoLen 事件信息长度。 - * @param extra 从媒体密钥会话中获得的额外信息。 + * @param extra 增量信息。 * @return 错误码。 * @since 12 */ @@ -100,11 +102,12 @@ typedef Drm_ErrCode (*OH_MediaKeySession_EventCallback)(MediaKeySession *mediaKe uint8_t *info, int32_t infoLen, char *extra); /** - * @brief 密钥更改时将调用的回调。 + * @brief 密钥变换时将调用的回调。 * @param mediaKeySession 媒体密钥会话实例。 - * @param keysInfo 从媒体密钥系统获取的密钥信息。 + * @param keysInfo 密钥信息。 * @param newKeysAvailable 新密钥是否可用，true表示可用，false表示不可用。 - * @return 当参数检查失败时返回DRM_ERR_INVALID_VAL，当函数调用成功时返回DRM_ERR_OK。 + * @return DRM_ERR_OK：执行成功。\n + * DRM_ERR_INVALID_VAL：参数检查失败。 * @since 12 */ typedef Drm_ErrCode (*OH_MediaKeySession_KeyChangeCallback)(MediaKeySession *mediaKeySession, DRM_KeysInfo *keysInfo, @@ -127,7 +130,7 @@ typedef struct OH_MediaKeySession_Callback { /** * @brief 生成媒体密钥请求。 - * @param mediaKeySession 媒体密钥会话实例。 + * @param mediaKeySession MediaKeySession实例。 * @param info 媒体密钥请求信息。 * @param mediaKeyRequest 媒体密钥请求。 * @return DRM_ERR_OK：执行成功。\n @@ -141,12 +144,12 @@ Drm_ErrCode OH_MediaKeySession_GenerateMediaKeyRequest(MediaKeySession *mediaKey DRM_MediaKeyRequestInfo *info, DRM_MediaKeyRequest *mediaKeyRequest); /** - * @brief 处理媒体密钥响应。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param response 媒体密钥响应。 - * @param responseLen 媒体密钥响应长度。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param offlineMediaKeyIdLen 缓冲区内和缓冲区外数据的离线媒体密钥标识符的长度。 + * @brief 处理媒体密钥请求响应。 + * @param mediaKeySession MediaKeySession实例。 + * @param response 媒体密钥请求响应。 + * @param responseLen 媒体密钥请求响应长度。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param offlineMediaKeyIdLen 离线媒体密钥标识的长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或其它指针类型输入参数为空指针。\n @@ -159,7 +162,7 @@ Drm_ErrCode OH_MediaKeySession_ProcessMediaKeyResponse(MediaKeySession *mediaKey /** * @brief 检查媒体密钥状态。 - * @param mediaKeySession 媒体密钥会话实例。 + * @param mediaKeySession MediaKeySession实例。 * @param mediaKeyStatus 媒体密钥状态。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n @@ -173,7 +176,7 @@ Drm_ErrCode OH_MediaKeySession_CheckMediaKeyStatus(MediaKeySession *mediaKeySess /** * @brief 清除当前会话的媒体密钥。 - * @param mediaKeySession 媒体密钥会话实例。 + * @param mediaKeySession MediaKeySession实例。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -184,13 +187,15 @@ Drm_ErrCode OH_MediaKeySession_ClearMediaKeys(MediaKeySession *mediaKeySession); /** * @brief 生成离线媒体密钥释放请求。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param releaseRequestLen 离线媒体密钥标识符长度。 + * @param mediaKeySession MediaKeySession实例。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param releaseRequestLen 离线媒体密钥标识长度。 + * @param releaseRequest 离线媒体密钥释放请求。 + * @param releaseRequestLen 离线媒体密钥释放请求长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或其它指针类型输入参数为空指针。\n - * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 + * DRM_ERR_UNKNOWN：发生内部错误或设备上的DRM解决方案不支持离线媒体密钥释放，请查看日志详细信息。 * @since 11 * @version 1.0 */ @@ -199,15 +204,15 @@ Drm_ErrCode OH_MediaKeySession_GenerateOfflineReleaseRequest(MediaKeySession *me int32_t *releaseRequestLen); /** - * @brief 处理离线媒体密钥释放响应。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param offlineMediaKeyIdLen 离线媒体密钥标识符长度。 - * @param releaseReponse 媒体密钥响应。 - * @param releaseReponseLen 媒体密钥响应长度。 + * @brief 处理离线媒体密钥释放请求响应。 + * @param mediaKeySession MediaKeySession实例。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param offlineMediaKeyIdLen 离线媒体密钥标识长度。 + * @param releaseReponse 媒体密钥释放请求响应。 + * @param releaseReponseLen 媒体密钥释放请求响应长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或其它指针类型输入参数为空指针。\n - * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 + * DRM_ERR_UNKNOWN：发生内部错误或设备上的DRM解决方案不支持离线媒体密钥释放，请查看日志详细信息。 * @since 11 * @version 1.0 */ @@ -216,10 +221,10 @@ Drm_ErrCode OH_MediaKeySession_ProcessOfflineReleaseResponse(MediaKeySession *me int32_t releaseReponseLen); /** - * @brief 按ID还原离线媒体密钥。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param offlineMediaKeyIdLen 离线媒体密钥标识符长度。 + * @brief 恢复线媒体密钥到当前会话。 + * @param mediaKeySession MediaKeySession实例。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param offlineMediaKeyIdLen 离线媒体密钥标识长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或其它指针类型输入参数为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -231,7 +236,7 @@ Drm_ErrCode OH_MediaKeySession_RestoreOfflineMediaKeys(MediaKeySession *mediaKey /** * @brief 获取会话的内容保护级别。 - * @param mediaKeySession 媒体密钥会话实例。 + * @param mediaKeySession MediaKeySession实例。 * @param contentProtectionLevel 内容保护级别。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或输入参数contentProtectionLevel为空指针。\n @@ -243,10 +248,10 @@ Drm_ErrCode OH_MediaKeySession_GetContentProtectionLevel(MediaKeySession *mediaK DRM_ContentProtectionLevel *contentProtectionLevel); /** - * @brief 加密内容是否需要安全解码。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param mimeType 媒体类型。 - * @param status 是否需要安全解码。 + * @brief 是否需要安全解码。 + * @param mediaKeySession MediaKeySession实例。 + * @param mimeType 媒体类型，支持的媒体类型取决于DRM解决方案，如：video/avc、video/hev。 + * @param status 安全解码模块状态。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或其它指针类型输入参数为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -257,9 +262,9 @@ Drm_ErrCode OH_MediaKeySession_RequireSecureDecoderModule(MediaKeySession *media const char *mimeType, bool *status); /** - * @brief 设置媒体密钥会话事件回调。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param callback 要设置为媒体密钥会话的回调。 + * @brief 设置MediaKeySession会话事件回调。 + * @param mediaKeySession MediaKeySession实例。 + * @param callback MediaKeySession的回调。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或输入参数callback为空指针。 * @since 11 @@ -269,9 +274,9 @@ Drm_ErrCode OH_MediaKeySession_SetMediaKeySessionCallback(MediaKeySession *media MediaKeySession_Callback *callback); /** - * @brief 设置媒体密钥会话事件回调。 - * @param mediaKeySession 媒体密钥会话实例。 - * @param callback 要设置为媒体密钥会话的回调。 + * @brief 设置MediaKeySession事件回调。 + * @param mediaKeySession MediaKeySession实例。 + * @param callback MediaKeySession的回调。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效，或输入参数callback为空指针。 * @since 12 @@ -280,8 +285,8 @@ Drm_ErrCode OH_MediaKeySession_SetCallback(MediaKeySession *mediaKeySession, OH_MediaKeySession_Callback *callback); /** - * @brief 释放会话资源。 - * @param mediaKeySession 媒体密钥会话实例。 + * @brief 销毁MediaKeySession实例。 + * @param mediaKeySession MediaKeySession实例。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySession为空指针或无效。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 diff --git a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h index f066bc47a653749fd8654075bf6e1a0fc04362a4..357b35485b646f82c75e769429079773f246bdab 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h @@ -50,11 +50,11 @@ extern "C" { #endif /** - * @brief 事件触发时将调用的回调，不返回媒体密钥系统实例，适用于单个媒体密钥系统场景。 + * @brief MediaKeySystem事件触发时将调用的回调，不返回MediaKeySystem实例，适用于单个MediaKeySystem场景。 * @param eventType 事件类型。 - * @param info 从媒体密钥系统获取的事件信息。 + * @param info 事件信息。 * @param infoLen 事件信息长度。 - * @param extra 从媒体密钥系统获得的额外信息。 + * @param extra 增量信息。 * @return DRM_ERR_OK：执行成功。\n * DRM_ERR_INVALID_VAL：输入参数无效。 * @since 11 @@ -64,12 +64,12 @@ typedef Drm_ErrCode (*MediaKeySystem_Callback)(DRM_EventType eventType, uint8_t int32_t infoLen, char *extra); /** - * @brief 事件触发时将调用的回调，返回媒体密钥系统实例，适用于多个媒体密钥系统场景。 - * @param mediaKeySystem 媒体密钥系统实例。 + * @brief MediaKeySystem事件触发时将调用的回调，返回MediaKeySystem实例，适用于多个MediaKeySystem场景。 + * @param mediaKeySystem MediaKeySystem实例。 * @param eventType 事件类型。 - * @param info 从媒体密钥系统获取的事件信息。 + * @param info 事件信息。 * @param infoLen 事件信息长度。 - * @param extra 从媒体密钥系统获得的额外信息。 + * @param extra 增量信息。 * @return DRM_ERR_OK：执行成功。\n * DRM_ERR_INVALID_VAL：输入参数无效。 * @since 12 @@ -78,9 +78,9 @@ typedef Drm_ErrCode (*OH_MediaKeySystem_Callback)(MediaKeySystem *mediaKeySystem uint8_t *info, int32_t infoLen, char *extra); /** - * @brief 设置媒体密钥系统事件回调。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param callback 将回调设置为媒体密钥系统。 + * @brief 设置MediaKeySystem事件回调。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param callback 回调函数。 * @return DRM_ERR_OK：执行成功。\n * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效。 * @since 12 @@ -88,9 +88,9 @@ typedef Drm_ErrCode (*OH_MediaKeySystem_Callback)(MediaKeySystem *mediaKeySystem Drm_ErrCode OH_MediaKeySystem_SetCallback(MediaKeySystem *mediaKeySystem, OH_MediaKeySystem_Callback callback); /** - * @brief 获取支持的媒体密钥系统的名称和uuid。 - * @param infos 用于保存媒体密钥系统的名称和uuid的数组。 - * @param count 用于指示结构体DRM_MediaKeySystemMapInfo的计数。 + * @brief 获取设备支持的DRM解决方案的名称和唯一标识的列表。 + * @param infos DRM解决方案名称和唯一标识的列表。 + * @param count DRM解决方案名称和唯一标识的列表长度。 * @return DRM_ERR_OK：执行成功。\n * DRM_ERR_INVALID_VAL：可能原因：\n * 1.输入参数infos为空指针或输入参数count为空指针。\n @@ -99,11 +99,11 @@ Drm_ErrCode OH_MediaKeySystem_SetCallback(MediaKeySystem *mediaKeySystem, OH_Med * @since 12 * @version 1.0 */ -Drm_ErrCode OH_MediaKeySystem_GetMediaKeySystems(DRM_MediaKeySystemDescription *infos, uint32_t *count); +Drm_ErrCode OH_MediaKeySystem_GetMediaKeySystems(DRM_MediaKeySystemDescription *infos, uint32_t *count); /** - * @brief 查询是否支持媒体密钥系统。 - * @param name 用于指向数字权限管理解决方案。 + * @brief 查询设备是否支持对应的DRM解决方案。 + * @param name DRM解决方案名称。 * @return 是否支持。 * @since 11 * @version 1.0 @@ -111,9 +111,9 @@ Drm_ErrCode OH_MediaKeySystem_GetMediaKeySystems(DRM_MediaKeySystemDescription bool OH_MediaKeySystem_IsSupported(const char *name); /** - * @brief 查询是否支持媒体密钥系统。 - * @param name 用于指向数字权限管理解决方案。 - * @param mimeType 用于指定媒体类型。 + * @brief 查询设备是否支持对应的DRM解决方案名称及媒体类型。 + * @param name DRM解决方案名称。 + * @param mimeType 媒体类型，支持的媒体类型取决于DRM解决方案，如：video/avc、video/hev。 * @return 是否支持。 * @since 11 * @version 1.0 @@ -121,10 +121,10 @@ bool OH_MediaKeySystem_IsSupported(const char *name); bool OH_MediaKeySystem_IsSupported2(const char *name, const char *mimeType); /** - * @brief 查询是否支持媒体密钥系统。 - * @param name 用于指向数字权限管理解决方案。 - * @param mimeType 用于指定媒体类型。 - * @param contentProtectionLevel 用于指定安全等级。 + * @brief 查询设备是否支持对应的DRM解决方案、媒体类型、内容保护级别。 + * @param name DRM解决方案名称。 + * @param mimeType 媒体类型，支持的媒体类型取决于DRM解决方案，如：video/avc、video/hev。 + * @param contentProtectionLevel 内容保护级别。 * @return 是否支持。 * @since 11 * @version 1.0 @@ -133,11 +133,9 @@ bool OH_MediaKeySystem_IsSupported3(const char *name, const char *mimeType, DRM_ContentProtectionLevel contentProtectionLevel); /** - * @brief 根据名称创建媒体密钥系统实例。 - * @param name 说明将按名称创建哪个drm系统。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @return 当参数检查失败时返回DRM_ERR_INVALID_VAL，当函数调用成功时返回DRM_ERR_OK， - * 当达到媒体密钥系统的最大数量时，返回DRM_ERR_MAX_SYSTEM_NUM_REACHED。 + * @brief 创建MediaKeySystem实例。 + * @param name DRM解决方案名称。 + * @param mediaKeySystem MediaKeySystem实例。 * @return DRM_ERR_OK：执行成功。\n * DRM_ERR_INVALID_VAL：可能原因：\n * 1.输入参数name为空指针或长度为0。\n @@ -151,10 +149,10 @@ bool OH_MediaKeySystem_IsSupported3(const char *name, const char *mimeType, Drm_ErrCode OH_MediaKeySystem_Create(const char *name, MediaKeySystem **mediaKeySystem); /** - * @brief 按字符串类型名称设置媒体密钥系统配置值。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param configName 配置名称字符串。 - * @param value 要设置的字符串的配置值。 + * @brief 设置字符串类型的配置属性。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param configName 字符串类型配置属性名，不能为空，具体支持的属性名由设备上DRM解决方案决定。 + * @param value 字符串类型配置属性值，不能为空，具体支持的属性值由设备上DRM解决方案决定。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，输入参数configName为空指针，或输入参数value为空指针。 * @since 11 @@ -164,11 +162,11 @@ Drm_ErrCode OH_MediaKeySystem_SetConfigurationString(MediaKeySystem *mediaKeySys const char *configName, const char *value); /** - * @brief 按字符串类型名称获取媒体密钥系统配置值。 - * @param mediaKeySystem 媒体密钥系统实例。 + * @brief 获取字符串类型配置属性值。 + * @param mediaKeySystem MediaKeySystem实例。 * @param configName 字符串类型配置名。 - * @param value 字符串形式配置值。 - * @param valueLen 字符串形式配置值长度。 + * @param value 字符串类型配置值。 + * @param valueLen 字符串类型配置值长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，输入参数configName为空指针，或输入参数value为空指针。\n @@ -180,10 +178,10 @@ Drm_ErrCode OH_MediaKeySystem_GetConfigurationString(MediaKeySystem *mediaKeySys const char *configName, char *value, int32_t valueLen); /** - * @brief 通过字符数组类型配置名设置MediaKeySystem的配置值。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param configName 字符数组类型配置名。 - * @param value 字节数组形式配置值。 + * @brief 设置字符数组类型的配置属性值。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param configName 字符数组类型配置属性名，不能为空，具体支持的属性名由设备上DRM解决方案决定。 + * @param value 字符数组类型配置属性值，不能为空，具体支持的属性值由设备上DRM解决方案决定。 * @param valueLen 字节数组形式配置值长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n @@ -196,11 +194,11 @@ Drm_ErrCode OH_MediaKeySystem_SetConfigurationByteArray(MediaKeySystem *mediaKey const char *configName, uint8_t *value, int32_t valueLen); /** - * @brief 按字符数组类型名称获取媒体密钥系统配置值。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param configName 字符数组类型配置名称。 - * @param value 要获取数组中的配置值。 - * @param valueLen 数据的配置值长度。 + * @brief 获取字符数组类型配置属性值。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param configName 字符数组类型配置属性名称，不能为空，具体支持的属性名由设备上DRM解决方案决定。 + * @param value 字符数组类型配置属性。 + * @param valueLen 字符数组类型配置属性长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，输入参数configName为空指针，输入参数value为空指针，或valueLen为空指针。\n @@ -212,9 +210,9 @@ Drm_ErrCode OH_MediaKeySystem_GetConfigurationByteArray(MediaKeySystem *mediaKey const char *configName, uint8_t *value, int32_t *valueLen); /** - * @brief 获取媒体密钥系统度量信息。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param statistics 已获取度量信息。 + * @brief 获取度量记录。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param statistics 度量记录。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数statistics为空指针。\n @@ -225,8 +223,8 @@ Drm_ErrCode OH_MediaKeySystem_GetConfigurationByteArray(MediaKeySystem *mediaKey Drm_ErrCode OH_MediaKeySystem_GetStatistics(MediaKeySystem *mediaKeySystem, DRM_Statistics *statistics); /** - * @brief 获取支持的最高内容保护级别的媒体密钥系统。 - * @param mediaKeySystem 媒体密钥系统实例。 + * @brief 获取设备支持的最大内容保护级别。 + * @param mediaKeySystem MediaKeySystem实例。 * @param contentProtectionLevel 内容保护级别。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数contentProtectionLevel为空指针。\n @@ -238,9 +236,9 @@ Drm_ErrCode OH_MediaKeySystem_GetMaxContentProtectionLevel(MediaKeySystem *media DRM_ContentProtectionLevel *contentProtectionLevel); /** - * @brief 设置媒体密钥系统事件回调。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param callback 将回调设置为媒体密钥系统。 + * @brief 设置MediaKeySystem事件回调。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param callback 回调函数。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效。 * @since 11 @@ -250,10 +248,10 @@ Drm_ErrCode OH_MediaKeySystem_SetMediaKeySystemCallback(MediaKeySystem *mediaKey MediaKeySystem_Callback callback); /** - * @brief 创建媒体密钥会话实例。 - * @param mediaKeySystem 将创建媒体密钥会话的媒体密钥系统实例。 - * @param level 指定内容保护级别。 - * @param mediaKeySession 媒体密钥会话实例。 + * @brief 创建MediaKeySession会话实例。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param level 内容保护级别。 + * @param mediaKeySession MediaKeySession实例。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数level超出合理范围，或mediaKeySession为空指针。\n @@ -267,12 +265,12 @@ Drm_ErrCode OH_MediaKeySystem_CreateMediaKeySession(MediaKeySystem *mediaKeySyst DRM_ContentProtectionLevel *level, MediaKeySession **mediaKeySession); /** - * @brief 生成媒体密钥系统提供请求。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param request 发送给设备服务器的请求。 - * @param requestLen 设备证书请求的长度。 - * @param defaultUrl 设备证书服务器的网址。 - * @param defaultUrlLen 设备证书服务器的网址长度。 + * @brief 生成设备DRM证书请求。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param request 设备DRM证书请求。 + * @param requestLen 设备DRM证书请求的长度。 + * @param defaultUrl 设备DRM证书服务的URL。 + * @param defaultUrlLen 设备DRM证书服务的URL长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或其它指针类型输入参数为空指针。\n @@ -284,10 +282,10 @@ Drm_ErrCode OH_MediaKeySystem_GenerateKeySystemRequest(MediaKeySystem *mediaKeyS int32_t *requestLen, char *defaultUrl, int32_t defaultUrlLen); /** - * @brief 处理媒体密钥系统提供响应。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param response 将处理的响应。 - * @param responseLen 响应长度. + * @brief 处理设备DRM证书请求响应。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param response 设备DRM证书请求响应。 + * @param responseLen 设备DRM证书请求响应长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数response为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -298,9 +296,9 @@ Drm_ErrCode OH_MediaKeySystem_ProcessKeySystemResponse(MediaKeySystem *mediaKeyS uint8_t *response, int32_t responseLen); /** - * @brief 获取离线媒体密钥ID。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param offlineMediaKeyIds 所有离线媒体密钥的媒体密钥ID。 + * @brief 获取离线媒体密钥标识列表，媒体密钥标识用于对离线媒体密钥的管理。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param offlineMediaKeyIds 离线媒体密钥的媒体密钥标识列表。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_NO_MEMORY：内存不足，内存分配失败。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数offlineMediaKeyIds为空指针。\n @@ -312,11 +310,11 @@ Drm_ErrCode OH_MediaKeySystem_GetOfflineMediaKeyIds(MediaKeySystem *mediaKeySyst DRM_OfflineMediakeyIdArray *offlineMediaKeyIds); /** - * @brief Get offline media key status. - * @param mediaKeySystem 媒体密钥系统实例。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param offlineMediaKeyIdLen 离线媒体密钥标识符长度。 - * @param status 已获取媒体密钥状态。 + * @brief 获取离线媒体密钥状态。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param offlineMediaKeyIdLen 离线媒体密钥标识长度。 + * @param status 媒体密钥状态。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或其它指针类型输入参数为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -328,9 +326,9 @@ Drm_ErrCode OH_MediaKeySystem_GetOfflineMediaKeyStatus(MediaKeySystem *mediaKeyS /** * @brief 按id清除离线媒体密钥。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param offlineMediaKeyId 离线媒体密钥标识符。 - * @param offlineMediaKeyIdLen 离线媒体密钥标识符长度。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param offlineMediaKeyId 离线媒体密钥标识。 + * @param offlineMediaKeyIdLen 离线媒体密钥标识长度。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数offlineMediaKeyId为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -341,9 +339,9 @@ Drm_ErrCode OH_MediaKeySystem_ClearOfflineMediaKeys(MediaKeySystem *mediaKeySyst uint8_t *offlineMediaKeyId, int32_t offlineMediaKeyIdLen); /** - * @brief 获取媒体密钥系统的证书状态。 - * @param mediaKeySystem 媒体密钥系统实例。 - * @param certStatus 获得的证书状态值。 + * @brief 获取设备DRM证书状态。 + * @param mediaKeySystem MediaKeySystem实例。 + * @param certStatus 设备DRM证书状态值。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效，或输入参数certStatus为空指针。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。 @@ -354,8 +352,8 @@ Drm_ErrCode OH_MediaKeySystem_GetCertificateStatus(MediaKeySystem *mediaKeySyste DRM_CertificateStatus *certStatus); /** - * @brief Destroy a 媒体密钥系统实例。 - * @param mediaKeySystem 指定将销毁哪个媒体密钥系统实例。 + * @brief 销毁MediaKeySystem实例。 + * @param mediaKeySystem MediaKeySystem实例。 * @return DRM_ERR_OK：执行成功。\n  * DRM_ERR_INVALID_VAL：输入参数mediaKeySystem为空指针或无效。\n  * DRM_ERR_UNKNOWN：发生内部错误，请查看日志详细信息。