React Native Video 在 Android 平台上的 Seek 精度问题解析

在 React Native 生态中，react-native-video 是一个广泛使用的视频播放组件。近期在 Android 平台上发现了一个关于视频定位(seek)功能的精度问题，这个问题影响了开发者对视频播放的精细控制能力。

问题现象

当开发者尝试使用 seek 方法进行视频定位时，发现该方法只能响应整数秒的定位请求。例如，尝试定位到 0.1 秒或 0.5 秒等非整数时间点时，视频播放器不会做出响应。只有当定位时间为整数秒时（如 1.0 秒、2.0 秒），seek 操作才会生效。

这个问题在以下场景中尤为明显：

1. 加载本地视频源
2. 使用定时器以 0.1 秒为增量连续调用 seek 方法
3. 观察视频播放器的响应情况

技术分析

问题的根源在于 Android 平台的原生代码实现。在 VideoManagerModule.kt 文件中，seek 操作的时间参数被强制转换为整数类型。具体来说，代码使用了 ReactBridgeUtils.safeGetInt 方法来获取时间参数，这导致所有传入的小数值都被截断为整数。

正确的做法应该是使用 ReactBridgeUtils.safeGetDouble 方法来获取时间参数，保留原始的小数精度。然后通过乘以 1000 转换为毫秒并四舍五入，最终传递给播放器的 seekTo 方法。

解决方案

该问题已在 react-native-video 的 6.4.1 版本中得到修复。修复方案包括：

1. 将时间参数的类型从 Int 改为 Double
2. 保留原始时间值的小数部分
3. 正确转换为毫秒单位后传递给播放器

对于仍在使用旧版本的开发者，可以手动应用类似的修复补丁，或者升级到最新版本以获得完整的 seek 精度支持。

开发者建议

对于需要精细控制视频播放进度的应用场景，建议：

1. 确保使用 react-native-video 6.4.1 或更高版本
2. 在 Android 平台上测试 seek 功能的小数精度
3. 对于关键业务场景，考虑添加 fallback 逻辑处理可能的精度问题

视频播放的精确控制在许多应用场景中都很重要，如教育类应用中的视频标注、体育应用中的精彩回放等。理解并解决这类精度问题，有助于提升应用的用户体验。