UD5工具箱
使用教程
第一步：了解 EME 和 DRM 的基本概念
在开始使用工具之前，先了解几个核心概念。DRM（Digital Rights Management，数字版权管理）是保护数字内容版权的技术手段集合，目标是防止未授权的复制、分发和使用。EME（Encrypted Media Extensions）是 W3C 制定的 Web 标准 API，为浏览器播放 DRM 保护的内容提供了标准化的接口。CDM（Content Decryption Module，内容解密模块）是实际执行解密操作的软件组件，由操作系统或浏览器提供，不同 DRM 系统使用不同的 CDM 实现。这三者的关系是：Web 应用通过 EME 标准接口与 CDM 交互，CDM 负责处理 DRM 相关的加密/解密操作。理解这些概念有助于您更好地使用本工具学习 EME 的具体工作流程。
第二步：打开工具并了解界面
在浏览器中访问加密媒体扩展演示的页面地址。推荐使用 Chrome 或 Edge 浏览器，因为这两种浏览器对 EME API 的支持最为完整。页面加载后，您将看到工具的主界面。顶部是 DRM 系统选择栏，可以切换 Widevine、PlayReady 或 FairPlay 三种 DRM 系统的演示。中央是流程可视化区域，以流程图形式展示当前的 EME 工作流程状态。左侧是控制面板，提供各种操作按钮和参数设置。右侧是实时日志面板，记录所有 API 调用和事件。底部是文字说明区域，显示当前步骤的详细解释。工具首次打开时处于"就绪"状态，所有流程节点都是灰色的，等待用户触发流程开始。
第三步：选择 DRM 系统并启动演示
首先在顶部选择栏中点击"Widevine"按钮选择 Widevine DRM 系统作为演示目标。Widevine 是目前使用最广泛的 Web DRM 系统，由 Google 开发并在 Chrome 浏览器和 Android 系统中内置。选择 DRM 系统后，点击"初始化 MediaKeys"按钮开始演示流程。此时，流程图中的"初始化 CDM"节点变为活跃状态（蓝色高亮），实时日志面板记录了 createMediaKeys() API 的调用和返回结果。文字说明区域解释了这一步骤的意义：创建 MediaKeys 对象并绑定到指定的 CDM，为后续的密钥管理做准备。注意观察日志中的参数——CDM 标识符为"com.widevine.alpha"，这是 Widevine 的标准 Key System 名称。
第四步：观察加密数据检测和密钥请求
点击"模拟加密数据检测"按钮，模拟播放器收到加密媒体数据时触发 encrypted 事件的过程。流程图中"检测加密数据"节点变为活跃状态，随后"生成密钥请求"节点自动激活。实时日志展示了 encrypted 事件的详细信息，包括 event.initData（初始化数据，包含 Key System 信息和 Key ID）和 event.initDataType（数据类型，如"cenc"表示通用加密）。文字说明解释了 init.data 的作用：它是 DRM 系统识别加密内容所需的关键信息，通常嵌入在媒体文件的元数据中（如 MP4 文件的 init segment 中的 Protection Scheme Information box）。日志中可以看到构造的 Key System Request 对象，包含许可证服务器 URL 和请求体。
第五步：模拟许可证获取过程
点击"发送许可证请求"按钮，模拟将密钥请求发送到许可证服务器的过程。流程图中"许可证请求"节点变为活跃状态，短暂延迟后（模拟网络传输），"许可证响应"节点激活。实时日志详细记录了请求和响应的内容——请求体中包含了经过 Base64 编码的 initData 和其他 DRM 参数，响应体中包含了经过加密的许可证数据。文字说明区域解释了许可证服务器的角色：许可证服务器根据请求中的身份信息验证用户的权限（如订阅状态、设备合规性等），如果验证通过则生成包含解密密钥的许可证并返回给客户端。工具还展示了如何使用"篡改请求"功能模拟无效请求被服务器拒绝的情况。
第六步：安装密钥并开始解密播放
许可证获取成功后，点击"安装密钥"按钮模拟将许可证中的解密密钥安装到 MediaKeys 中的过程。流程图中"密钥安装"节点激活。实时日志显示了 update() 方法的调用，参数为从许可证服务器获取的许可证数据。安装完成后，点击"开始解密播放"按钮模拟使用安装的密钥解密媒体数据并播放的过程。流程图中"解密播放"节点变为绿色的完成状态，同时工具会播放一段简短的演示视频（使用预置的解密密钥解密的示例内容）。日志中记录了 key 状态的变化（从 key-required 到 key-readable），以及解密操作的性能指标。至此，整个 EME 播放流程演示完成。
第七步：探索不同 DRM 系统的差异
完成 Widevine 的流程演示后，切换到 PlayReady 和 FairPlay DRM 系统，重复上述步骤进行对比观察。注意观察以下差异：Key System 名称不同（PlayReady 为"com.microsoft.playready"，FairPlay 为"com.apple.fps.1_0"或类似格式）；initData 格式不同（Widevine 使用 PSSH box，PlayReady 也使用 PSSH box 但格式有差异，FairPlay 使用 SKD 协议格式）；许可证请求和响应的数据结构不同；安全级别分类不同。通过对比三种 DRM 系统的演示流程，您可以直观理解不同 DRM 系统在接口层面的共性和在实现层面的差异，这对于开发需要跨平台兼容的媒体播放器非常有价值。
第八步：使用高级功能深入学习
在掌握基础流程后，可以尝试以下高级功能。"持久化许可证"模块演示如何将许可证存储到本地以支持离线播放，观察 Persistent License 的获取和恢复流程。"安全级别检测"模块演示如何评估当前环境的安全级别，了解 L1/L2/L3 级别的区别和对内容授权的影响。"错误模拟"模块提供各种错误场景的触发按钮，包括无效 DRM 类型、许可证拒绝、密钥不匹配等，帮助您学习错误处理策略。"代码生成"按钮可以将当前演示的完整流程转换为可运行的 JavaScript 代码，方便在自己的项目中参考使用。通过这些高级功能的探索，您将对 EME 技术有更深入和全面的理解。