AudioNode: channelInterpretation-Eigenschaft

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.

Die channelInterpretation-Eigenschaft des AudioNode-Interfaces repräsentiert einen enumerierten Wert, der beschreibt, wie Eingangskanäle auf Ausgangskanäle abgebildet werden, wenn die Anzahl der Eingänge/Ausgänge unterschiedlich ist. Zum Beispiel definiert diese Einstellung, wie ein Mono-Eingang auf einen Stereo- oder 5.1-Kanal-Ausgang hochgemischt oder wie ein Quad-Kanal-Eingang auf einen Stereo- oder Mono-Ausgang heruntergemischt wird.

Die Eigenschaft hat zwei Optionen: speakers und discrete. Diese sind im Abschnitt Grundlegende Konzepte der Web Audio API > Hochmischen und Heruntermischen dokumentiert.

Wert

Die Werte sind im Abschnitt Grundlegende Konzepte der Web Audio API > Hochmischen und Heruntermischen dokumentiert.

Zusammengefasst:

speakers

Verwenden Sie eine Reihe von "standardmäßigen" Zuordnungen für Kombinationen üblicher Lautsprecher-Eingangs- und -Ausgangs-Setups (Mono, Stereo, Quad, 5.1). Bei dieser Einstellung würde beispielsweise ein Mono-Kanal-Eingang auf beiden Kanälen eines Stereo-Ausgangs wiedergegeben.

discrete

Eingangskanäle werden in Reihenfolge auf Ausgangskanäle abgebildet. Wenn es mehr Eingänge als Ausgänge gibt, werden die zusätzlichen Eingänge verworfen; gibt es weniger, bleiben die ungenutzten Ausgänge stumm.

Beispiele

js
const audioCtx = new AudioContext();

const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

oscillator.channelInterpretation = "discrete";

Spezifikationen

Specification
Web Audio API
# dom-audionode-channelinterpretation

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch