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
| 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
MediaStreamAudioSourceNodecon las opciones especificadas.
Propiedades
Además de las siguientes propiedades, MediaStreamAudioSourceNode hereda las propiedades de su padre, AudioNode.
mediaStreamRead only-
El
MediaStreamutilizado al construir esteMediaStreamAudioSourceNode.
Métodos
Hereda los métodos de su padre, AudioNode.
Excepciones
InvalidStateErrorDOMException-
Se lanza si la transmisión especificada por el parámetro
mediaStreamno 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