diff options
Diffstat (limited to 'files/fr/web/api/mediastream/index.md')
| -rw-r--r-- | files/fr/web/api/mediastream/index.md | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/files/fr/web/api/mediastream/index.md b/files/fr/web/api/mediastream/index.md new file mode 100644 index 0000000000..292cb700e0 --- /dev/null +++ b/files/fr/web/api/mediastream/index.md @@ -0,0 +1,76 @@ +--- +title: MediaStream +slug: Web/API/MediaStream +translation_of: Web/API/MediaStream +--- +<div>{{APIRef("Media Capture and Streams")}} {{SeeCompatTable}}</div> + +<p>L'interface <code>MediaStream</code> représente le contenu d'un flux de média. Un flux est composé de plusieurs <em>pistes</em>, tel que des pistes vidéos ou audio.</p> + +<h2 id="Attributs">Attributs</h2> + +<dl> + <dt>{{domxref("MediaStream.id")}} {{readonlyInline}}</dt> + <dd>{{domxref("DOMString")}} contenant 36 carractères correspondant à l'identifiant unique (GUID) de l'objet.</dd> + <dt>{{domxref("MediaStream.ended")}} {{readonlyInline}}</dt> + <dd>Booléen dont la valeur est <code>true</code> si l'évènement {{event("ended (MediaStream)", "ended")}} à été déclenché sur l'objet, signifiant que le flux à été complètement lu, ou <code>false</code> si la fin du flux n'à pas été atteinte.</dd> +</dl> + +<h3 id="Gestionnaire_d'évènements">Gestionnaire d'évènements</h3> + +<dl> + <dt>{{domxref("MediaStream.onaddtrack")}}</dt> + <dd>Est un {{event("Event_handlers", "event handler")}} contenant l'action à exécuter lorsqu'un évènement {{event("addtrack")}} est déclenché sur l'objet, ce qui arrive lorsqu'un nouvel objet {{domxref("MediaStreamTrack")}} est ajouté.</dd> + <dt>{{domxref("MediaStream.onended")}}</dt> + <dd>Est un {{event("Event_handlers", "event handler")}} contenant l'action à exécuter lorsqu'un évènement {{event("ended (MediaStream)","ended")}} est déclenché sur l'objet, ce qui arrive lorsque la diffusion est terminée.</dd> + <dt>{{domxref("MediaStream.onremovetrack")}}</dt> + <dd>Est un {{event("Event_handlers", "event handler")}} contenant l'action à exécuter lorsqu'un évènement {{event("removetrack")}} est délenché sur l'objet, ce qui arrive quand un objet {{domxref("MediaStreamTrack")}} est retiré.</dd> +</dl> + +<h2 id="Méthodes">Méthodes</h2> + +<dl> + <dt>{{domxref("MediaStream.getTrackById()")}}</dt> + <dd>Retourne la piste dont l'ID correspond à celui passé en paramètre, <code>trackid</code>. Si aucun paramètre n'est fourni, ou si aucune piste avec cet id existe, la fonction retourne <code>null</code>. Si plusieurs pistes ont le même id, elle retourne la première piste.</dd> +</dl> + +<dl> + <dt>{{domxref("MediaStream.addTrack()")}}</dt> + <dd>Stocke une copie de {{domxref("MediaStreamTrack")}} fourni en paramètre. Si la piste à déjà été ajouté à l'objet <code>MediaStream</code>, rien ne se passe; si la piste est au statut <code>finished</code>, c'est à dire qu'elle est terminée, l'exception <code>INVALID_STATE_RAISE</code> est levée.</dd> + <dt>{{domxref("MediaStream.removeTrack()")}}</dt> + <dd>Retire le the {{domxref("MediaStreamTrack")}} fourni comme argument. Si la piste ne fait pas parti du <code>MediaStream</code>, rien ne se passe; Si la piste est au statut <code>finished</code>, ce qui arrive lorsqu'elle est terminée, l'exception <code>INVALID_STATE_RAISE</code> est levée.</dd> + <dt>{{domxref("MediaStream.getAudioTracks()")}}</dt> + <dd>Retourne la liste des {{domxref("MediaStreamTrack")}} stockés dans l'objet <code>MediaStream</code> qui ont leur attribut <code>kind</code> défini à <code>"audio"</code>. L'ordre n'est pas défini, et peut varier d'un navigateur à l'autre, mais aussi d'un appel de la méthode à l'autre.</dd> + <dt>{{domxref("MediaStream.getVideoTracks()")}}</dt> + <dd>Retourne une liste des {{domxref("MediaStreamTrack")}} stockés dans l'objet <code>MediaStream</code> qui ont leur attribut <code>kind</code> défini à <code>"video"</code>. L'ordre n'est pas défini, et peut varier d'un navigateur à l'autre, mais aussi d'un appel de la méthode à l'autre.</dd> +</dl> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td>{{SpecName('Media Capture', '#mediastream', 'MediaStream')}}</td> + <td>{{Spec2('Media Capture')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.MediaStream")}}</p> + +<h2 id="See_also">Voir aussi</h2> + +<ul> + <li>Utilisation de l'API MediaStream</li> + <li><a href="/fr/docs/Web/API/WebRTC_API">WebRTC API</a></li> + <li><a href="/fr/docs/Web/API/Web_Audio_API">Web Audio API</a></li> + <li>{{domxref("MediaStreamTrack")}}</li> +</ul> |