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

问题背景

在使用 React-Native-Video 库播放 DRM 加密的 HLS 流(m3u8格式)时，Android 平台(包括 Android TV 和移动设备)会出现播放失败的问题。错误表现为 CryptoException，提示"加密密钥不可用"。这个问题在原生 Media3 示例中可以正常播放，但在 React-Native-Video 中却无法工作。

错误现象分析

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

1. 错误类型：MediaCodec$CryptoException: Crypto key not available
2. DRM 插件日志：显示"Provided content key is not in license"，表明虽然获取了许可证，但内容密钥不在其中
3. 平台差异：相同内容在 Shaka Player 中可以正常播放，说明内容本身没有问题

根本原因

经过深入排查，发现问题根源在于 React-Native-Video 的 Android 实现中缺少了对 setMultiSession(true) 的调用。这个参数对于 Widevine DRM 的工作机制至关重要：

1. 多会话模式：允许为同一内容创建多个 DRM 会话
2. 密钥管理：在多会话模式下，密钥可以跨会话共享
3. HLS 特性：HLS 流通常包含多个媒体段，需要多会话支持才能正确处理

解决方案

React-Native-Video 库已经通过 PR 增加了对多会话 DRM 的支持。开发者可以通过以下方式使用：

<Video
  source={{uri: 'your_hls_stream_url'}}
  drm={{
    type: 'widevine',
    licenseServer: 'your_license_server_url',
    multiDrm: true,  // 新增的多会话支持参数
    headers: {
      // 必要的授权头
    }
  }}
  // 其他属性...
/>

技术实现细节

在 Android 原生层，解决方案涉及修改 ReactExoplayerView.java 文件：

1. DRM 配置构建：在创建 DRM 配置时显式设置多会话标志
2. 兼容性考虑：保持向后兼容，默认不启用多会话模式
3. 性能优化：多会话模式虽然会增加少量内存开销，但显著提高了 DRM 内容的播放稳定性

最佳实践建议

1. 测试策略：在支持 DRM 的内容时，应在多种 Android 设备和版本上进行测试
2. 错误处理：实现完善的错误监听和恢复机制，特别是针对 DRM 相关错误
3. 性能监控：监控多会话模式下的内存使用情况，确保应用稳定性
4. 备选方案：考虑实现降级策略，当 DRM 播放失败时切换到其他方案

总结

React-Native-Video 对 Android 平台 DRM 加密 HLS 流的支持通过引入多会话模式得到了显著改善。这一改进解决了长期存在的密钥不可用问题，为开发者提供了更可靠的 DRM 内容播放能力。开发者现在可以通过简单的配置即可实现对 DRM 加密内容的稳定播放，大大提升了 React Native 在媒体播放领域的能力。