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

瀏覽器相容性

另見