BrowserCaptureMediaStreamTrack: cropTo()-Methode

cropTarget

Eine Instanz von CropTarget, die den Bereich des renderten Elements repräsentiert, auf den der Stream beschnitten werden soll, oder null/undefined. In diesem Fall wird ein zuvor festgelegtes Beschneiden vom Track entfernt.

Ein Promise, das zu undefined aufgelöst wird.

Das Promise wird abgelehnt, wenn:

• Der Track kind nicht "video" ist oder dessen readyState nicht "live" ist.
• Das Element des Beschneidungsziels nicht mehr existiert.
• Der zu beschneidende Track nicht von dem Bildschirm des Benutzers erfasst wurde.
• cropTarget keine Instanz von CropTarget ist, oder null/undefined ist.
• cropTarget in einem anderen Tab erstellt wurde, als der, der erfasst wird.

// 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);

// Broadcast cropped stream in <video> element
videoElem.srcObject = stream;

Siehe Verwendung der Element Capture und Region Capture APIs für Beispielcode im Kontext.

Sie können das Beschneiden beenden, indem Sie einen Aufruf von cropTo() auf einen zuvor beschnittenen Track machen und ihm das Argument null übergeben:

// Stop cropping
await track.cropTo(null);

• Screen Capture API
• Verwendung der Element Capture und Region Capture APIs