From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove 
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 .../web/api/mediadevices/getusermedia/index.html   | 80 +++++++++++-----------
 files/fr/web/api/mediadevices/index.html           |  6 +-
 2 files changed, 43 insertions(+), 43 deletions(-)

(limited to 'files/fr/web/api/mediadevices')

diff --git a/files/fr/web/api/mediadevices/getusermedia/index.html b/files/fr/web/api/mediadevices/getusermedia/index.html
index 716bbfe120..c36f3740bf 100644
--- a/files/fr/web/api/mediadevices/getusermedia/index.html
+++ b/files/fr/web/api/mediadevices/getusermedia/index.html
@@ -5,15 +5,15 @@ translation_of: Web/API/MediaDevices/getUserMedia
 ---
 
{{APIRef("WebRTC")}}

 
-
La méthode MediaDevices.getUserMedia() invite l'utilisateur à autoriser l'utilisation d'une entrée multimédia qui produit un  {{domxref("MediaStream")}}  avec des pistes contenant les types de médias demandés.  Ce flux peut inclure, par exemple, une piste vidéo (produite par une source matérielle ou vidéo virtuelle telle qu'une caméra, un dispositif d'enregistrement vidéo, un service de partage d'écran, etc.), une piste audio (de la même manière, produite par une source physique ou Source audio virtuelle comme un microphone, convertisseur A / D ou similaire) et éventuellement d'autres types de piste.

+
La méthode MediaDevices.getUserMedia() invite l'utilisateur à autoriser l'utilisation d'une entrée multimédia qui produit un {{domxref("MediaStream")}} avec des pistes contenant les types de médias demandés. Ce flux peut inclure, par exemple, une piste vidéo (produite par une source matérielle ou vidéo virtuelle telle qu'une caméra, un dispositif d'enregistrement vidéo, un service de partage d'écran, etc.), une piste audio (de la même manière, produite par une source physique ou Source audio virtuelle comme un microphone, convertisseur A / D ou similaire) et éventuellement d'autres types de piste.

 
-
Il renvoie un  {{jsxref("Promise")}}  qui est résolu avec succès si l'utilisateur donne son autorisation;   {{domxref("MediaStream")}}  est fourni à ce moment-là.  Si l'utilisateur refuse ou si le média correspondant n'est pas disponible, le  {{jsxref("Promise")}}  est rejetée avec respectivement PermissionDeniedError ou NotFoundError.

+
Il renvoie un  {{jsxref("Promise")}}  qui est résolu avec succès si l'utilisateur donne son autorisation;   {{domxref("MediaStream")}}  est fourni à ce moment-là.  Si l'utilisateur refuse ou si le média correspondant n'est pas disponible, le  {{jsxref("Promise")}}  est rejetée avec respectivement PermissionDeniedError ou NotFoundError.

 
 

-
Il est possible que le  {{jsxref("Promise")}}  renvoyé ne soit ni résolu ni rejeté, car l'utilisateur n'est pas tenu de faire un choix. .

+
Note : Il est possible que le  {{jsxref("Promise")}}  renvoyé ne soit ni résolu ni rejeté, car l'utilisateur n'est pas tenu de faire un choix. .

 

 
-
Généralement, vous accédez à l'objet  {{domxref("MediaDevices")}}  avec  {{domxref("navigator.mediaDevices")}}  , comme ceci:

+
Généralement, vous accédez à l'objet  {{domxref("MediaDevices")}}  avec  {{domxref("navigator.mediaDevices")}}  , comme ceci:

 
 
navigator.mediaDevices.getUserMedia(constraints).then(function(stream) {
   /* use the stream */
@@ -26,31 +26,31 @@ translation_of: Web/API/MediaDevices/getUserMedia
 
var promise = navigator.mediaDevices.getUserMedia(constraints);
 

 
-
Paramètres

+
Paramètres

 
 

  
constraints

  

- 
Un objet  {{domxref("MediaStreamConstraints")}}  spécifiant les types de supports à demander, ainsi que toutes les exigences pour chaque type.

+ 
Un objet  {{domxref("MediaStreamConstraints")}}  spécifiant les types de supports à demander, ainsi que toutes les exigences pour chaque type.

 
- 
Le paramètre constraints est un objet MediaStreamConstraints avec deux membres: video et audio , décrivant les types de média demandés.  L'un ou l'autre ou les deux doivent être spécifiés.  Si le navigateur ne trouve pas toutes les pistes multimédia avec les types spécifiés qui répondent aux contraintes fournies, la promesse renvoyée est rejetée avec NotFoundError .

+ 
Le paramètre constraints est un objet MediaStreamConstraints avec deux membres: video et audio , décrivant les types de média demandés.  L'un ou l'autre ou les deux doivent être spécifiés.  Si le navigateur ne trouve pas toutes les pistes multimédia avec les types spécifiés qui répondent aux contraintes fournies, la promesse renvoyée est rejetée avec NotFoundError .

 
- 
Les demandes suivantes sont audio et vidéo sans aucune exigence spécifique:

+ 
Les demandes suivantes sont audio et vidéo sans aucune exigence spécifique:

 
  
{ audio: true, video: true }

 
- 
Si true est spécifié pour un type de média, le flux résultant est requis pour obtenir ce type de piste.  Si on ne peut pas l'obtenir pour une raison quelconque, l'appel à getUserMedia() entraînera une erreur.

+ 
Si true est spécifié pour un type de média, le flux résultant est requis pour obtenir ce type de piste.  Si on ne peut pas l'obtenir pour une raison quelconque, l'appel à getUserMedia() entraînera une erreur.

 
- 
Alors que les informations sur les caméras et les microphones d'un utilisateur sont inaccessibles pour des raisons de confidentialité, une application peut demander les capacités de caméra et de microphone dont elle a besoin en utilisant des contraintes supplémentaires.  Ce qui suit exprime une préférence pour la résolution de la caméra 1280x720:

+ 
Alors que les informations sur les caméras et les microphones d'un utilisateur sont inaccessibles pour des raisons de confidentialité, une application peut demander les capacités de caméra et de microphone dont elle a besoin en utilisant des contraintes supplémentaires.  Ce qui suit exprime une préférence pour la résolution de la caméra 1280x720:

 
  
{
   audio: true,
   video: { width: 1280, height: 720 }
 }

 
- 
Le navigateur essaiera d'honorer cela, mais peut renvoyer d'autres résolutions si une correspondance exacte n'est pas disponible, ou si l'utilisateur l'annule.

+ 
Le navigateur essaiera d'honorer cela, mais peut renvoyer d'autres résolutions si une correspondance exacte n'est pas disponible, ou si l'utilisateur l'annule.

 
- 
Pour exiger une capacité, utilisez les mots-clés min , max ou exact (aka min == max ).  Ce qui suit exige une résolution minimale de 1280x720:

+ 
Pour exiger une capacité, utilisez les mots-clés min , max ou exact (aka min == max ).  Ce qui suit exige une résolution minimale de 1280x720:

 
  
{
   audio: true,
@@ -60,9 +60,9 @@ translation_of: Web/API/MediaDevices/getUserMedia
   }
 }

 
- 
Si aucune caméra n'existe avec cette résolution ou plus haut, le  {{jsxref("Promise")}}  retourné sera rejeté avec OverconstrainedError.

+ 
Si aucune caméra n'existe avec cette résolution ou plus haut, le  {{jsxref("Promise")}}  retourné sera rejeté avec OverconstrainedError.

 
- 
La raison de la différence de comportement est que les mots clés min , max et exact sont intrinsèquement obligatoires, alors que les valeurs simples et un mot-clé appelé ideal ne le sont pas.  Voici un exemple plus complet:

+ 
La raison de la différence de comportement est que les mots clés min , max et exact sont intrinsèquement obligatoires, alors que les valeurs simples et un mot-clé appelé ideal ne le sont pas.  Voici un exemple plus complet:

 
  
{
   audio: true,
@@ -72,9 +72,9 @@ translation_of: Web/API/MediaDevices/getUserMedia
   }
 }

 
- 
Une valeur ideal , lorsqu'elle est utilisée, a une gravité, ce qui signifie que le navigateur essaiera de trouver le réglage (et la caméra, si vous en avez plus d'une), avec les valeurs les plus proches des valeurs idéales données.

+ 
Une valeur ideal , lorsqu'elle est utilisée, a une gravité, ce qui signifie que le navigateur essaiera de trouver le réglage (et la caméra, si vous en avez plus d'une), avec les valeurs les plus proches des valeurs idéales données.

 
- 
Les valeurs simples sont par nature idéales, ce qui signifie que le premier de nos exemples de résolution ci-dessus aurait pu être écrit comme ceci:

+ 
Les valeurs simples sont par nature idéales, ce qui signifie que le premier de nos exemples de résolution ci-dessus aurait pu être écrit comme ceci:

 
  
{
   audio: true,
@@ -84,50 +84,50 @@ translation_of: Web/API/MediaDevices/getUserMedia
   }
 }

 
- 
Toutes les contraintes ne sont pas des nombres.  Par exemple, sur les appareils mobiles, les éléments suivants préfèrent la caméra avant (si celle-ci est disponible) sur l'arrière:

+ 
Toutes les contraintes ne sont pas des nombres.  Par exemple, sur les appareils mobiles, les éléments suivants préfèrent la caméra avant (si celle-ci est disponible) sur l'arrière:

 
  
{ audio: true, video: { facingMode: "user" } }

 
- 
Pour exiger la caméra arrière, utilisez:

+ 
Pour exiger la caméra arrière, utilisez:

 
  
{ audio: true, video: { facingMode: { exact: "environment" } } }

  

 

 
-
Valeur de retour

+
Valeur de retour

 
-
Un  {{jsxref("Promise")}}  qui reçoit en objet  {{domxref("MediaStream")}}  lorsque les médias demandés ont été obtenus avec succès.

+
Un  {{jsxref("Promise")}}  qui reçoit en objet  {{domxref("MediaStream")}}  lorsque les médias demandés ont été obtenus avec succès.

 
 
Erreurs

 
-
Les rejets du  {{jsxref("Promise")}}  retourné sont effectués en passant un objet erreur DOMException au gestionnaire d'erreurs.  Les erreurs possibles sont:

+
Les rejets du  {{jsxref("Promise")}}  retourné sont effectués en passant un objet erreur DOMException au gestionnaire d'erreurs.  Les erreurs possibles sont:

 
 

  
AbortError

- 
Bien que l'utilisateur et le système d'exploitation aient tous deux accédé à l'équipement matériel, et qu'aucun problème de matériel ne causerait un NotReadableError , un problème s'est produit, ce qui a empêché l'utilisation du périphérique.

+ 
Bien que l'utilisateur et le système d'exploitation aient tous deux accédé à l'équipement matériel, et qu'aucun problème de matériel ne causerait un NotReadableError , un problème s'est produit, ce qui a empêché l'utilisation du périphérique.

  
NotAllowedError

- 
L'utilisateur a spécifié que l'instance de navigation actuelle n'a pas accès au périphérique;  Ou l'utilisateur a refusé l'accès pour la session en cours;  Ou l'utilisateur a refusé tout l'accès aux périphériques multimédias utilisateurs dans le monde entier.
- 
Les versions plus anciennes de la spécification ont utilisé SecurityError pour cela à la place;  SecurityError a pris une nouvelle signification.

+ 
L'utilisateur a spécifié que l'instance de navigation actuelle n'a pas accès au périphérique;  Ou l'utilisateur a refusé l'accès pour la session en cours;  Ou l'utilisateur a refusé tout l'accès aux périphériques multimédias utilisateurs dans le monde entier.
+ 
Note : Les versions plus anciennes de la spécification ont utilisé SecurityError pour cela à la place;  SecurityError a pris une nouvelle signification.

  

  
NotFoundError

- 
Aucune piste multimédia du type spécifié n'a été trouvée satisfaisant les contraintes données.

+ 
Aucune piste multimédia du type spécifié n'a été trouvée satisfaisant les contraintes données.

  
NotReadableError

- 
Bien que l'utilisateur ait autorisé l'utilisation des appareils correspondants, une erreur matérielle s'est produite sur le système d'exploitation, le navigateur ou le niveau de la page Web qui a empêché l'accès au périphérique.

+ 
Bien que l'utilisateur ait autorisé l'utilisation des appareils correspondants, une erreur matérielle s'est produite sur le système d'exploitation, le navigateur ou le niveau de la page Web qui a empêché l'accès au périphérique.

  
OverConstrainedError

- 
Aucun dispositif candidat répondant aux critères demandés.  L'erreur est un objet de type OverconstrainedError et possède une propriété de constraint dont la valeur de chaîne est le nom d'une contrainte impossible à honorer et une propriété message contenant une chaîne lisible par l'homme expliquant le problème.
- 
Étant donné que cette erreur peut se produire même lorsque l'utilisateur n'a pas encore autorisé l'utilisation du périphérique sous-jacent, il peut être utilisé comme surface d'empreinte digitale.

+ 
Aucun dispositif candidat répondant aux critères demandés.  L'erreur est un objet de type OverconstrainedError et possède une propriété de constraint dont la valeur de chaîne est le nom d'une contrainte impossible à honorer et une propriété message contenant une chaîne lisible par l'homme expliquant le problème.
+ 
Note : Étant donné que cette erreur peut se produire même lorsque l'utilisateur n'a pas encore autorisé l'utilisation du périphérique sous-jacent, il peut être utilisé comme surface d'empreinte digitale.

  

  
SecurityError

- 
Le support multimédia utilisateur est désactivé sur le  {{domxref("Document")}}  sur lequel getUserMedia() été appelé.  Le mécanisme par lequel le support média utilisateur est activé/désactivé est laissé à la discrétion de l'utilisateur.

+ 
Le support multimédia utilisateur est désactivé sur le  {{domxref("Document")}}  sur lequel getUserMedia() été appelé.  Le mécanisme par lequel le support média utilisateur est activé/désactivé est laissé à la discrétion de l'utilisateur.

  
TypeError

- 
La liste des contraintes spécifiées est vide ou toutes les contraintes sont définies comme false .

+ 
La liste des contraintes spécifiées est vide ou toutes les contraintes sont définies comme false .

 

 
-
Exemples

+
Exemples

 
-
Largeur et hauteur

+
Largeur et hauteur

 
-
Cet exemple donne une préférence pour la résolution de la caméra et attribue l'objet MediaStream résultant à un élément vidéo.

+
Cet exemple donne une préférence pour la résolution de la caméra et attribue l'objet MediaStream résultant à un élément vidéo.

 
 
// Prefer camera resolution nearest to 1280x720.
 var constraints = { audio: true, video: { width: 1280, height: 720 } };
@@ -143,9 +143,9 @@ navigator.mediaDevices.getUserMedia(constraints)
 .catch(function(err) { console.log(err.name + ": " + err.message); }); // always check for errors at the end.
 

 
-
Utilisation de la nouvelle API dans les navigateurs plus anciens

+
Utilisation de la nouvelle API dans les navigateurs plus anciens

 
-
Voici un exemple d'utilisation de navigator.mediaDevices.getUserMedia() , avec un adaptateur pour faire face aux navigateurs plus anciens.  Notez que cet adaptater ne corrige pas les différences existantes dans la syntaxe des contraintes, ce qui signifie que les contraintes ne fonctionneront pas bien dans les navigateurs.  Il est recommandé d'utiliser l'adaptateur adapter.js  a la place, qui gère les contraintes.

+
Voici un exemple d'utilisation de navigator.mediaDevices.getUserMedia() , avec un adaptateur pour faire face aux navigateurs plus anciens.  Notez que cet adaptater ne corrige pas les différences existantes dans la syntaxe des contraintes, ce qui signifie que les contraintes ne fonctionneront pas bien dans les navigateurs.  Il est recommandé d'utiliser l'adaptateur adapter.js  a la place, qui gère les contraintes.

 
 
// Older browsers might not implement mediaDevices at all, so we set an empty object first
 if (navigator.mediaDevices === undefined) {
@@ -195,14 +195,14 @@ navigator.mediaDevices.getUserMedia({ audio: true, video: true })
 
 
Taux d'images

 
-
Des cadences inférieures peuvent être souhaitables dans certains cas, comme les transmissions WebRTC avec des restrictions de bande passante.

+
Des cadences inférieures peuvent être souhaitables dans certains cas, comme les transmissions WebRTC avec des restrictions de bande passante.

 
 
var constraints = { video: { frameRate: { ideal: 10, max: 15 } } };
 

 
-
Caméra avant et arrière

+
Caméra avant et arrière

 
-
Sur les téléphones portables.

+
Sur les téléphones portables.

 
 
var front = false;
 document.getElementById('flip-button').onclick = function() { front = !front; };
@@ -212,7 +212,7 @@ var constraints = { video: { facingMode: (front? "user" : "environment") } };
 
 
Permissions

 
-
Pour utiliser getUserMedia() dans une application installable (par exemple, une application Firefox OS ), vous devez spécifier un ou les deux champs suivants dans votre fichier manifeste:

+
Pour utiliser getUserMedia() dans une application installable (par exemple, une application Firefox OS ), vous devez spécifier un ou les deux champs suivants dans votre fichier manifeste:

 
 
"permissions": {
   "audio-capture": {
@@ -223,7 +223,7 @@ var constraints = { video: { facingMode: (front? "user" : "environment") } };
   }
 }

 
-
Voir  permission: audio-capture  et  permission: video-capture  pour plus d'informations.

+
Voir  permission: audio-capture  et  permission: video-capture  pour plus d'informations.

 
 
Specifications

 
diff --git a/files/fr/web/api/mediadevices/index.html b/files/fr/web/api/mediadevices/index.html
index d0ce9de339..e1743db309 100644
--- a/files/fr/web/api/mediadevices/index.html
+++ b/files/fr/web/api/mediadevices/index.html
@@ -16,13 +16,13 @@ translation_of: Web/API/MediaDevices
 ---
 
{{APIRef("Media Capture and Streams")}}

 
-
L'interface MediaDevices permet d'accéder aux périphériques d'entrée multimédia connectés tels que les caméras et les microphones, ainsi que le partage d'écran. Essentiellement, il vous permet d'accéder à n'importe quelle source matérielle de données multimédias.

+
L'interface MediaDevices permet d'accéder aux périphériques d'entrée multimédia connectés tels que les caméras et les microphones, ainsi que le partage d'écran. Essentiellement, il vous permet d'accéder à n'importe quelle source matérielle de données multimédias.

 
 
Propriétés

 
 
Hérite des propriétés de son interface parente, {{domxref("EventTarget")}}.

 
-
Événéments

+
Événéments

 
 

  
{{domxref("MediaDevices/devicechange_event", "devicechange")}}

@@ -47,7 +47,7 @@ translation_of: Web/API/MediaDevices
 
 
Exemple

 
-
'use strict';
+
'use strict';
 
 // Placez les variables dans la portée globale pour les rendre disponibles à la console du navigateur.
 var video = document.querySelector('video');
-- 
cgit v1.2.3-54-g00ecf