React Native Video 组件在 Android 平台上的重复播放回调问题解析

问题背景

在 React Native 开发中，react-native-video 是一个广泛使用的视频播放组件。近期有开发者反馈，在使用 5.2.1 版本时，Android 平台上出现了一个关于视频结束回调的异常行为：当设置 repeat={true} 属性时，onEnd 回调函数不会被触发。

问题现象

开发者在使用 react-native-video 5.2.1 版本时发现：

• 在 Android 设备上（包括真机和模拟器）
• 当视频组件设置了 repeat={true} 属性
• 视频播放结束后，预期的 onEnd 回调没有被执行

技术分析

预期行为

正常情况下，视频播放组件应当：

1. 播放视频到结尾
2. 触发 onEnd 回调
3. 如果设置了 repeat={true}，则自动重新开始播放

实际行为

在 Android 平台上，当 repeat={true} 时：

• 视频能够正常循环播放
• 但 onEnd 回调完全不被触发
• 这导致依赖此回调的业务逻辑无法执行

解决方案建议

临时解决方案

对于仍在使用 5.2.1 版本的开发者，可以采用以下变通方案：

1. 手动实现循环播放： 移除 repeat={true} 属性，改为在 onEnd 回调中手动重置播放位置

2. 强制刷新播放状态： 通过 ref 直接操作原生组件，强制重新开始播放

长期建议

由于 5.2.1 版本已不再维护，建议开发者：

1. 升级到最新版本
2. 在新版本中验证问题是否已修复
3. 如问题仍然存在，向维护团队提交详细的问题报告

技术实现细节

对于需要手动实现循环播放的场景，可以考虑以下实现方式：

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

// 在组件中使用
<Video
  ref={videoRef}
  source={{ uri: 'video-url' }}
  onEnd={handleVideoEnd}
  // 注意不再使用 repeat={true}
/>

总结

react-native-video 5.2.1 版本在 Android 平台上确实存在 repeat 属性与 onEnd 回调的兼容性问题。开发者需要根据项目实际情况选择临时解决方案或升级到维护中的新版本。理解这类问题的本质有助于开发者在遇到类似组件行为异常时，能够更快地定位问题并找到合适的解决方案。