鸿蒙（API 12 Beta3版）【DRM会话管理(C/C++)】数字版权保护开发

DRM会话管理（MediaKeySession）支持媒体密钥管理及媒体解密等，MediaKeySession实例由系统管理里的MediaKeySystem实例创建和销毁。

开发步骤

1. 导入NDK接口，接口中提供了DRM相关的属性和方法，导入方法如下。

 #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"
1
2
3
4

1. 在CMake脚本中链接Drm NDK动态库。

    target_link_libraries(PUBLIC libnative_drm.so)
   1

2. 声明MediaKeySystem监听回调。

// 适用于单个MediaKeySystem实例的场景。
static Drm_ErrCode SessoinEventCallBack(DRM_EventType  eventType, uint8_t *info, int32_t infoLen, char *extra)
{
    return DRM_ERR_OK;
}

static Drm_ErrCode SessoinKeyChangeCallBack(DRM_KeysInfo *keysInfo, bool newKeysAvailable)
{
    return DRM_ERR_OK;
}

// 适用于多个MediaKeySystem实例的场景。
static Drm_ErrCode SessoinEventCallBackWithObj(MediaKeySession *mediaKeySessoin, DRM_EventType eventType, uint8_t *info, int32_t infoLen, char *extra)
{
    return DRM_ERR_OK;
}

static Drm_ErrCode SessoinKeyChangeCallBackWithObj(MediaKeySession *mediaKeySessoin, DRM_KeysInfo *keysInfo, bool hasNewGoodKeys)
{
    return DRM_ERR_OK;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

1. 设置MediaKeySystem监听回调。

// 适用于单个MediaKeySystem实例的场景。
MediaKeySession_Callback sessionCallback = { SessoinEventCallBack, SessoinKeyChangeCallBack };
Drm_ErrCode ret = OH_MediaKeySession_SetMediaKeySessionCallback(mediaKeySession, &sessionCallback);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_SetMediaKeySessionCallback failed.");
}

// 适用于多个MediaKeySystem实例的场景。
OH_MediaKeySession_Callback sessionCallback = { SessoinEventCallBackWithObj, SessoinKeyChangeCallBackWithObj };
ret = OH_MediaKeySession_SetCallback(mediaKeySession, &sessionCallback);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_SetCallback failed.");
}
1
2
3
4
5
6
7
8
9
10
11
12
13

1. 生成媒体密钥请求，媒体密钥请求响应处理。

DRM_MediaKeyRequest mediaKeyRequest;
DRM_MediaKeyRequestInfo info;
// initData对应码流中的pssh数据，请按实际数据填入
unsigned char initData[128] = {0x00};
memset_s(&info, sizeof(DRM_MediaKeyRequestInfo), 0, sizeof(DRM_MediaKeyRequestInfo));
info.initDataLen = sizeof(initData);
info.type = MEDIA_KEY_TYPE_ONLINE;
memcpy_s(info.mimeType, sizeof("video/avc"), (char *)"video/avc", sizeof("video/avc"));
memcpy_s(info.initData, sizeof(initData), initData, sizeof(initData));
memcpy_s(info.optionName[0], sizeof("optionalDataName"), (char *)"optionalDataName", sizeof("optionalDataName"));
memcpy_s(info.optionData[0], sizeof("optionalDataValue"), (char *)"optionalDataValue", sizeof("optionalDataValue"));
info.optionsCount = 1;
ret = OH_MediaKeySession_GenerateMediaKeyRequest(mediaKeySession, &info, &mediaKeyRequest);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_GenerateMediaKeyRequest failed.");
}
/* 不同解决方案的离线媒体密钥标识组成不同，获取离线媒体密钥标识的方法有两种：
  1、应用调用OH_MediaKeySystem_GetOfflineMediaKeyIds接口获取离线媒体密钥标识；
  2、应用通过网络请求DRM服务，获取离线媒体密钥响应keySessionResponse，将响应传到OH_MediaKeySession_ProcessMediaKeyResponse解析
     出离线媒体密钥标识mediaKeyId；媒体密钥标识最大长度为128，如下代码所示，请根据实际的媒体密钥数据和长度传入；
*/
unsigned char mediaKeyId[26] = {0x00};
int32_t mediaKeyIdLen = 26;
// 媒体密钥请求响应长度最大为12288，请按实际数据输入
unsigned char mediaKeyResponse[12288] = {0x00};
int32_t mediaKeyResponseLen = 12288;
ret = OH_MediaKeySession_ProcessMediaKeyResponse(mediaKeySession, mediaKeyResponse,
    mediaKeyResponseLen, mediaKeyId, &mediaKeyIdLen);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_ProcessMediaKeyResponse failed.");
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

1. （可选）检查当前MediaKeySession会话的媒体密钥状态。

DRM_MediaKeyStatus mediaKeyStatus;
ret = OH_MediaKeySession_CheckMediaKeyStatus(mediaKeySession, &mediaKeyStatus);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_CheckMediaKeyStatus failed.");
}
1
2
3
4
5

1. （可选）清理当前会话下所有媒体密钥。

ret = OH_MediaKeySession_ClearMediaKeys(mediaKeySession);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_ClearMediaKeys failed.");
}
1
2
3
4

1. （可选）生成离线媒体密钥释放请求和处理离线媒体密钥释放响应。

uint8_t releaseRequest[MAX_MEDIA_KEY_REQUEST_DATA_LEN];
int32_t releaseRequestLen = MAX_MEDIA_KEY_REQUEST_DATA_LEN;
ret = OH_MediaKeySession_GenerateOfflineReleaseRequest(mediaKeySession,
    mediaKeyId, mediaKeyIdLen, releaseRequest, &releaseRequestLen);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_GenerateOfflineReleaseRequest failed.");
}
// keyReleaseResponse是使用请求体releaseRequest通过网络请求从DRM服务获取的离线媒体密钥释放响应，请根据实际值传入
unsigned char keyReleaseResponse[12288] = {0x00};
int32_t keyReleaseResponseLen = 12288;
ret = OH_MediaKeySession_ProcessOfflineReleaseResponse(mediaKeySession, mediaKeyId, mediaKeyIdLen,
   keyReleaseResponse, keyReleaseResponseLen);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_ProcessOfflineReleaseResponse failed.");
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

1. （可选）恢复离线媒体密钥到当前会话。

// 将指定媒体密钥标识的媒体密钥加载到当前会话，被加载的媒体密钥可以是当前会话的也可以是其他会话的
ret = OH_MediaKeySession_RestoreOfflineMediaKeys(mediaKeySession, mediaKeyId, mediaKeyIdLen);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_RestoreOfflineMediaKeys failed.");
}
1
2
3
4
5

1. （可选）调用MediaKeySession类中的OH_MediaKeySession_GetContentProtectionLevel方法获取当前会话的内容保护级别。

DRM_ContentProtectionLevel sessionContentProtectionLevel;
ret = OH_MediaKeySession_GetContentProtectionLevel(mediaKeySession,
    &sessionContentProtectionLevel);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_GetContentProtectionLevel failed.");
}
1
2
3
4
5
6

1. （可选）获取是否需要安全解码。

bool requireSecureDecoder;
ret = OH_MediaKeySession_RequireSecureDecoderModule(mediaKeySession, "video/avc", &requireSecureDecoder);
if (ret != DRM_ERR_OK) {
    printf("OH_MediaKeySession_RequireSecureDecoderModule failed.");
}
1
2
3
4
5

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙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 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿