VideoFrame: copyTo() 方法

destination

一个 ArrayBuffer、TypedArray 或 DataView，将复制到其中。

options 可选

包含以下内容的对象

rect 可选

要从 VideoFrame 中复制的像素矩形。如果未指定，将使用 visibleRect。这采用一个字典对象的格式，包含以下内容：

• x: X 坐标。
• y: Y 坐标。
• width: 帧的宽度。
• height: 帧的高度。

layout 可选

一个列表，包含 VideoFrame 中每个平面的以下值：

offset

一个整数，表示给定平面开始的字节偏移量。

stride

一个整数，表示每个平面行的字节数（包括填充）。平面不得重叠。如果未指定 layout，则平面将紧密排列。

format 可选

destination 中像素数据的像素格式。可以设置为 "RGBA"、"RGBX"、"BGRA"、"BGRX"。如果未指定，将使用 format。

colorSpace 可选

指定 destination 中像素数据的颜色空间。可以设置为 "srgb"（用于 sRGB 颜色空间）或 "display-p3"（用于 display-p3 颜色空间）。仅适用于 RGB 像素格式。如果未指定，将使用 "srgb。

一个 Promise，当复制完成时解析为复制布局。

以下示例复制 videoFrame 的全部内容。

let buffer = new Uint8Array(videoFrame.allocationSize());
let layout = await videoFrame.copyTo(buffer);

以下示例将 videoFrame 的一部分转换为 RGB 格式。

const videoRect = {
  x: 100,
  y: 100,
  width: 80,
  height: 60,
};
const options = {
  rect: videoRect,
  format: "RGBX",
  colorSpace: "display-p3",
};
const size = videoFrame.allocationSize(options);
const buffer = new ArrayBuffer(size);
const layout = await videoFrame.copyTo(buffer, options);