WebRTCwindow_and_dedicated
The RTCEncodedVideoFrame() constructor creates a new and fully independent RTCEncodedVideoFrame object.
The new object is a deep clone of the original object data and metadata, with any metadata specified in the options parameter overwriting the copied values.
Syntax
new RTCEncodedVideoFrame(originalFrame);
new RTCEncodedVideoFrame(originalFrame, options);
Parameters
originalFrame- : The frame to be copied.
options- : This is an object with the following property:
metadata- : An object setting the frame metadata. This is an object with the same properties as the object returned by RTCEncodedVideoFrame.getMetadata().
- : This is an object with the following property:
Exceptions
- TypeError
- The source buffer is detached.
- RangeError
- The allocation is too large.
Examples
Cloning a frame with modified metadata
This snippet shows how you might copy a frame and modify its metadata. In this case we just update the capture time.
// Frame is an incoming RTCEncodedVideoFrame
frame.getMetadata();
const newFrame = new RTCEncodedVideoFrame(frame, {
metadata: {
captureTime: frame.metadata.captureTime + 3,
},
});
This kind of modification might be useful if you need to create multiple outgoing frames from a single incoming frame; for example, in order to relay media to another peer on the network. Generally you will not need to modify the metadata for a frame.
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
