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.

La interfaz MediaStreamAudioSourceNode es un tipo de AudioNode que funciona como una fuente de audio cuyo contenido multimedia se recibe de un MediaStream 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().

MediaStreamAudioSourceNode toma el audio del primer MediaStreamTrack cuyo valor de atributo kind 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() que lo creó.

Constructor

new MediaStreamAudioSourceNode()

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 Read only

El MediaStream 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 es audio y luego clasificando las pistas por el valor de su propiedad id, 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 es similar a MediaStreamAudioSourceNode, pero evita este problema al permitirle especificar qué pista desea usar.

Ejemplo

Consulte AudioContext.createMediaStreamSource() 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

Véase también