1# DRM Kit 简介 2 3DRM Kit（Digital Rights Management Kit，数字版权保护服务）提供了DRM加密节目授权解密的功能，包括DRM插件管理、DRM证书管理、DRM许可证管理、DRM节目授权、DRM节目解密等功能，可实现DRM解决方案的集成、DRM解决方案的证书下载、节目的授权及解密。 4 5## 能力范围 6 7通过DRM Kit，DRM解决方案集成方可以完成DRM解决方案的集成，应用开发者可以通过调用对应的DRM解决方案，实现DRM加密节目授权解密的功能，实现DRM节目的播放。 8 9- DRM插件管理: 通过实现DRM Kit提供的DRM HDI接口，实现对不同的DRM解决方案的支持，一般由DRM解决方案集成方实现。 10 11- DRM证书管理：支持DRM解决方案的设备证书的请求、处理，实现对应DRM解决方案的证书下载（Provision）功能。 12 13- DRM许可证管理：支持离线许可证的请求、处理及删除等。 14 15- DRM节目授权：支持在线许可证请求及处理、离线许可证的加载、媒体密钥状态查询，并支持按照DRM许可证的权限要求对DRM节目授权。 16 17- DRM节目解密：支持的媒体协议：HLS、DASH；封装格式：MP4、TS；视频编码格式：H264<!--RP2--><!--RP2End-->；音频编码格式：AAC。 18 19> **注意：** 20> 21> DRM证书管理、DRM许可证管理、DRM节目授权、DRM节目解密依赖对应的DRM解决方案的实现。应用开发者可以自行扩展支持的媒体协议、封装格式、视音频编码格式。 22 23 24## 亮点/特征 25 26- **支持许可证及解密会话管理** 27 28 支持多MediaKeySession会话，并支持在会话中申请和设置许可证，将解密会话与许可证绑定。 29 30- **支持安全视频通路** 31 32 支持安全视频通路，实现安全解密、安全解码、安全渲染、安全输出等。DRM Kit仅提供安全解密接口的调用以实现安全解密，安全解密、安全解码、安全渲染、安全输出等依赖DRM解决方案及操作系统的实现。 33 34## 基础概念 35 36在开发前，需要先了解以下基础概念： 37 38- DRM插件（DRM Plugin） 39 40 集成于系统中，实现DRM HDI层接口的DRM解决方案驱动，实现DRM相关功能。 41 42<!--RP1--><!--RP1End--> 43 44- MediaKeySystem 45 46 MediaKeySystem用于DRM证书管理及MediaKeySession管理。 47 48- MediaKeySession 49 50 MediaKeySession用于许可证管理及媒体节目解密，生命周期由MediaKeySystem管理。 51 52- DRM信息（MediaKeySystemInfo） 53 54 DRM节目加密的描述信息，包括DRM解决方案UUID及pssh数据等。 55 56- pssh （Protection System Specific Header Box，内容保护系统专有头） 57 58 DRM解决方案用于描述DRM节目如何加密的数据。 59 60- DRM证书（DRM Certificate） 61 62 DRM解决方案需要DRM证书才能正常工作，不同的DRM解决方案有不同的DRM证书。 63 64- DRM证书下载（Provision） 65 66 DRM解决方案采用DRM证书下载流程下载证书，不同DRM解决方案的证书下载流程不一样。如需要下载DRM证书，请参考DRM解决方案的实现要求。 67 68- 许可证（License） 69 70 DRM解决方案使用许可证实现对设备的DRM授权，一般许可证支持的权限控制策略有安全级别、输出控制、起始播放时间、结束播放时间等，不同的DRM解决方案采用的DRM许可证的格式不一样，支持的权限控制策略也不同。 71 72- 视音频数据帧加密信息（cencinfo） 73 74 视音频数据帧加密的描述信息，包括加密算法及模式、KeyId、IV、subsample信息等。 75 76## 工作流程 77 78DRM插件管理功能一般由DRM解决方案集成方实现<!--Del-->，具体可参考[DRM解决方案开发指导](drm-solution-dev-guide.md)<!--DelEnd-->。 79 80应用集成DRM Kit工作流程如图所示。 81 82 83工作流程主要包括： 84 851. 创建MediaKeySystem及MediaKeySession实例：应用获取节目的DRM信息，根据DRM信息中的解决方案UUID类型创建MediaKeySystem及MediaKeySession。应用可以通过业务提供的DRM描述得到节目的DRM信息，也可以根据Media Kit或AVCodec Kit抛出的mediaKeySystemInfoUpdate事件或MediaKeySystemInfo回调得到节目的DRM信息。 86 872. 证书下载：在创建MediaKeySession时，如无DRM证书或DRM证书异常，DRM Kit将抛出需下载DRM证书的事件（keySystemRequired），此时可以调用MediaKeySystem的证书下载相关接口完成证书下载。也可以根据DRM解决方案实现的要求，检查DRM证书状态，如无DRM证书或DRM证书异常，也可主动调用MediaKeySystem的证书下载相关接口完成证书下载。如DRM解决方案的证书正常或DRM解决方案无需应用下载证书，则跳过此步骤。 88 893. 许可证获取：应用根据DRM事件中的pssh数据调用MediaKeySession的许可证相关接口完成DRM许可证的请求、处理。 90 914. DRM节目解密：应用将MediaKeySession设置到Media Kit或AVCodec Kit，用于支持DRM节目解密。采用AVCodec Kit时，可以设置视音频数据帧的cencinfo，并设置到AVBuffer中，在调用PushInputBuffer的时候实现视音频数据帧的解密、解码。 92 935. 许可证更新或过期：在节目播放过程中，在许可证需要更新的情况下，MediaKeySession将抛出许可证更新事件（keyRequired），此时需要重新请求DRM许可证。MediaKeySession如抛出许可证过期事件（keyExpired），则需要停止DRM节目播放。
