HTMLMediaElement : méthode captureStream()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La méthode captureStream() de l'interface HTMLMediaElement retourne un objet MediaStream qui diffuse en temps réel l'enregistrement d'un contenu obtenu dans un élément média.

Cela peut être utilisé, par exemple, comme source pour une RTCPeerConnection dans WebRTC.

Syntaxe

captureStream()

Valeur de retour

Un objet MediaStream pouvant être utilisé en tant que source pour des données audio et/ou vidéo par d'autres média traitant du code, ou comme source pour WebRTC.

Dans cet exemple, un gestionnaire d'évènements est établi de sorte qu'un clic sur un bouton commence à capturer le contenu d'un élément média avec l'ID "playback" dans un MediaStream. Le flux peut ensuite être utilisé à d'autres fins, comme un flux WebRTC pour partager des vidéos pré-enregistrées avec une autre personne lors d'un appel vidéo.

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

Voir Enregistrer un élément média pour un exemple plus long et plus complexe ainsi qu'une explication détaillée.