HTMLMediaElement: seekToNextFrame() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

HTMLMediaElement.seekToNextFrame() 方法会异步地将当前播放位置前进到媒体的下一帧。

警告: 此非标准方法是围绕支持非实时媒体访问而进行的实验性过程的一部分,旨在用于过滤、编辑等任务。您应该在生产代码中使用此方法,因为它的实现可能会在未通知的情况下发生更改,甚至被完全移除。不过,我们鼓励您对其进行实验。

此方法允许您在媒体不实时播放的情况下访问视频媒体的帧。它还允许您使用帧作为查找单位来访问媒体,而不是使用时间码(尽管一次只能查找一帧,直到您找到所需的帧)。此方法可能的用途包括视频内容的过滤和编辑。

此方法会立即返回,并返回一个 Promise,该 Promise 的 fulfilled 处理程序将在查找操作完成后被调用。此外,还会向感兴趣的各方发送一个 seeked 事件,告知它们已发生查找。如果查找失败(因为媒体已到达最后一帧),则会发生一个 seeked 事件,紧接着是一个 ended 事件。

如果媒体元素上没有视频,或者媒体不可查找,则什么也不会发生。

语法

js
seekToNextFrame()

参数

无。

返回值

一个 Promise,在查找操作完成后会被 fulfilled。

规范

不属于任何规范。

浏览器兼容性