MediaStream

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2017.

Expérimental:Il s'agit d'unetechnologie expérimentale.
Vérifiez attentivement letableau de compatibilité des navigateurs avant de l'utiliser en production.

L'interfaceMediaStream représente le contenu d'un flux de média. Un flux est composé de plusieurspistes, tel que des pistes vidéos ou audio.

Attributs

MediaStream.idLecture seule: DOMString contenant 36 carractères correspondant à l'identifiant unique (GUID) de l'objet.
MediaStream.endedLecture seule: Booléen dont la valeur esttrue si l'évènementended à été déclenché sur l'objet, signifiant que le flux à été complètement lu, oufalse si la fin du flux n'à pas été atteinte.

Gestionnaire d'évènements

MediaStream.onaddtrack: Est un gestionnaire d'évènement contenant l'action à exécuter lorsqu'un évènementaddtrack est déclenché sur l'objet, ce qui arrive lorsqu'un nouvel objetMediaStreamTrack est ajouté.
MediaStream.onended: Est un gestionnaire d'évènement contenant l'action à exécuter lorsqu'un évènementended est déclenché sur l'objet, ce qui arrive lorsque la diffusion est terminée.
MediaStream.onremovetrack: Est un gestionnaire d'évènement contenant l'action à exécuter lorsqu'un évènementremovetrack est délenché sur l'objet, ce qui arrive quand un objetMediaStreamTrack est retiré.

Méthodes

MediaStream.getTrackById(): Retourne la piste dont l'ID correspond à celui passé en paramètre,trackid. Si aucun paramètre n'est fourni, ou si aucune piste avec cet id existe, la fonction retournenull. Si plusieurs pistes ont le même id, elle retourne la première piste.

MediaStream.addTrack(): Stocke une copie deMediaStreamTrack fourni en paramètre. Si la piste à déjà été ajouté à l'objetMediaStream, rien ne se passe; si la piste est au statutfinished, c'est à dire qu'elle est terminée, l'exceptionINVALID_STATE_RAISE est levée.
MediaStream.removeTrack(): Retire le theMediaStreamTrack fourni comme argument. Si la piste ne fait pas parti duMediaStream, rien ne se passe; Si la piste est au statutfinished, ce qui arrive lorsqu'elle est terminée, l'exceptionINVALID_STATE_RAISE est levée.
MediaStream.getAudioTracks(): Retourne la liste desMediaStreamTrack stockés dans l'objetMediaStream qui ont leur attributkind défini à"audio". 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.
MediaStream.getVideoTracks(): Retourne une liste desMediaStreamTrack stockés dans l'objetMediaStream qui ont leur attributkind défini à"video". 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.