[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/MediaStreamAudioSourceNode [Back]  [Original]

MediaStreamAudioSourceNode - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

MediaStreamAudioSourceNode

Baseline
Large disponibilit

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 mdia a t rcupr depuis un objet MediaStream, obtenu en utilisant l'API WebRTC ou les API Media Capture et Streams.

Le mdia peut tre obtenu depuis un microphone (avec getUserMedia()) ou depuis un pair distant pendant un appel WebRTC (avec les pistes audio de RTCPeerConnection).

Un nud MediaStreamAudioSourceNode ne possde pas d'entre et possde une seule sortie. Il est cr avec la mthode AudioContext.createMediaStreamSource().

MediaStreamAudioSourceNode utilise l'audio de la premire piste MediaStreamTrack dont l'attribut kind vaut audio. Voir ci-aprs l'ordre des pistes pour plus d'informations.

Le nombre de canaux de sortie correspond au nombre de pistes trouves sur la piste audio slectionne.

EventTarget AudioNode MediaStreamAudioSourceNode
Nombre d'entres 0
Nombre de sorties 1
Nombre de canaux Dfini par la premire piste audio MediaStreamTrack passe AudioContext.createMediaStreamSource() qui a cr le nud.

Dans cet article

Constructeur

new MediaStreamAudioSourceNode()

Cre un nouvel objet MediaStreamAudioSourceNode avec les options indiques.

Proprits

En complment des proprits suivantes, MediaStreamAudioSourceNode hrite des proprits de l'interface parente, AudioNode.

mediaStream Lecture seule

L'objet MediaStream utilis pour la construction de ce MediaStreamAudioSourceNode.

Mthodes

Cette interface hrite des mthodes de son parent, AudioNode.

Exceptions

InvalidStateError DOMException

Cette exception est leve si le flux indiqu par le paramtre 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 dtermin en prenant les pistes pour lesquelles l'attribut kind vaut audio, en triant ces pistes selon les valeurs de leur proprit id selon l'ordre des points de code Unicode (ce qui correspond gnralement l'ordre alphabtique ou lexicographique lorsque les identifiants sont des chanes de caractres alphanumriques simples).

La premire 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 rgle pour l'ordre a t ajoute aprs que cette interface a t introduite dans l'API Web Audio. Aussi, mieux vaut ne pas s'appuyer trop sur l'hypothse que l'ordre sera le mme d'un navigateur l'autre, ou mme d'une version une autre d'un mme navigateur.

L'interface MediaStreamTrackAudioSourceNode est semblable MediaStreamAudioSourceNode, mais vite ce problme en permettant d'indiquer la piste qu'on souhaite utiliser.

Exemple

Voir AudioContext.createMediaStreamSource() pour un exemple de code qui utilise cet objet.

Spcifications

Spcification
Web Audio API
# MediaStreamAudioSourceNode

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page