HTMLMediaElement : mthode captureStream()

Disponibilit limite

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

Vous voulez une meilleure prise en charge pour cette fonctionnalit ? Dites-nous pourquoi.

En savoir plus
Voir la compatibilit complte

La mthode captureStream() de l'interface HTMLMediaElement retourne un objet MediaStream qui diffuse en temps rel l'enregistrement d'un contenu obtenu dans un lment mdia.

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 donnes audio et/ou vido par d'autres mdia traitant du code, ou comme source pour WebRTC.

Dans cet exemple, un gestionnaire d'vnements est tabli de sorte qu'un clic sur un bouton commence capturer le contenu d'un lment mdia avec l'ID "playback" dans un MediaStream. Le flux peut ensuite tre utilis d'autres fins, comme un flux WebRTC pour partager des vidos pr-enregistres avec une autre personne lors d'un appel vido.

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

Voir Enregistrer un lment mdia pour un exemple plus long et plus complexe ainsi qu'une explication dtaille.