HTMLMediaElement: seekToNextFrame() 方法

已弃用: 此功能不再推荐。尽管一些浏览器可能仍然支持它,但它可能已经被从相关的 Web 标准中删除,或者正在被删除,或者可能只是为了兼容性而保留。避免使用它,并尽可能更新现有代码;请参见本页面底部的兼容性表 来指导您的决定。请注意,此功能可能随时停止工作。

非标准: 此功能是非标准的,而且不在标准化轨道上。不要在面向 Web 的生产网站上使用它:它不会对所有用户起作用。实现之间也可能存在较大的不兼容性,并且行为在未来可能会发生变化。

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

警告: 此非标准方法是围绕支持非实时访问媒体以执行过滤、编辑等任务的实验过程的一部分。您不应该在生产代码中使用此方法,因为它的实现可能会在没有通知的情况下发生变化——或者直接被删除。但是,您可以尝试使用它。

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

此方法会立即返回,返回一个Promise,其完成处理程序在跳转操作完成后被调用。此外,一个seeked 事件会被发送出去,让感兴趣的方知道已执行了跳转。如果跳转失败,因为媒体已经处于最后一帧,则会发生一个seeked 事件,紧随其后立即发生一个ended 事件。

如果没有视频在媒体元素上,或者媒体不可跳转,则不会发生任何操作。

语法

js
seekToNextFrame()

参数

无。

返回值

一个Promise,在跳转操作完成后完成。

规范

不属于任何规范。

浏览器兼容性

BCD 表格仅在浏览器中加载