HTMLMediaElement.captureStream()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Syntaxe

js
var mediaStream = mediaElement.captureStream();

Paramètres

Aucun.

Retours

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.

Exemple

Dans cet exemple, un écouteur d'événement est mise en place, permettant la capture du contenu d'un élément média avec l'ID "playback" dans un MediaStream lors d'un clic sur un bouton de lancement. La flux peut être utilisée dans d'autres buts—comme une source de diffusion via WebRTC, vous permettant de partager des vidéos pré-enregistrées avec une autre personne lors d'un appel video.

js
document.querySelector(".playAndRecord").addEventListener("click", function () {
  var playbackElement = document.getElementById("playback");
  var captureStream = playbackElement.captureStream();
  playbackElement.play();
});

Voir Recording a media element pour des exemples et explications plus détaillées et complexes.

Spécifications

Specification
Media Capture from DOM Elements
# dom-htmlmediaelement-capturestream

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
captureStream

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Requires a vendor prefix or different name for use.

Voir aussi