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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
channelInterpretation

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch