鸿蒙（API 12 Beta3版）【DRM会话管理(ArkTS)】数字版权保护

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

开发步骤

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

   import { drm } from '@kit.DrmKit';
   

2. 导入BusinessError模块，用于获取drm模块相关接口抛出的错误码。

   import { BusinessError } from '@kit.BasicServicesKit';
   

3. 状态监听。

   监听MediaKeySession实例的事件，包括密钥请求事件、密钥过期事件、第三方自定义事件、密钥过期更新事件、密钥变换事件。

• 监听密钥请求事件，媒体密钥请求时触发。

mediaKeySession.on('keyRequired', (eventInfo: drm.EventInfo) => {
  console.log('keyRequired' + 'info:' + eventInfo.info + ' extraInfo:' + eventInfo.extraInfo);
});

• 监听媒体密钥过期事件，媒体密钥过期时触发。

mediaKeySession.on('keyExpired', (eventInfo: drm.EventInfo) => {
   console.log('keyExpired' + 'info:' + eventInfo.info + ' extraInfo:' + eventInfo.extraInfo);
});

• 监听DRM解决方案自定义事件，DRM解决方案自定义事件发生时触发。

mediaKeySession.on('vendorDefined', (eventInfo: drm.EventInfo) => {
  console.log('vendorDefined' + 'info:' + eventInfo.info + ' extraInfo:' + eventInfo.extraInfo);
});

• 监听媒体密钥过期更新事件，媒体密钥过期更新时触发。

mediaKeySession.on('expirationUpdate', (eventInfo: drm.EventInfo) => {
  console.log('expirationUpdate' + 'info:' + eventInfo.info + ' extraInfo:' + eventInfo.extraInfo);
});

• 监听密钥变换事件，媒体密钥变换时触发。

mediaKeySession.on('keysChange', (keyInfo : drm.KeysInfo[], newKeyAvailable:boolean) => {
  for(let i = 0; i < keyInfo.length; i++){
    console.log('keysChange' + 'info:' + keyInfo[i].keyId + ' extraInfo:' + keyInfo[i].value);
  }
});

1. 生成媒体密钥请求、设置媒体密钥请求响应。

let initData = new Uint8Array([0x00, 0x00, 0x00, 0x00]);
// 根据DRM解决方案要求设置可选数据的值
let optionalData:drm.OptionsData[] = [{
  name: "...",
  value: "..."
}];
// 以下示例完成在线媒体密钥请求和响应设置
mediaKeySession.generateMediaKeyRequest("video/avc", initData, drm.MediaKeyType.MEDIA_KEY_TYPE_ONLINE, optionalData).then(async (licenseRequest) => {
   console.info("generateMediaKeyRequest success", licenseRequest.mediaKeyRequestType, licenseRequest.data, licenseRequest.defaultURL);
   // 将媒体密钥请求返回的licenseRequest.data通过网络请求发送给DRM服务获取媒体密钥请求响应，设置媒体密钥请求响应
   let licenseResponse = new Uint8Array([0x00, 0x00, 0x00, 0x00]);
   mediaKeySession.processMediaKeyResponse(licenseResponse).then((mediaKeyId: Uint8Array) => {
     console.info("processMediaKeyResponse success");
   }).catch((err:BusinessError) =>{
     console.info("processMediaKeyResponse err end", err.code);
  });
}).catch((err:BusinessError) =>{
  console.info("generateMediaKeyRequest err end", err.code);
});
// 以下示例完成离线媒体密钥请求和响应设置
let offlineMediaKeyId = new Uint8Array([0x00, 0x00, 0x00, 0x00]);
mediaKeySession.generateMediaKeyRequest("video/avc", initData, drm.MediaKeyType.MEDIA_KEY_TYPE_OFFLINE, optionalData).then((licenseRequest: drm.MediaKeyRequest) => {
   console.info("generateMediaKeyRequest success", licenseRequest.mediaKeyRequestType, licenseRequest.data, licenseRequest.defaultURL);
   // 将媒体密钥请求返回的licenseRequest.data通过网络请求发送给DRM服务获取媒体密钥请求响应，设置媒体密钥请求响应
   let licenseResponse = new Uint8Array([0x00, 0x00, 0x00, 0x00]);
   mediaKeySession.processMediaKeyResponse(licenseResponse).then((mediaKeyId: Uint8Array) => {
 offlineMediaKeyId = mediaKeyId;
     console.info("processMediaKeyResponse success");
   }).catch((err:BusinessError) =>{
     console.info("processMediaKeyResponse err end", err.code);
  });
}).catch((err:BusinessError) =>{
  console.info("generateMediaKeyRequest err end", err.code);
});

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

try {
  let keyvalue: drm.MediaKeyStatus[] = mediaKeySession.checkMediaKeyStatus();
  console.info("checkMediaKeyStatus success", keyvalue[0].value);
} catch (err) {
  let error = err as BusinessError;
  console.error(`checkMediaKeyStatus ERROR: ${error}`);
}

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

mediaKeySession.generateOfflineReleaseRequest(offlineMediaKeyId).then((OfflineReleaseRequest: Uint8Array) => {
  console.info("generateOfflineReleaseRequest success", OfflineReleaseRequest);
  // 将媒体密钥释放请求返回的OfflineReleaseRequest通过网络请求发送给DRM服务获取媒体密钥释放请求响应，设置媒体密钥释放请求响应
  let OfflineReleaseResponse = new Uint8Array([0x00, 0x00, 0x00, 0x00]);
  mediaKeySession.processOfflineReleaseResponse(offlineMediaKeyId, OfflineReleaseResponse).then(() => {
    console.info("processOfflineReleaseResponse success");
  }).catch((err:BusinessError) =>{
    console.info("processOfflineReleaseResponse err end", err.code);
  });
}).catch((err:BusinessError) =>{
  console.info("generateOfflineReleaseRequest err end", err.code);
});

1. （可选）恢复离线媒体密钥。

// 恢复指定媒体密钥信息到当前会话
mediaKeySession.restoreOfflineMediaKeys(offlineMediaKeyId).then(() => {
  console.log("restoreOfflineMediaKeys success.");
}).catch((err: BusinessError) => {
  console.error(`restoreOfflineMediaKeys: ERROR: ${err}`);
});

1. （可选）获取当前会话的安全级别。

try {
  let contentProtectionLevel: drm.ContentProtectionLevel = mediaKeySession.getContentProtectionLevel();
} catch (err) {
  let error = err as BusinessError;
  console.error(`getContentProtectionLevel ERROR: ${error}`);
}

1. （可选）查询是否需要安全解码。

try {
  let status: boolean = mediaKeySession.requireSecureDecoderModule("video/avc");
} catch (err) {
  let error = err as BusinessError;
  console.error(`requireSecureDecoderModule ERROR: ${error}`);
}

1. （可选）删除当前会话的媒体密钥。

try {
   mediaKeySession.clearMediaKeys();
} catch (err) {
  let error = err as BusinessError;
  console.error(`clearMediaKeys ERROR: ${error}`);
}

最后呢

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

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