React Native Video 中 Android 平台播放 DRM 加密 HLS 流的问题分析与解决方案

问题背景

在使用 React Native Video 库播放 DRM 加密的 HLS 流媒体时，Android 平台（包括 Android TV 和移动设备）会出现 CryptoException 错误。具体表现为播放器无法获取解密密钥，导致播放失败。错误日志中显示"Provided content key is not in license"和"Crypto key not available"等关键信息。

错误现象分析

从错误日志中可以观察到几个关键点：

1. DRM 插件初始化正常：Widevine DRM 插件能够成功加载和初始化
2. 会话建立成功：DRM 会话能够正常创建（session_id = sidXX）
3. 密钥请求失败：虽然能够生成密钥请求，但最终返回的许可证中不包含所需的内容密钥
4. 多会话问题：错误发生在尝试使用多个 DRM 会话时

根本原因

经过深入排查，发现问题根源在于 React Native Video 的 Android 实现中未设置 multiSession 参数。在 Android 的 ExoPlayer 中，这个参数控制 DRM 会话的管理方式：

• 当 multiSession 为 false（默认值）时，每个媒体项会创建新的 DRM 会话
• 当 multiSession 为 true 时，允许多个媒体项共享同一个 DRM 会话

对于某些 DRM 加密的 HLS 流，特别是那些使用分段加密的流，必须启用多会话模式才能正确解密所有内容段。

解决方案

React Native Video 库已经通过 PR 添加了对 multiDrm 参数的支持。开发者现在可以通过以下方式启用多会话 DRM：

<Video
  source={{uri: 'your_drm_protected_stream_url'}}
  drm={{
    type: 'widevine',
    licenseServer: 'your_license_server_url',
    multiDrm: true,  // 启用多会话DRM
    headers: {
      // 必要的授权头
    }
  }}
  // 其他属性...
/>

技术实现细节

在 Android 原生代码中，这个功能是通过修改 ReactExoplayerView.java 实现的。关键修改包括：

1. 在构建 MediaItem 时添加 DRM 配置
2. 设置 DrmConfiguration.Builder 的 multiSession 参数
3. 确保 DRM 会话能够被多个媒体段共享

最佳实践建议

1. 测试不同的 DRM 配置：不是所有 DRM 加密内容都需要多会话模式，建议根据实际内容进行测试
2. 监控 DRM 错误：实现完善的错误处理机制，捕获并分析 DRM 相关错误
3. 考虑设备兼容性：不同 Android 设备和版本对 DRM 的支持程度可能不同
4. 性能考量：多会话模式可能会增加内存使用，在低端设备上需注意性能影响

总结

React Native Video 库通过添加 multiDrm 参数支持，解决了 Android 平台播放 DRM 加密 HLS 流时的密钥获取问题。这一改进使得开发者能够更灵活地处理各种 DRM 保护的内容，特别是在需要多个 DRM 会话的场景下。对于遇到类似问题的开发者，建议升级到包含此修复的版本，并按照推荐的配置方式启用多会话 DRM 支持。