| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/API/Screen_Capture_API | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
L'API Screen Capture ajoute aux API Media Capture et Streams la possibilit de laisser l'utilisatrice ou l'utilisateur slectionner l'cran ou une partie de celui-ci (comme une fentre) pour obtenir un flux mdia. Ce flux peut ensuite tre enregistr ou partag sur le rseau.
L'API Screen Capture est relativement simple utiliser. Sa seule mthode est MediaDevices.getDisplayMedia() dont le but est de demander l'utilisateur un cran ou une portion d'cran capturer sous la forme de MediaStream.
Pour commencer capturer une vido de l'cran, il faut appeler getDisplayMedia() dans une instance de navigator.mediaDevices
captureStream =
await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
La promesse retourne par getDisplayMedia() est rsolue en un objet MediaStream qui diffuse le mdia captur.
Voir l'article Utiliser l'API Screen Capture pour plus de dtails sur l'utilisation de l'API pour capturer le contenu de l'cran sous forme de flux.
L'API Screen Capture n'a pas sa propre interface. Cependant, elle ajoute une mthode l'existante interface MediaDevices .
MediaDevices.getDisplayMedia()La mthode getDisplayMedia() est ajoute l'interface MediaDevices. Similaire getUserMedia(), cette mthode renvoie une promise est rsolue en un, objet MediaStream contenant la zone d'affichage slectionne par la personne, dans un format qui correspond aux options spcifies.
L'API Screen Capture ajoute des proprits au dictionnaire suivant dfinit par d'autres spcificits.
MediaTrackConstraints.cursorUn ConstrainDOMString indiquant si le curseur doit ou non tre inclus dans le flux de la surface d'affichage capture, et s'il doit toujours tre visible ou s'il ne doit l'tre que lorsque la souris est en mouvement.
MediaTrackConstraints.displaySurfaceUn ConstrainDOMString indiquant quel type de surface d'affichage doit tre captur. La valeur peut tre application, browser, monitor, ou window.
MediaTrackConstraints.logicalSurfaceIndique si la vido dans le flux reprsente ou non une surface d'affichage logique (c'est--dire une surface qui peut ne pas tre entirement visible l'cran ou peut-tre compltement hors cran). La valeur true indique qu'une surface d'affichage logique doit tre capture.
MediaTrackSettings.cursorUne chane de caractres indiquant si la surface d'affichage en cours de capture comprend ou non le curseur de la souris et, dans l'affirmative, si elle est visible uniquement lorsque la souris est en mouvement ou si elle est toujours visible. La valeur peut tre always, motion, ou never.
MediaTrackSettings.displaySurfaceUne chane indiquant le type de surface d'affichage en cours de capture. La valeur peut tre application, browser, monitor, ou window.
MediaTrackSettings.logicalSurfaceValeur boolenne valant true si la vido en cours de capture ne correspond pas directement une seule zone d'affichage l'cran.
MediaTrackSupportedConstraints.cursorValeur boolenne valant true si l'environnement actuel supporte la contrainte MediaTrackConstraints.cursor.
MediaTrackSupportedConstraints.displaySurfaceValeur boolenne valant true si l'environnement actuel supporte la contrainte MediaTrackConstraints.displaySurface.
MediaTrackSupportedConstraints.logicalSurfaceValeur boolenne valant true si l'environnement actuel supporte la contrainte MediaTrackConstraints.logicalSurface.
Le dictionnaire suivant est difinit par l'API Screen Capture.
CursorCaptureConstraintUn type de chane numr utilis pour fournir la valeur de la proprit cursor aux paramtres et aux contraintes. La valeur peut tre always, motion, ou never.
DisplayCaptureSurfaceTypeUn type de chane numr utilis pour identifier le type de surface d'affichage capturer. ce type est utilis pour la proprit displaySurface dans les objets contraints et paramtres, et a plusieurs valeurs possibles application, browser, monitor, and window.
Les agents utilisateurs qui prennent en charge les politiques de fonctionnalits (feature policy) (soit en utilisant l'en-tte HTTP Feature-Policy ou l'attribut allow de l'lment <iframe> peuvent indiquer le souhait d'utiliser l'API Screen Capture via la directive display-capture :
<iframe allow="display-capture" src="/some-other-document.html"></iframe>
La liste d'autorisations par dfaut est self, ce qui permet tout contenu du document d'utiliser Screen Capture.
Voir Utiliser Feature Policy pour une explication plus en dtail sur comment est utilis Feature Policy.
| Spcification |
|---|
| Screen Capture |
| Element Capture |
| Region Capture |
| Captured Surface Control |
Cette page a t modifie le 7 sept. 2025 par les contributeurices du MDN.
MediaTrackConstraints.displaySurfaceMediaTrackConstraints.logicalSurfaceMediaTrackConstraints.suppressLocalAudioPlaybackMediaTrackSettings.cursorMediaTrackSettings.displaySurfaceMediaTrackSettings.logicalSurfaceMediaTrackSettings.suppressLocalAudioPlaybackMediaTrackSupportedConstraints.displaySurfaceMediaTrackSupportedConstraints.logicalSurfaceMediaTrackSupportedConstraints.suppressLocalAudioPlaybackCertaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |