MediaStreamAudioSourceNode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
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.
Nombre d'entrées | 0 |
---|---|
Nombre de sorties | 1 |
Nombre de canaux | Défini par la première piste audio MediaStreamTrack passée à AudioContext.createMediaStreamSource() qui a créé le nœud. |
Constructeur
new MediaStreamAudioSourceNode()
-
Crée un nouvel objet
MediaStreamAudioSourceNode
avec les options indiquées.
Propriétés
En complément des propriétés suivantes, MediaStreamAudioSourceNode
hérite des propriétés de l'interface parente, AudioNode
.
mediaStream
Lecture seule-
L'objet
MediaStream
utilisé pour la construction de ceMediaStreamAudioSourceNode
.
Méthodes
Cette interface hérite des méthodes de son parent, AudioNode
.
Exceptions
InvalidStateError
DOMException
-
Cette exception est levée si le flux indiqué par le paramètre
mediaStream
ne contient pas de piste audio.
Notes d'utilisation
Ordre des pistes
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.
Exemple
Voir AudioContext.createMediaStreamSource()
pour un exemple de code qui utilise cet objet.
Spécifications
Specification |
---|
Web Audio API # MediaStreamAudioSourceNode |
Compatibilité des navigateurs
BCD tables only load in the browser