Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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.
L'interface MediaStreamAudioSourceNode est un type d'AudioNode qui traite une source audio dont le média a été récupéré depuis un objet MediaStream, obtenu en utilisant l'API WebRTC ou les API Media Capture et Streams.
Le média peut être obtenu depuis un microphone (avec getUserMedia()) ou depuis un pair distant pendant un appel WebRTC (avec les pistes audio de RTCPeerConnection).
Un nœud MediaStreamAudioSourceNode ne possède pas d'entrée et possède une seule sortie. Il est créé avec la méthode AudioContext.createMediaStreamSource().
MediaStreamAudioSourceNode utilise l'audio de la première piste MediaStreamTrack dont l'attribut kind vaut audio. Voir ci-après l'ordre des pistes pour plus d'informations.
Le nombre de canaux de sortie correspond au nombre de pistes trouvées sur la piste audio sélectionnée.
EventTarget AudioNode MediaStreamAudioSourceNode| 0 |
| 1 |
| Défini par la première piste audio MediaStreamTrack passée à AudioContext.createMediaStreamSource() qui a créé le nœud. |
Crée un nouvel objet MediaStreamAudioSourceNode avec les options indiquées.
En complément des propriétés suivantes, MediaStreamAudioSourceNode hérite des propriétés de l'interface parente, AudioNode.
mediaStream Lecture seuleL'objet MediaStream utilisé pour la construction de ce MediaStreamAudioSourceNode.
Cette interface hérite des méthodes de son parent, AudioNode.
Cette exception est levée si le flux indiqué par le paramètre mediaStream ne contient pas de piste audio.
Pour l'interface MediaStreamTrackAudioSourceNode, l'ordre des pistes audio du flux est déterminé en prenant les pistes pour lesquelles l'attribut kind vaut audio, en triant ces pistes selon les valeurs de leur propriété id selon l'ordre des points de code Unicode (ce qui correspond généralement à l'ordre alphabétique ou lexicographique lorsque les identifiants sont des chaînes de caractères alphanumériques simples).
La première piste est donc la piste dont l'identifiant id est le premier parmi ceux de toutes les pistes audio selon l'ordre des points de code Unicode.
Il est toutefois important de noter que cette règle pour l'ordre a été ajoutée après que cette interface a été introduite dans l'API Web Audio. Aussi, mieux vaut ne pas s'appuyer trop sur l'hypothèse que l'ordre sera le même d'un navigateur à l'autre, ou même d'une version à une autre d'un même navigateur.
L'interface MediaStreamTrackAudioSourceNode est semblable à MediaStreamAudioSourceNode, mais évite ce problème en permettant d'indiquer la piste qu'on souhaite utiliser.
Voir AudioContext.createMediaStreamSource() pour un exemple de code qui utilise cet objet.
| Web Audio API # MediaStreamAudioSourceNode |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 17 déc. 2024 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.