MediaElementAudioSourceNode: MediaElementAudioSourceNode() Konstruktor

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.

Der MediaElementAudioSourceNode() Konstruktor erstellt eine neue MediaElementAudioSourceNode Objektinstanz.

Syntax

js
new MediaElementAudioSourceNode(context, options)

Parameter

context

Ein AudioContext, der den Audiokontext darstellt, mit dem der Knoten assoziiert werden soll.

options

Ein Objekt, das die Eigenschaften definiert, die das MediaElementAudioSourceNode haben soll:

mediaElement

Ein HTMLMediaElement, das als Quelle für den Ton verwendet wird.

channelCount

Ein Integer, der bestimmt, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu den Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für mehr Informationen.) Seine Nutzung und präzise Definition hängen vom Wert von channelCountMode ab.

channelCountMode

Ein String, der beschreibt, wie Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für mehr Informationen inklusive Standardwerte.)

channelInterpretation

Ein String, der die Bedeutung der Kanäle beschreibt. Diese Interpretation definiert, wie Audio up-mixing und down-mixing erfolgen wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelInterpretation für mehr Informationen inklusive Standardwerte.)

Rückgabewert

Eine neue MediaElementAudioSourceNode Objektinstanz.

Beispiele

js
const ac = new AudioContext();
const mediaElement = document.createElement("audio");

const myAudioSource = new MediaElementAudioSourceNode(ac, {
  mediaElement,
});

Spezifikationen

Specification
Web Audio API
# dom-mediaelementaudiosourcenode-mediaelementaudiosourcenode

Browser-Kompatibilität

BCD tables only load in the browser