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 seuleDOMString
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è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
EventHandler
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
EventHandler
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
EventHandler
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 de
MediaStreamTrack
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 the
MediaStreamTrack
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 des
MediaStreamTrack
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 des
MediaStreamTrack
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.
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