harmony 鸿蒙native_mediakeysystem.h

2025-06-12
浏览 (5)

native_mediakeysystem.h

概述

定义Drm MediaKeySystem API。提供以下功能：查询是否支持指定的DRM解决方案，创建媒体密钥会话，获取和设置DRM配置属性，获取设备DRM度量信息，查询内容保护级别，生成设备DRM证书请求，处理设备DRM证书请求响应，事件监听，管理离线媒体密钥等。

库： libnative_drm.so

引用文件： <multimedia/drm_framework/native_mediakeysystem.h>

系统能力： SystemCapability.Multimedia.Drm.Core

起始版本： 11

相关模块：Drm

汇总

类型定义

名称	描述
typedef Drm_ErrCode(* MediaKeySystem_Callback) (DRM_EventType eventType, uint8_t info, int32_t infoLen, char extra)	事件触发时将调用的回调，不返回媒体密钥系统实例，适用于单个媒体密钥系统场景。
typedef Drm_ErrCode(* OH_MediaKeySystem_Callback) (MediaKeySystem mediaKeySystem, DRM_EventType eventType, uint8_t info, int32_t infoLen, char *extra)	事件触发时将调用的回调，返回媒体密钥系统实例，适用于多个媒体密钥系统场景。

函数

名称	描述
Drm_ErrCode OH_MediaKeySystem_SetCallback (MediaKeySystem *mediaKeySystem, OH_MediaKeySystem_Callback callback)	设置MediaKeySystem事件回调。
bool OH_MediaKeySystem_IsSupported (const char *name)	判断设备是否支持指定的DRM解决方案。
bool OH_MediaKeySystem_IsSupported2 (const char name, const char mimeType)	判断设备是否支持指定DRM解决方案及媒体类型。
bool OH_MediaKeySystem_IsSupported3 (const char name, const char mimeType, DRM_ContentProtectionLevel contentProtectionLevel)	判断设备是否支持指定DRM解决方案、媒体类型以及内容保护级别。
Drm_ErrCode OH_MediaKeySystem_GetMediaKeySystems (DRM_MediaKeySystemDescription infos, uint32_t count)	获取设备支持的DRM解决方案的名称和唯一标识列表。
Drm_ErrCode OH_MediaKeySystem_Create (const char name, MediaKeySystem *mediaKeySystem)	根据DRM解决方案名称创建MediaKeySystem实例。
Drm_ErrCode OH_MediaKeySystem_SetConfigurationString (MediaKeySystem mediaKeySystem, const char configName, const char *value)	设置字符串类型配置属性值。
Drm_ErrCode OH_MediaKeySystem_GetConfigurationString (MediaKeySystem mediaKeySystem, const char configName, char *value, int32_t valueLen)	获取字符串类型配置属性值。
Drm_ErrCode OH_MediaKeySystem_SetConfigurationByteArray (MediaKeySystem mediaKeySystem, const char configName, uint8_t *value, int32_t valueLen)	设置字符数组类型配置属性值。
Drm_ErrCode OH_MediaKeySystem_GetConfigurationByteArray (MediaKeySystem mediaKeySystem, const char configName, uint8_t value, int32_t valueLen)	获取字符数组类型配置属性值。
Drm_ErrCode OH_MediaKeySystem_GetStatistics (MediaKeySystem mediaKeySystem, DRM_Statistics statistics)	获取媒体密钥系统度量信息。
Drm_ErrCode OH_MediaKeySystem_GetMaxContentProtectionLevel (MediaKeySystem mediaKeySystem, DRM_ContentProtectionLevel contentProtectionLevel)	获取当前DRM解决方案支持的最大内容保护级别。
Drm_ErrCode OH_MediaKeySystem_SetMediaKeySystemCallback (MediaKeySystem *mediaKeySystem, MediaKeySystem_Callback callback)	设置MediaKeySystem事件回调。
Drm_ErrCode OH_MediaKeySystem_CreateMediaKeySession (MediaKeySystem mediaKeySystem, DRM_ContentProtectionLevel level, MediaKeySession **mediaKeySession)	创建MediaKeySession实例。
Drm_ErrCode OH_MediaKeySystem_GenerateKeySystemRequest (MediaKeySystem mediaKeySystem, uint8_t request, int32_t requestLen, char defaultUrl, int32_t defaultUrlLen)	生成设备DRM证书请求。
Drm_ErrCode OH_MediaKeySystem_ProcessKeySystemResponse (MediaKeySystem mediaKeySystem, uint8_t response, int32_t responseLen)	处理设备DRM证书请求响应。
Drm_ErrCode OH_MediaKeySystem_GetOfflineMediaKeyIds (MediaKeySystem mediaKeySystem, DRM_OfflineMediakeyIdArray offlineMediaKeyIds)	获取离线媒体密钥标识。
Drm_ErrCode OH_MediaKeySystem_GetOfflineMediaKeyStatus (MediaKeySystem mediaKeySystem, uint8_t offlineMediaKeyId, int32_t offlineMediaKeyIdLen, DRM_OfflineMediaKeyStatus *status)	获取离线媒体密钥状态。
Drm_ErrCode OH_MediaKeySystem_ClearOfflineMediaKeys (MediaKeySystem mediaKeySystem, uint8_t offlineMediaKeyId, int32_t offlineMediaKeyIdLen)	清除离线媒体密钥。
Drm_ErrCode OH_MediaKeySystem_GetCertificateStatus (MediaKeySystem mediaKeySystem, DRM_CertificateStatus certStatus)	获取设备DRM证书状态。
Drm_ErrCode OH_MediaKeySystem_Destroy (MediaKeySystem *mediaKeySystem)	销毁MediaKeySystem实例。