VideoEncoder:reset() 方法

有限可用性

此功能不是基线功能,因为它在一些最广泛使用的浏览器中无法正常工作。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,并且仅在某些或所有支持的浏览器中可用。

注意:此功能在专用 Web 工作线程中可用。

reset() 方法是 VideoEncoder 接口的方法,它会同步取消所有挂起的编码和回调,释放所有底层资源,并将 state 设置为“unconfigured”。在调用 reset() 后,必须先调用 configure(),然后才能恢复 encode() 调用。

注意:为了避免丢弃通过 encode() 排队的帧,应先调用 flush() 并完成,然后再调用 reset()

语法

js
reset()

参数

无。

返回值

无(undefined)。

异常

InvalidStateError DOMException

如果 state"closed",则抛出此异常。

示例

以下示例重置了 VideoEncoder

js
VideoEncoder.reset();

规范

规范
WebCodecs
# dom-videoencoder-reset

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。