RTCEncodedVideoFrame: RTCEncodedVideoFrame() Konstruktor
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Der RTCEncodedVideoFrame() Konstruktor erstellt ein neues und vollständig unabhängiges RTCEncodedVideoFrame Objekt.
Das neue Objekt ist ein tiefes Duplikat der Originalobjektdaten und -metadaten, wobei alle im Optionsparameter angegebenen Metadaten die kopierten Werte überschreiben.
Syntax
new RTCEncodedVideoFrame(originalFrame);
new RTCEncodedVideoFrame(originalFrame, options);
Parameter
originalFrame-
Der zu kopierende Frame.
optionsOptional-
Dies ist ein Objekt mit der folgenden Eigenschaft:
metadataOptional-
Ein Objekt, das die Metadaten des Frames festlegt. Dies ist ein Objekt mit denselben Eigenschaften wie das von
RTCEncodedVideoFrame.getMetadata()zurückgegebene Objekt.
Ausnahmen
TypeError- Der Quellpuffer ist getrennt.
RangeError- Die Zuordnung ist zu groß.
Beispiele
Klonen eines Frames mit geänderten Metadaten
Dieses Snippet zeigt, wie Sie einen Frame kopieren und seine Metadaten ändern können. In diesem Fall aktualisieren wir nur die Aufnahmezeit.
// Frame is an incoming RTCEncodedVideoFrame
frame.getMetadata();
const newFrame = new RTCEncodedVideoFrame(frame, {
metadata: {
captureTime: frame.metadata.captureTime + 3,
},
});
Diese Art der Änderung kann nützlich sein, wenn Sie mehrere ausgehende Frames aus einem einzelnen eingehenden Frame erstellen müssen, beispielsweise um Medien an einen anderen Peer im Netzwerk weiterzuleiten. In der Regel müssen Sie die Metadaten eines Frames nicht ändern.
Spezifikationen
| Specification |
|---|
| WebRTC Encoded Transform # dom-rtcencodedvideoframe-constructor |