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

在 React Native 视频播放组件 react-native-video 的 5.2.1 版本中，开发者反馈了一个关于 Android 平台特有的功能性问题。当视频组件设置为循环播放模式时，预期的结束回调函数无法被正常触发。

问题现象

在 Android 平台上使用 react-native-video 5.2.1 版本时，如果开发者设置了 repeat={true} 属性来启用视频循环播放功能，同时配置了 onEnd 回调函数来监听视频播放结束事件，会发现该回调函数完全不会被调用。这个问题在多个 Android 设备和模拟器上都能稳定复现。

技术背景

视频播放器的循环播放功能通常有两种实现方式：

1. 播放器内部实现的循环机制
2. 通过监听结束事件并手动重置播放位置

在 react-native-video 5.2.1 版本中，Android 平台的实现可能存在逻辑缺陷，导致在启用内部循环机制时，播放结束事件被错误地拦截或忽略。

解决方案

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

方案一：手动实现循环播放

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

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

方案二：使用 setNativeProps 强制恢复播放

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

版本建议

需要注意的是，react-native-video 5.2.1 已经是一个较旧的版本，官方团队已不再提供维护支持。建议开发者考虑升级到最新版本，以获得更好的稳定性和功能支持。如果必须继续使用 5.2.1 版本，可以采用上述解决方案来规避这个问题。

技术启示

这个问题提醒我们，在使用第三方组件时：

1. 要特别注意平台差异性
2. 对于关键功能点，需要进行充分的跨平台测试
3. 保持组件版本更新可以避免许多已知问题
4. 当内置功能出现问题时，考虑手动实现可能是更可靠的解决方案

通过这个案例，开发者可以更好地理解 React Native 生态中视频播放组件的实现机制，以及如何处理类似的跨平台兼容性问题。