# DRM Kit 简介

DRM Kit（Digital Rights Management Kit，数字版权保护服务）提供了DRM加密节目授权解密的功能，包括DRM插件管理、DRM证书管理、DRM许可证管理、DRM节目授权、DRM节目解密等功能，可实现DRM解决方案的集成、DRM解决方案的证书下载、节目的授权及解密。  

#### 能力范围

通过DRM Kit，DRM解决方案集成方可以完成DRM解决方案的集成，应用开发者可以通过调用对应的DRM解决方案，实现DRM加密节目授权解密的功能，实现DRM节目的播放。

* DRM插件管理：通过实现DRM Kit提供的DRM HDI接口，实现对不同的DRM解决方案的支持，一般由DRM解决方案集成方实现。

* DRM证书管理：支持DRM解决方案的设备证书的请求、处理，实现对应DRM解决方案的证书下载（Provision）功能。

* DRM许可证管理：支持离线许可证的请求、处理及删除等。

* DRM节目授权：支持在线许可证请求及处理、离线许可证的加载、媒体密钥状态查询，并支持按照DRM许可证的权限要求对DRM节目授权。

* DRM节目解密：支持的媒体协议：HLS、DASH；封装格式：MP4、TS；视频编码格式：H264、H265；音频编码格式：AAC。

![](https://media:201786965558287119)  
DRM证书管理、DRM许可证管理、DRM节目授权、DRM节目解密依赖对应的DRM解决方案的实现。应用开发者可以自行扩展支持的媒体协议、封装格式、视音频编码格式。  

#### 亮点/特征

* 支持许可证及解密会话管理

  支持多MediaKeySession会话，并支持在会话中申请和设置许可证，将解密会话与许可证绑定。
* 支持安全视频通路

支持安全视频通路，实现安全解密、安全解码、安全渲染、安全输出等。DRM Kit仅提供安全解密接口的调用以实现安全解密，安全解密、安全解码、安全渲染、安全输出等依赖DRM解决方案及操作系统的实现。  

#### 基础概念

在开发前，需要先了解以下基础概念：

* DRM插件（DRM Plugin）

  集成于系统中，实现DRM HDI层接口的DRM解决方案驱动，实现DRM相关功能。
* DRM解决方案

  文中将会使用com.wiseplay.drm作为样例。com.wiseplay.drm是DRM解决方案名称，对应的DRM解决方案 UUID为"3d5e6d359b9a41e8b843dd3c6e72c42c"。
* MediaKeySystem

  MediaKeySystem用于DRM证书管理及MediaKeySession管理。
* MediaKeySession

  MediaKeySession用于许可证管理及媒体节目解密，生命周期由MediaKeySystem管理。
* DRM信息（MediaKeySystemInfo）

  DRM节目加密的描述信息，包括DRM解决方案UUID及pssh数据等。
* pssh （Protection System Specific Header Box，内容保护系统专有头）

  DRM解决方案用于描述DRM节目如何加密的数据。
* DRM证书（DRM Certificate）

  DRM解决方案需要DRM证书才能正常工作，不同的DRM解决方案有不同的DRM证书。
* DRM证书下载（Provision）

  DRM解决方案采用DRM证书下载流程下载证书，不同DRM解决方案的证书下载流程不一样。如需要下载DRM证书，请参考DRM解决方案的实现要求。
* 许可证（License）

  DRM解决方案使用许可证实现对设备的DRM授权，一般许可证支持的权限控制策略有安全级别、输出控制、起始播放时间、结束播放时间等，不同的DRM解决方案采用的DRM许可证的格式不一样，支持的权限控制策略也不同。
* 视音频数据帧加密信息（cencinfo）

视音频数据帧加密的描述信息，包括加密算法及模式、KeyId、IV、subsample信息等。  

#### 工作流程

DRM插件管理功能一般由DRM解决方案集成方实现。

应用集成DRM Kit工作流程如图所示。

![](https://media:201786965558342120)

工作流程主要包括：

1. 创建MediaKeySystem及MediaKeySession实例：应用获取节目的DRM信息，根据DRM信息中的解决方案UUID类型创建MediaKeySystem及MediaKeySession。应用可以通过业务提供的DRM描述得到节目的DRM信息，也可以根据Media Kit或AVCodec Kit抛出的mediaKeySystemInfoUpdate事件或MediaKeySystemInfo回调得到节目的DRM信息。

2. 证书下载：在创建MediaKeySession时，如无DRM证书或DRM证书异常，DRM Kit将抛出需下载DRM证书的事件（keySystemRequired），此时可以调用MediaKeySystem的证书下载相关接口完成证书下载。也可以根据DRM解决方案实现的要求，检查DRM证书状态，如无DRM证书或DRM证书异常，也可主动调用MediaKeySystem的证书下载相关接口完成证书下载。如DRM解决方案的证书正常或DRM解决方案无需应用下载证书，则跳过此步骤。

3. 许可证获取：应用根据DRM事件中的pssh数据调用MediaKeySession的许可证相关接口完成DRM许可证的请求、处理。

4. DRM节目解密：应用将MediaKeySession设置到Media Kit或AVCodec Kit，用于支持DRM节目解密。采用AVCodec Kit时，可以设置视音频数据帧的cencinfo，并设置到AVBuffer中，在调用PushInputBuffer的时候实现视音频数据帧的解密、解码。

5. 许可证更新或过期：在节目播放过程中，在许可证需要更新的情况下，MediaKeySession将抛出许可证更新事件（keyRequired），此时需要重新请求DRM许可证。MediaKeySession如抛出许可证过期事件（keyExpired），则需要停止DRM节目播放。

#### 模拟器支持情况

本Kit暂不支持模拟器。