React Native Video 组件在 Android 上的 HEVC 解码问题分析与解决方案

问题背景

在使用 React Native Video 组件（版本 6.10.0）开发 Android 应用时，开发者遇到了一个棘手的视频播放问题。当播放 HEVC（H.265）编码的 4K 分辨率视频时，首次播放正常，但在返回列表页后再次进入详情页播放时，会出现解码失败的错误。

错误现象

系统抛出的错误信息显示为 ERROR_CODE_DECODING_FAILED（错误码 24003），具体原因是 NO_EXCEEDS_CAPABILITIES，表明设备虽然支持 HEVC 解码，但在特定情况下超出了其解码能力范围。

错误堆栈显示问题出在 Android 的 MediaCodec 视频解码器上，特别是 c2.android.hevc.decoder 解码器在处理高分辨率 HEVC 视频时出现了异常状态。

问题分析

1. 首次播放成功但后续失败：这表明不是简单的编解码器不支持问题，而是与资源管理或解码器状态有关。

2. 内存问题交替出现：部分情况下会伴随 OutOfMemoryError，说明视频解码过程中存在内存泄漏或资源未及时释放的问题。

3. 解码器能力限制：虽然设备支持 HEVC 解码，但可能对持续高负载的解码任务（如 4K HEVC）处理能力有限。

根本原因

经过深入分析，问题的核心在于：

1. 解码器资源未正确释放：当用户返回列表页时，视频组件没有完全释放解码器资源，导致再次尝试播放时解码器处于不稳定状态。

2. 高分辨率视频的内存压力：4K HEVC 视频解码需要大量内存，重复播放时如果前一次的资源未释放，容易导致内存不足。

3. Android 媒体框架的限制：某些设备上的 HEVC 解码器实现可能对连续高负载解码任务的处理不够健壮。

解决方案

开发者最终通过以下方法解决了问题：

<Video
  source={{uri: videoUrl}}
  resizeMode="cover"
  onError={(error) => {
    console.log('Video playback error:', error);
    // 处理错误并尝试恢复
  }}
  // 添加 key 强制重新加载组件
  key={`video-${uniqueKey}`}
/>

更优的解决方案建议

1. 手动资源释放：虽然当前版本没有直接暴露 release 方法，但可以通过卸载组件来强制释放资源。

2. 分辨率适配：对于不支持 4K 解码的设备，可以在服务端提供多种分辨率的视频源，根据设备能力选择合适的分辨率。

3. 错误恢复机制：实现健壮的错误处理，在解码失败时尝试降低分辨率或切换编解码器。

4. 内存监控：在播放高分辨率视频时监控内存使用情况，预防性地释放资源。

最佳实践

1. 资源管理：在组件卸载时确保视频播放完全停止，可以通过监听页面生命周期来实现。

2. 渐进式加载：对于高分辨率视频，考虑先加载低分辨率版本，再根据网络和设备能力决定是否加载高清版本。

3. 设备能力检测：在播放前检测设备的解码能力，避免尝试播放超出设备能力的视频格式。

4. 错误边界处理：为视频组件实现完善的错误处理逻辑，包括重试机制和降级方案。

总结

React Native Video 组件在处理高分辨率 HEVC 视频时可能会遇到解码器资源管理问题，特别是在 Android 设备上。通过合理的资源管理和错误处理策略，可以显著提高视频播放的稳定性和用户体验。开发者应当根据目标设备的实际能力设计视频播放策略，并在应用层面实现完善的错误恢复机制。