VideoEncoder: reset() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 专用 Web Workers 中可用。

VideoEncoder 接口的 reset() 方法同步取消所有待处理的编码和回调,释放所有底层资源,并将 state 设置为 "unconfigured"。调用 reset() 后,必须在恢复 encode() 调用之前调用 configure()

注意:为了避免丢弃通过 encode() 排队的帧,应该在调用 reset() 之前调用并完成 flush()

语法

js
reset()

参数

无。

返回值

无(undefined)。

异常

InvalidStateError DOMException

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

示例

以下示例重置了 VideoEncoder

js
VideoEncoder.reset();

规范

规范
WebCodecs
# dom-videoencoder-reset

浏览器兼容性