VideoEncoder: reset()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Die reset()-Methode des VideoEncoder-Interfaces storniert synchron alle anstehenden Codierungen und Rückrufe, gibt alle zugrundeliegenden Ressourcen frei und setzt den state auf "unconfigured". Nach dem Aufruf von reset() muss configure() aufgerufen werden, bevor Sie mit den Aufrufen von encode() fortfahren können.

Hinweis: Um zu vermeiden, dass über encode() in die Warteschlange gestellte Frames verworfen werden, sollte flush() aufgerufen und abgeschlossen werden, bevor reset() aufgerufen wird.

Syntax

js
reset()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn der state "closed" ist.

Beispiele

Das folgende Beispiel setzt den VideoEncoder zurück.

js
VideoEncoder.reset();

Spezifikationen

Specification
WebCodecs
# dom-videoencoder-reset

Browser-Kompatibilität

BCD tables only load in the browser