鸿蒙5.0版开发:DRM系统管理(C/C++)

 往期鸿蒙全套实战文章必看:


DRM系统管理(C/C++)

DRM系统管理(MediaKeySystem)支持MediaKeySystem实例管理、设备DRM证书申请与处理、会话实例管理、离线媒体密钥管理、获取DRM度量统计信息、设备属性等。在使用DRM Kit功能时,先查询设备是否支持对应DRM解决方案的DRM功能。在DRM Kit里DRM解决方案以插件形式存在,所以也叫DRM插件。

开发步骤

  1. 导入NDK相关接口,导入方法如下。

     #include "multimedia/drm_framework/native_drm_common.h"
     #include "multimedia/drm_framework/native_drm_err.h"
     #include "multimedia/drm_framework/native_mediakeysession.h"
     #include "multimedia/drm_framework/native_mediakeysystem.h"
  2. 在CMake脚本中链接Drm NDK动态库。

     target_link_libraries(PUBLIC libnative_drm.so)
  3. 查询设备是否支持对应DRM解决方案名称、媒体类型、安全保护级别的DRM解决方案。

     bool isSupported = OH_MediaKeySystem_IsSupported3("com.wiseplay.drm", "video/avc", CONTENT_PROTECTION_LEVEL_SW_CRYPTO);
     if (isSupported != true) {
         printf("The device does not support the content protection level.");
     }

4.(可选)获取设备支持的DRM解决方案的名称和唯一标识的列表。

 uint32_t count = 1; // count是当前设备实际支持的DRM插件的个数,用户根据实际情况设置
 DRM_MediaKeySystemDescription descriptions[1];
 memset(descriptions, 0, sizeof(descriptions));
 Drm_ErrCode ret = OH_MediaKeySystem_GetMediaKeySystems(descriptions, &count);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetMediaKeySystems failed.");
 }
  1. 创建MediaKeySystem实例。

     MediaKeySystem *mediaKeySystem = NULL;
     Drm_ErrCode ret = OH_MediaKeySystem_Create("com.wiseplay.drm", &mediaKeySystem);
     if (ret != DRM_ERR_OK) {
         printf("OH_MediaKeySystem_Create failed.");
     }

6.(可选)声明MediaKeySystem事件监听回调。

  // 适用于多个MediaKeySystem实例的场景
 static Drm_ErrCode SystemCallBack(DRM_EventType eventType, uint8_t *info, int32_t infoLen, char *extra)
 {
     printf("SystemCallBack");
 }
 // 适用于单个MediaKeySystem实例的场景。
 static Drm_ErrCode SystemCallBackWithObj(MediaKeySystem *mediaKeySystem, DRM_EventType eventType,
 uint8_t *info, int32_t infoLen, char *extra)
 {
     printf("TestSystemCallBackWithObj");
 }

7.(可选)设置MediaKeySystem事件监听回调。

  // 适用于多个MediaKeySystem实例的场景
 Drm_ErrCode ret = OH_MediaKeySystem_SetMediaKeySystemCallback(mediaKeySystem, SystemCallBack);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_SetMediaKeySystemCallback failed.");
 }

 // 适用于单个MediaKeySystem实例的场景。
 ret = OH_MediaKeySystem_SetCallback(mediaKeySystem, SystemCallBackWithObj);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_SetCallback failed.");
 }
  1. 创建MediaKeySession会话实例。

     MediaKeySession *mediaKeySession = nullptr;
     DRM_ContentProtectionLevel contentProtectionLevel = CONTENT_PROTECTION_LEVEL_SW_CRYPTO;
     ret = OH_MediaKeySystem_CreateMediaKeySession(mediaKeySystem, &contentProtectionLevel, &mediaKeySession);
     if (ret != DRM_ERR_OK || mediaKeySession == nullptr) {
         printf("OH_MediaKeySystem_CreateMediaKeySession failed.");
     }
  2. 检查设备DRM证书状态,设备DRM证书不存在或状态异常,则生成设备DRM证书请求,处理设备DRM证书响应。

     unsigned char request[12288] = { 0x00 };  // 设备DRM证书request最大长度为12288,按实际大小申请
     int32_t requestLen = 12288;
     // DRM服务URL的最大长度为2048
     char defaultUrl[2048] = { 0x00 };
     int32_t defaultUrlLen = 2048;
     DRM_CertificateStatus certStatus = CERT_STATUS_INVALID;
     // 检查设备DRM证书状态
     ret = OH_MediaKeySystem_GetCertificateStatus(mediaKeySystem, &certStatus);
     if (ret == DRM_ERR_OK && certStatus == CERT_STATUS_NOT_PROVISIONED) {
         ret = OH_MediaKeySystem_GenerateKeySystemRequest(mediaKeySystem, request, &requestLen, defaultUrl,
             defaultUrlLen);
         /* 
           应用通过网络请求,将设备DRM证书请求信息传到DRM服务获取设备DRM证书请求响应keySystemResponse,
           再将设备DRM证书请求响应设置到设备上,请根据实际值和长度传入
         */
         unsigned char KeySystemResponse[12288] = {0x00};
         ret = OH_MediaKeySystem_ProcessKeySystemResponse(mediaKeySystem, KeySystemResponse, sizeof(KeySystemResponse));
         if (ret != DRM_ERR_OK) {
             printf("OH_MediaKeySystem_ProcessKeySystemResponse failed.");
         }
     }
  3. (可选)获取离线媒体密钥标识,获取离线媒体密钥状态、清理离线媒体密钥。

 DRM_OfflineMediakeyIdArray offlineMediaKeyIds;
 ret = OH_MediaKeySystem_GetOfflineMediaKeyIds(mediaKeySystem, &offlineMediaKeyIds);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetOfflineMediaKeyIds failed.");
 }
 DRM_OfflineMediaKeyStatus OfflineMediaKeyStatus = OFFLINE_MEDIA_KEY_STATUS_UNKNOWN;
 ret = OH_MediaKeySystem_GetOfflineMediaKeyStatus(mediaKeySystem, offlineMediaKeyIds.ids[0], offlineMediaKeyIds.idsLen[0], &OfflineMediaKeyStatus);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetOfflineMediaKeyStatus failed.");
 }
 ret = OH_MediaKeySystem_ClearOfflineMediaKeys(mediaKeySystem, offlineMediaKeyIds.ids[0], offlineMediaKeyIds.idsLen[0]);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_ClearOfflineMediaKeys failed.");
 }
  1. (可选)设置和获取DRM配置属性信息。

说明

不同的DRM方案的配置属性信息可能存在差别,支持的属性名包含:"vendor"、"version"、"description"、"algorithms"、"maxSessionNum"、"currentHDCPLevel"。需解决方案支持属性值设置能力才能设置DRM配置属性信息。

 ret = OH_MediaKeySystem_SetConfigurationString(mediaKeySystem, "version", "2.0"); // 设置字符串类型的配置信息
 if (ret == DRM_ERR_OK) {
     printf("MediaKeySystem_SetConfigurationString success");
 } else {
     printf("MediaKeySystem_SetConfigurationString failed. %d ", ret);
 }
 char value[32];
 int32_t valueLen = 32;
 // 获取字符串类型的配置信息
 ret = OH_MediaKeySystem_GetConfigurationString(mediaKeySystem, "version", value, valueLen);
 if (ret == DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetConfigurationString success");
 } else {
     printf("OH_MediaKeySystem_GetConfigurationString failed. %d ", ret);
 }
 // 设置字符数组类型的配置信息,请根据实际数据和长度传入
 uint8_t description[4] = {0x00, 0x00, 0x00, 0x00};
 ret = OH_MediaKeySystem_SetConfigurationByteArray(mediaKeySystem, "description", description, sizeof(description)/sizeof(uint8_t));
 if (ret == DRM_ERR_OK) {
     printf("OH_MediaKeySystem_SetConfigurationByteArray success ");
 } else {
     printf("OH_MediaKeySystem_SetConfigurationByteArray failed. %d ", ret);
 }
  // 获取字符数组类型的配置信息,根据DRM解决方案实际情况填入
 uint8_t descriptionValue[32];
 int32_t descriptionValueLen = 32;
 ret = OH_MediaKeySystem_GetConfigurationByteArray(mediaKeySystem, "description", descriptionValue, &descriptionValueLen);
 if (ret == DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetConfigurationByteArray success ");
 } else {
     printf("OH_MediaKeySystem_GetConfigurationByteArray failed. %d ", ret);
 }
  1. (可选)获取设备支持的最大内容保护级别。
 DRM_ContentProtectionLevel contentProtectionLevel = CONTENT_PROTECTION_LEVEL_UNKNOWN;
 ret = OH_MediaKeySystem_GetMaxContentProtectionLevel(mediaKeySystem, &contentProtectionLevel);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_GetMaxContentProtectionLevel failed.");
 }
  1. 销毁MediaKeySession实例。
 ret = OH_MediaKeySession_Destroy(mediaKeySession);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySession_Destroy failed.");
 }
  1. 销毁MediaKeySystem实例。
 ret = OH_MediaKeySystem_Destroy(mediaKeySystem);
 if (ret != DRM_ERR_OK) {
     printf("OH_MediaKeySystem_Destroy failed.");
 }

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值