HTMLMediaElement: captureStream() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Die captureStream()-Methode des HTMLMediaElement-Interfaces gibt ein MediaStream-Objekt zurück, das einen Echtzeit-Stream der Inhalte erfasst, die im Medienelement gerendert werden.

Dies kann beispielsweise als Quelle für eine WebRTC RTCPeerConnection verwendet werden.

Syntax

captureStream()

Rückgabewert

Ein MediaStream-Objekt, das als Quelle für Audio- und/oder Videodaten von anderem Medienverarbeitungscode verwendet werden kann oder als Quelle für WebRTC.

In diesem Beispiel wird ein Event-Handler eingerichtet, sodass beim Klicken auf einen Button die Inhalte eines Medienelements mit der ID "playback" in einen MediaStream aufgenommen werden. Der Stream kann dann für andere Zwecke genutzt werden, wie z. B. einen WebRTC-Stream, um aufgezeichnete Videos mit einer anderen Person während eines Videoanrufs zu teilen.

document.querySelector(".playAndRecord").addEventListener("click", () => {
  const playbackElement = document.getElementById("playback");
  const captureStream = playbackElement.captureStream();
  playbackElement.play();
});

Siehe Aufzeichnen eines Medienelements für ein längeres und komplizierteres Beispiel und eine Erklärung.