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 54b75da7d06d8e4abd2cb9fa319cabd74f520143..e2b157d7d44db1f8ef3637433d95ab7cc77ffee7 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 @@ -67,7 +67,7 @@ typedef enum DRM_EventType { */ EVENT_KEY_EXPIRED = 203, /** - * 第三方定义事件。 + * DRM解决方案自定义事件。 */ EVENT_VENDOR_DEFINED = 204, /** @@ -77,7 +77,7 @@ typedef enum DRM_EventType { } DRM_EventType; /** - * @brief 内容保护级别类型。 + * @brief 内容保护级别。 * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 @@ -106,7 +106,7 @@ typedef enum DRM_ContentProtectionLevel { } DRM_ContentProtectionLevel; /** - * @brief 许可证类型。 + * @brief 媒体密钥类型。 * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 @@ -123,7 +123,7 @@ typedef enum DRM_MediaKeyType { } DRM_MediaKeyType; /** - * @brief 许可证请求类型。 + * @brief 媒体密钥请求类型。 * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 @@ -156,7 +156,7 @@ typedef enum DRM_MediaKeyRequestType { } DRM_MediaKeyRequestType; /** - * @brief 离线许可证状态。 + * @brief 离线媒体密钥状态。 * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 @@ -177,48 +177,48 @@ typedef enum DRM_OfflineMediaKeyStatus { } DRM_OfflineMediaKeyStatus; /** - * @brief 设备证书状态类型。 + * @brief 设备DRM证书状态。 * @syscap SystemCapability.Multimedia.Drm.Core * @since 11 * @version 1.0 */ typedef enum DRM_CertificateStatus { /** - * 设备已安装设备证书。 + * 设备已安装设备DRM证书。 */ CERT_STATUS_PROVISIONED = 0, /** - * 设备未安装设备证书。 + * 设备未安装设备DRM证书或证书状态异常。 */ CERT_STATUS_NOT_PROVISIONED, /** - * 设备证书过期。 + * 设备DRM证书过期。 */ CERT_STATUS_EXPIRED, /** - * 无效设备证书。 + * 设备DRM证书无效。 */ CERT_STATUS_INVALID, /** - * 设备证书不可用。 + * 设备DRM证书不可用。 */ CERT_STATUS_UNAVAILABLE, } DRM_CertificateStatus; /** - * @brief 媒体密钥请求选项的最大计数。 + * @brief 媒体密钥请求可选数据的最大数量。 * @since 11 * @version 1.0 */ #define MAX_MEDIA_KEY_REQUEST_OPTION_COUNT 16 /** - * @brief 媒体密钥请求选项名称的最大长度。 + * @brief 媒体密钥请求可选数据名称的最大长度。 * @since 11 * @version 1.0 */ #define MAX_MEDIA_KEY_REQUEST_OPTION_NAME_LEN 64 /** - * @brief 媒体密钥请求选项数据的最大长度。 + * @brief 媒体密钥请求可选数据的最大长度。 * @since 11 * @version 1.0 */ @@ -230,7 +230,7 @@ typedef enum DRM_CertificateStatus { */ #define MAX_INIT_DATA_LEN 2048 /** - * @brief 媒体mimetype类型的最大长度。 + * @brief 媒体mimetype的最大长度。 * @since 11 * @version 1.0 */ @@ -263,17 +263,17 @@ typedef struct DRM_MediaKeyRequestInfo { */ uint32_t optionsCount; /** - * 选项将应用程序集命名到drm框架。 + * 选项名称集合。 */ char optionName[MAX_MEDIA_KEY_REQUEST_OPTION_COUNT][MAX_MEDIA_KEY_REQUEST_OPTION_NAME_LEN]; /** - * 选项数据应用程序设置到drm框架。 + * 选项数据集合。 */ char optionData[MAX_MEDIA_KEY_REQUEST_OPTION_COUNT][MAX_MEDIA_KEY_REQUEST_OPTION_DATA_LEN]; } DRM_MediaKeyRequestInfo; /** - * @brief 媒体密钥请求的最大长度。 + * @brief 媒体密钥请求数据的最大长度。 * @since 11 * @version 1.0 */ @@ -309,19 +309,19 @@ typedef struct DRM_MediaKeyRequest { } DRM_MediaKeyRequest; /** - * @brief 统计项的最大计数。 + * @brief 度量记录的最大数量。 * @since 11 * @version 1.0 */ #define MAX_STATISTICS_COUNT 10 /** - * @brief 统计项名称的最大长度。 + * @brief 度量记录名称的最大长度。 * @since 11 * @version 1.0 */ #define MAX_STATISTICS_NAME_LEN 64 /** - * @brief 统计项缓冲区的最大长度。 + * @brief 度量记录缓冲区的最大长度。 * @since 11 * @version 1.0 */ @@ -342,13 +342,13 @@ typedef struct DRM_Statistics { } DRM_Statistics; /** - * @brief 离线媒体密钥id的最大计数。 + * @brief 离线媒体密钥标识的最大数量。 * @since 11 * @version 1.0 */ #define MAX_OFFLINE_MEDIA_KEY_ID_COUNT 512 /** - * @brief 离线媒体密钥id的最大长度。 + * @brief 离线媒体密钥标识的最大长度。 * @since 11 * @version 1.0 */ @@ -369,13 +369,13 @@ typedef struct DRM_OfflineMediakeyIdArray { } DRM_OfflineMediakeyIdArray; /** - * @brief 密钥信息的最大计数。 + * @brief 密钥信息的最大数量。 * @since 11 * @version 1.0 */ #define MAX_KEY_INFO_COUNT 64 /** - * @brief 密钥id的最大长度。 + * @brief 密钥标识的最大长度。 * @since 11 * @version 1.0 */ @@ -402,7 +402,7 @@ typedef struct DRM_KeysInfo { } DRM_KeysInfo; /** - * @brief 媒体密钥状态的最大计数。 + * @brief 媒体密钥状态的最大数量。 * @since 11 * @version 1.0 */ @@ -421,7 +421,7 @@ typedef struct DRM_KeysInfo { #define MAX_MEDIA_KEY_STATUS_VALUE_LEN 256 /** - * @brief Media key status like pocily etc. + * @brief 媒体密钥状态。 * @since 11 * @version 1.0 */ @@ -435,26 +435,26 @@ typedef struct DRM_MediaKeyStatus { } DRM_MediaKeyStatus; /** - * @brief Drm系统 uuid长度。 + * @brief DRM解决方案的UUID长度。 * @since 11 * @version 1.0 */ #define DRM_UUID_LEN 16 /** - * @brief PSSH数据的最大长度。 + * @brief PSSH(Protected System Specific Header)信息的最大长度。 * @since 11 * @version 1.0 */ #define MAX_PSSH_DATA_LEN 2048 /** - * @brief uuid的PSSH信息。 + * @brief DRM内容保护系统专用头(Protection System Specific Header)信息。 * @since 11 * @version 1.0 */ typedef struct DRM_PsshInfo { /** - * UUID。 + * UUID的PSSH信息。 */ uint8_t uuid[DRM_UUID_LEN]; /** @@ -462,20 +462,20 @@ typedef struct DRM_PsshInfo { */ int32_t dataLen; /** - * uint8_t PSSH数据。 + * PSSH数据。 */ uint8_t data[MAX_PSSH_DATA_LEN]; } DRM_PsshInfo; /** - * @brief PSSH信息的最大计数。 + * @brief PSSH(Protected System Specific Header)信息的最大数量。 * @since 11 * @version 1.0 */ #define MAX_PSSH_INFO_COUNT 8 /** - * @brief 用于播放器从媒体源获取媒体密钥系统信息。 + * @brief 加密媒体内容的DRM信息。 * @since 11 * @version 1.0 */ @@ -495,28 +495,28 @@ typedef struct DRM_MediaKeySystemInfo { typedef void (*DRM_MediaKeySystemInfoCallback)(DRM_MediaKeySystemInfo *mediaKeySystemInfo); /** - * @brief 媒体密钥系统结构。 + * @brief MediaKeySystem结构。 * @since 11 * @version 1.0 */ typedef struct MediaKeySystem MediaKeySystem; /** - * @brief 媒体密钥会话结构。 + * @brief MediaKeySession结构。 * @since 11 * @version 1.0 */ typedef struct MediaKeySession MediaKeySession; /** - * @brief 媒体密钥系统名称的最大长度。 + * @brief MediaKeySystem名称的最大长度。 * @since 12 * @version 1.0 */ #define MAX_MEDIA_KEY_SYSTEM_NAME_LEN 128 /** - * @brief 支持的媒体密钥系统的最大数量。 + * @brief MediaKeySystem的最大数量。 * @since 12 * @version 1.0 */ @@ -524,7 +524,7 @@ typedef struct MediaKeySession MediaKeySession; /** - * @brief DRM插件的名称和UUID。 + * @brief DRM解决方案名称及其UUID的列表。 * @since 12 * @version 1.0 */ 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 7345e50c8188ee818c0c3bfc7aa4bbd422a0f3d9..ff08ef30d61640ba3ce8f8e7bcab68e855075858 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysession.h @@ -221,7 +221,7 @@ Drm_ErrCode OH_MediaKeySession_ProcessOfflineReleaseResponse(MediaKeySession *me int32_t releaseReponseLen); /** - * @brief 恢复线媒体密钥到当前会话。 + * @brief 恢复离线媒体密钥到当前会话。 * @param mediaKeySession MediaKeySession实例。 * @param offlineMediaKeyId 离线媒体密钥标识。 * @param offlineMediaKeyIdLen 离线媒体密钥标识长度。 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 357b35485b646f82c75e769429079773f246bdab..7068aa08a9bc269dbd30cbdb2fee3ab54465b46e 100644 --- a/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h +++ b/zh-cn/native_sdk/multimedia/drm_framework/native_mediakeysystem.h @@ -182,7 +182,7 @@ Drm_ErrCode OH_MediaKeySystem_GetConfigurationString(MediaKeySystem *mediaKeySys * @param mediaKeySystem MediaKeySystem实例。 * @param configName 字符数组类型配置属性名,不能为空,具体支持的属性名由设备上DRM解决方案决定。 * @param value 字符数组类型配置属性值,不能为空,具体支持的属性值由设备上DRM解决方案决定。 - * @param valueLen 字节数组形式配置值长度。 + * @param valueLen 字符数组类型配置属性值长度。 * @return DRM_ERR_OK:执行成功。\n  * DRM_ERR_NO_MEMORY:内存不足,内存分配失败。\n  * DRM_ERR_INVALID_VAL:输入参数mediaKeySystem为空指针或无效,输入参数configName为空指针,或输入参数value为空指针。\n