DRM系统管理(MediaKeySystem)支持MediaKeySystem实例管理、设备DRM证书申请与处理、会话实例管理、离线媒体密钥管理、获取DRM度量统计信息、设备属性等。在使用DRM Kit功能时,先查询设备是否支持对应DRM解决方案的DRM功能。在DRM Kit里DRM解决方案以插件形式存在,所以也叫DRM插件。
开发步骤
- 导入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"
-
在CMake脚本中链接Drm NDK动态库。
target_link_libraries(PUBLIC libnative_drm.so)
-
查询设备是否支持对应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.");
}
- 创建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.");
}
- 创建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.");
}
- 检查设备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.");
}
}
- (可选)获取离线媒体密钥标识,获取离线媒体密钥状态、清理离线媒体密钥。
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.");
}
- (可选)设置和获取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);
}
- (可选)获取设备支持的最大内容保护级别。
DRM_ContentProtectionLevel contentProtectionLevel = CONTENT_PROTECTION_LEVEL_UNKNOWN;
ret = OH_MediaKeySystem_GetMaxContentProtectionLevel(mediaKeySystem, &contentProtectionLevel);
if (ret != DRM_ERR_OK) {
printf("OH_MediaKeySystem_GetMaxContentProtectionLevel failed.");
}
- 销毁MediaKeySession实例。
ret = OH_MediaKeySession_Destroy(mediaKeySession);
if (ret != DRM_ERR_OK) {
printf("OH_MediaKeySession_Destroy failed.");
}
- 销毁MediaKeySystem实例。
ret = OH_MediaKeySystem_Destroy(mediaKeySystem);
if (ret != DRM_ERR_OK) {
printf("OH_MediaKeySystem_Destroy failed.");
}
最后呢
很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。
而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点
如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。
针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说,我们直接看详细鸿蒙(OpenHarmony )手册(共计1236页)与鸿蒙(OpenHarmony )开发入门视频,帮助大家在技术的道路上更进一步。
- 《鸿蒙 (OpenHarmony)开发学习视频》
- 《鸿蒙生态应用开发V2.0白皮书》
- 《鸿蒙 (OpenHarmony)开发基础到实战手册》
- OpenHarmony北向、南向开发环境搭建
- 《鸿蒙开发基础》
- 《鸿蒙开发进阶》
- 《鸿蒙开发实战》
总结
鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程,从而开设鸿蒙课程;企业纷纷跟进启动了鸿蒙研发。
并且鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,未来将会支持 50 万款的应用。那么这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行! 自↓↓↓拿