MediaStream

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

Attributs

MediaStream.id Lecture seule

DOMString contenant 36 carractères correspondant à l'identifiant unique (GUID) de l'objet.

MediaStream.ended Lecture seule

Booléen dont la valeur est true si l'évènement ended à été déclenché sur l'objet, signifiant que le flux à été complètement lu, ou false si la fin du flux n'à pas été atteinte.

Gestionnaire d'évènements

MediaStream.onaddtrack

Est un EventHandler contenant l'action à exécuter lorsqu'un évènement addtrack est déclenché sur l'objet, ce qui arrive lorsqu'un nouvel objet MediaStreamTrack est ajouté.

MediaStream.onended

Est un  EventHandler contenant l'action à exécuter lorsqu'un évènement ended est déclenché sur l'objet, ce qui arrive lorsque la diffusion est terminée.

MediaStream.onremovetrack

Est un EventHandler contenant l'action à exécuter lorsqu'un évènement removetrack est délenché sur l'objet, ce qui arrive quand un objet  MediaStreamTrack 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 retourne null. Si plusieurs pistes ont le même id, elle retourne la première piste.

MediaStream.addTrack()

Stocke une copie de MediaStreamTrack fourni en paramètre. Si la piste à déjà été ajouté à l'objet MediaStream, rien ne se passe; si la piste est au statut finished, c'est à dire qu'elle est terminée, l'exception INVALID_STATE_RAISE est levée.

MediaStream.removeTrack()

Retire le the MediaStreamTrack fourni comme argument. Si la piste ne fait pas parti du MediaStream, rien ne se passe; Si la piste est au statut finished, ce qui arrive lorsqu'elle est terminée, l'exception INVALID_STATE_RAISE est levée.

MediaStream.getAudioTracks()

Retourne la liste des MediaStreamTrack stockés dans l'objet MediaStream qui ont leur attribut kind 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 des MediaStreamTrack stockés dans l'objet MediaStream qui ont leur attribut kind 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.

Exemples

Spécifications

Compatibilité des navigateurs

Voir aussi

• Using the MediaStream API