React Native Video 组件在 Android 上的视频加载问题分析与解决方案

问题现象

在 React Native 项目中，使用 react-native-video 组件播放本地视频文件时，开发者遇到了一个奇怪的问题：当切换视频源时，某些视频文件无法正常加载。具体表现为：

1. 首次加载视频 A 时一切正常，所有回调事件（onLoad、onReadyForDisplay 等）都能正确触发
2. 当切换到视频 B 时，视频无法播放，isBuffering 状态一直为 true，且关键回调事件（onLoad、onReadyForDisplay）不会被触发
3. 如果直接以视频 B 作为初始源，则能正常播放
4. 该问题仅在真实设备（如 Pixel 6）上出现，模拟器中表现正常

技术分析

这个问题实际上与 Android 平台底层媒体播放框架（Media3）的一个已知 bug 有关。当视频播放器已经加载过一个视频源后，再切换到新的视频源时，如果 startPosition 参数为 0 或 null，Media3 会出现无限缓冲的问题。

从技术实现层面来看，react-native-video 在 Android 平台使用了 ExoPlayer（基于 Media3）作为底层播放器。当播放器状态管理出现问题时，会导致无法正确初始化新的媒体源，从而卡在缓冲状态。

解决方案

目前有两种可行的解决方案：

临时解决方案

在 Android 平台上，为视频源设置一个大于 0 的整数 startPosition 值（如 1）。这样可以绕过 Media3 的 bug，避免无限缓冲的情况。

<Video
  source={{uri: videoUri}}
  startPosition={1}  // 关键修复
  // 其他属性...
/>

长期解决方案

等待 react-native-video 官方修复这个问题。根据项目维护者的反馈，这个问题已经在 PR #3784 中尝试修复，但似乎仍未完全解决。开发者可以关注项目的更新情况，在未来的版本中可能会包含更完善的修复方案。

最佳实践建议

1. 对于需要频繁切换视频源的场景，建议在 Android 平台上始终设置 startPosition=1
2. 在视频切换时，可以考虑先暂停当前播放，再加载新的源
3. 实现完善的错误处理机制，当检测到视频长时间处于缓冲状态时，可以尝试重新加载或提示用户
4. 对于关键业务场景，建议在多种设备上进行充分测试

总结

这个问题的本质是底层媒体框架的兼容性问题，通过设置 startPosition 参数可以有效规避。React Native 开发者在处理多媒体播放时，需要特别注意平台差异性，并在真实设备上进行充分测试。随着 react-native-video 项目的持续更新，这类平台相关的问题有望得到更完善的解决。