MediaStreamAudioSourceNode
==========================

La interfaz **`MediaStreamAudioSourceNode`** es un tipo de `AudioNode` que funciona como una fuente de audio cuyo contenido multimedia se recibe de un `MediaStream` (en-US) obtenido mediante WebRTC o las API de captura y transmisión de medios.

Este medio podría venir de un micrófono (a través de `getUserMedia()`) o de un compañero remoto en una llamada WebRTC (usando pistas de audio `RTCPeerConnection`).

Un `MediaStreamAudioSourceNode` no tiene entradas y exactamente una salida, y se crea mediante el método `AudioContext.createMediaStreamSource()` (en-US).

`MediaStreamAudioSourceNode` toma el audio del *primer* `MediaStreamTrack` cuyo valor de atributo `kind` (en-US) es `audio`. Consulte Orden de pistas para obtener más información sobre el orden de las pistas.

El número de canales emitidos por el nodo coincide con el número de pistas encontradas en la pista de audio seleccionada

EventTarget

AudioNode

MediaStreamAudioSourceNode

|  |  |
| --- | --- |
| Número de entradas | `0` |
| Número de salidas | `1` |
| Conteo de canales | definido por el primer audio `MediaStreamTrack` pasado al método `AudioContext.createMediaStreamSource()` (en-US) que lo creó. |

Constructor
-----------

`new MediaStreamAudioSourceNode()` (en-US)

Crea una nueva instancia de objeto `MediaStreamAudioSourceNode` con las opciones especificadas.

Propiedades
-----------

*Además de las siguientes propiedades, `MediaStreamAudioSourceNode` hereda las propiedades de su padre, `AudioNode`*.

`mediaStream` (en-US) Read only 

El `MediaStream` (en-US) utilizado al construir este `MediaStreamAudioSourceNode`.

Métodos
-------

*Hereda los métodos de su padre, `AudioNode`*.

Excepciones
-----------

`InvalidStateError` `DOMException`

Se lanza si la transmisión especificada por el parámetro `mediaStream` no contiene ninguna pista de audio.

Notas de uso
------------

### Orden de pistas

En la interfaz `MediaStreamTrackAudioSourceNode`, el orden de las pistas de audio en la transmisión se determina tomando las pistas cuyo valor del atributo `kind` (en-US) es `audio` y luego clasificando las pistas por el valor de su propiedad `id` (en-US), en orden de código Unicode (esencialmente, en orden alfabético o lexicográfico, para los ID que son cadenas alfanuméricas simples).

La **primera** pista, entonces, es la pista cuyo `id` aparece primero cuando los ID de las pistas están todas ordenadas por código Unicode.

Sin embargo, es importante tener en cuenta que la regla que establece este orden se agregó mucho después de que esta interfaz se introdujera por primera vez en Web Audio API. Como tal, no se puede confiar fácilmente en la coincidencia de orden entre dos navegadores o versiones de navegador.

La interfaz `MediaStreamTrackAudioSourceNode` (en-US) es similar a `MediaStreamAudioSourceNode`, pero evita este problema al permitirle especificar qué pista desea usar.

Ejemplo
-------

Consulte `AudioContext.createMediaStreamSource()` (en-US) para obtener un código de ejemplo que usa este objeto.

Especicaciones
--------------

| Specification |
| --- |
| Web Audio API # MediaStreamAudioSourceNode |

Compatibilidad con navegadores
------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Véase también
-------------

* Usando la API Web Audio (en-US)
* WebRTC API
* API de captura de medios y transmisiones (Media Streams)
* `MediaStreamTrackAudioSourceNode` (en-US)