setStartTime method

Future<void> setStartTime(
  1. double seconds
)

设置本次起播的初始定位（秒）。必须在 play 之前调用。

与 seek 的区别：seek 是"起播后再跳"，用户会先看到第 0 秒的画面、约 0.2s 后才跳走，续播每次都能看到这一下闪跳；本方法让原生在 readyToPlay 时先 seek 到位、seek 完成后才 play，用户看不到视频开头画面。

契约：

  • 每次 play 前都要调。原生侧该值在被消费后会自动清零，但切集/换源不会清， 不调的话上一次的残留可能泄漏到下一次播放——没有续播需求时显式传 0。
  • 目前仅 iOS 生效。Android 尚未实现该方法（会走 notImplemented）， 这里已做平台判断，非 iOS 上是 no-op，调用方不必自己判断平台。

Implementation

Future<void> setStartTime(double seconds) {
  if (defaultTargetPlatform != TargetPlatform.iOS) {
    return Future<void>.value();
  }
  return _invoke('setStartTime', {'time': seconds});
}