MediaStream

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

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

Specification Status Comment
Media Capture and Streams
La définition de 'MediaStream' dans cette spécification.		 Candidat au statut de recommandation  

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !
Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support de base (Oui) (Oui) Pas de support Pas de support ?
getAudioTracks() et getVideoTracks() ? 23.0 (23.0) Pas de support Pas de support ?
Fonctionnalité Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support de base ? (Oui) Pas de support Pas de support ?
getAudioTracks() et getVideoTracks() ? 23.0 (23.0) Pas de support Pas de support ?

Voir aussi

  • Using the MediaStream API