BrowserCaptureMediaStreamTrack: restrictTo()-Methode

Syntax

restrictTo(restrictionTarget)

Parameter

restrictionTarget

Eine Instanz von RestrictionTarget, die das Element darstellt, auf das der Stream beschränkt werden soll, oder null/undefined, in diesem Fall wird jede zuvor gesetzte Einschränkung vom Track entfernt.

Rückgabewert

Ein Promise, der sich zu undefined auflöst.

Das Promise wird abgelehnt, wenn:

• Der Track kind nicht "video" ist oder dessen readyState nicht "live" ist.
• Das Einschränkungsziel-Element nicht mehr existiert.
• Der Track, der eingeschränkt wird, kein von dem Bildschirm des Benutzers aufgenommener Track ist.
• restrictionTarget keine Instanz von RestrictionTarget, null oder undefined ist.
• restrictionTarget in einem anderen als dem aufgenommenen Tab erstellt wurde.

Beispiele

Grundlegendes Einschränkungsbeispiel

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

// Create restriction target from DOM element
const demoElem = document.querySelector("#demo");
const restrictionTarget = await RestrictionTarget.fromElement(demoElem);

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

// Restrict video track
await track.restrictTo(restrictionTarget);

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

Siehe Verwendung der Elementaufnahme- und Bereichsaufnahme-APIs für Beispielcode im Kontext.

Beenden der Einschränkung

Sie können die Einschränkung beenden, indem Sie einen Aufruf von restrictTo() auf demselben Track machen und dabei null als Argument übergeben:

// Stop restricting
await track.restrictTo(null);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Screen Capture API
• Verwendung der Elementaufnahme- und Bereichsaufnahme-APIs