React Native Video 项目中 contentStartTime 属性的正确使用方式

问题背景

在 React Native Video 项目（版本 6.4.3）中，开发者在使用 contentStartTime 属性时遇到了应用崩溃的问题。这个问题主要出现在 Android 平台（包括 Android 14 模拟器），表现为设置该属性后应用会在触发 onLoad 事件前崩溃，尽管 onProgress 事件仍能正常触发。

问题分析

经过深入调查，发现 contentStartTime 属性实际上是一个特殊用途的属性，主要用于 DASH 流媒体格式的场景。它不是设计用来控制普通视频播放的起始位置的，因此在非 DASH 格式的视频中使用会导致应用不稳定甚至崩溃。

正确的解决方案

对于大多数开发者想要实现的"从指定位置开始播放视频"的需求，应该使用 source 对象中的 startPosition 属性，而不是 contentStartTime。这是一个更安全、更通用的解决方案。

<Video
  source={{
    uri: 'your_video_url',
    startPosition: 10 // 从第10秒开始播放
  }}
  // 其他属性...
/>

典型应用场景

一个常见的应用场景是处理带有过期时间的视频 URL（如 AWS S3 的签名 URL）。当 URL 过期后，开发者需要：

1. 获取新的有效 URL
2. 从用户之前观看的位置继续播放
3. 避免视频从开头闪一下再跳转的体验问题

这种情况下，使用 source.startPosition 是最佳实践，它能确保视频直接从指定位置开始播放，提供更流畅的用户体验。

最佳实践建议

1. 对于普通视频播放控制，始终优先使用 source.startPosition
2. 仅在明确需要处理 DASH 流媒体格式时才考虑使用 contentStartTime
3. 注意文档中没有明确说明 contentStartTime 的局限性，这是一个需要注意的潜在陷阱
4. 在实现视频续播功能时，结合本地存储记录用户观看进度是个好习惯

总结

React Native Video 库提供了多种控制播放位置的选项，但需要根据具体场景选择合适的方法。通过这次问题的解决，我们了解到 contentStartTime 和 startPosition 的区别及各自的适用场景，这有助于开发者构建更稳定、用户体验更好的视频播放功能。