BrowserCaptureMediaStreamTrack: clone() 方法

可用性有限

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

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

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

clone() 方法是 BrowserCaptureMediaStreamTrack 接口的一个方法,它返回原始 BrowserCaptureMediaStreamTrack 的一个克隆。

此方法在功能上与 MediaStreamTrack.clone() 相同,不同之处在于它处理了已应用于轨道的裁剪或限制的情况。返回的克隆与原始 BrowserCaptureMediaStreamTrack 相同,但移除了任何裁剪或限制。

注意: 在 Chromium 中,如果一个轨道有克隆,其 cropTo()restrictTo() 方法将拒绝(请参阅 Chrome issue 41482026)。

语法

js
clone()

参数

无。

返回值

一个 BrowserCaptureMediaStreamTrack 实例。

示例

js
// Options for getDisplayMedia()
const displayMediaOptions = {
  preferCurrentTab: true,
};

// Create crop target from DOM element
const demoElem = document.querySelector("#demo");
const cropTarget = await CropTarget.fromElement(demoElem);

// Capture video stream from user's webcam and isolate video track
const stream =
  await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
const [track] = stream.getVideoTracks();

// Crop video track
await track.cropTo(cropTarget);

// Create uncropped clone of the track
const clonedTrack = track.clone();

规范

规范
区域捕获
# dom-browsercapturemediastreamtrack-clone

浏览器兼容性

另见