React Native Video 5.2.1 版本在 Android 上的重复播放回调问题解析

在 React Native 视频播放组件 react-native-video 的 5.2.1 版本中，Android 平台存在一个值得开发者注意的技术问题：当设置 repeat={true} 属性时，onEnd 回调函数不会被触发。这个问题会影响那些需要监听视频播放结束事件并执行特定逻辑的应用场景。

问题现象

当开发者在 Android 平台上使用以下代码时：

<Video
  source={{ uri: '视频地址' }}
  repeat={true}
  onEnd={() => console.log('视频播放结束')}
/>

按照预期，每次视频播放结束时都应该触发 onEnd 回调函数。然而在实际运行中，当 repeat 属性设置为 true 时，onEnd 回调完全不会被调用。

技术背景

在视频播放组件的实现中，repeat 属性和 onEnd 回调通常有以下关系：

1. repeat={false}（默认值）：视频播放到结尾时会停止，并触发 onEnd 回调
2. repeat={true}：视频播放到结尾时会自动重新开始播放

在理想情况下，无论 repeat 属性如何设置，当视频播放到结尾时都应该触发 onEnd 回调，然后再根据 repeat 的值决定是否重新播放。然而在 5.2.1 版本的实现中，Android 平台似乎将 repeat 和 onEnd 的逻辑耦合在了一起，导致当启用重复播放时完全跳过了回调触发。

解决方案

对于仍在使用 5.2.1 版本的开发者，可以考虑以下两种解决方案：

方案一：手动实现重复播放逻辑

const handleVideoEnd = () => {
  console.log('视频播放结束');
  videoRef.current.seek(0); // 回到视频开头
  videoRef.current.play();  // 重新开始播放
};

<Video
  ref={videoRef}
  source={{ uri: '视频地址' }}
  repeat={false} // 禁用内置的重复播放
  onEnd={handleVideoEnd}
/>

这种方法完全由开发者控制重复播放的逻辑，确保 onEnd 回调能够正常触发。

方案二：使用 setNativeProps 强制刷新

const handleVideoEnd = () => {
  console.log('视频播放结束');
  videoRef.current.setNativeProps({ paused: false });
};

<Video
  ref={videoRef}
  source={{ uri: '视频地址' }}
  repeat={true}
  onEnd={handleVideoEnd}
/>

这种方法利用了 React Native 的底层 API 来强制视频组件继续播放，可能在某些情况下更高效。

版本建议

值得注意的是，react-native-video 5.2.1 已经是一个较旧的版本，官方不再提供支持。建议开发者考虑升级到最新版本，因为：

1. 新版本可能已经修复了这个问题
2. 可以获得更好的性能和更多功能
3. 能够获得官方的维护支持

如果升级过程中遇到困难，可以考虑寻求专业的技术支持服务。

总结

视频播放是移动应用中的常见需求，而播放结束回调则是实现复杂交互逻辑的关键。当遇到类似问题时，开发者可以：

1. 首先确认问题是否特定于某个平台或版本
2. 考虑使用替代方案实现相同功能
3. 评估升级到新版本的成本和收益
4. 在必要时寻求社区或专业支持

通过理解底层原理和灵活应用解决方案，开发者可以克服这类技术限制，实现流畅的视频播放体验。