PeriodicWave: PeriodicWave()-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 PeriodicWave()-Konstruktor der Web Audio API erstellt eine neue Instanz eines PeriodicWave-Objekts.

Syntax

new PeriodicWave(context)
new PeriodicWave(context, options)

Parameter

context

Ein BaseAudioContext, das den Audiokontext darstellt, dem der Knoten zugeordnet werden soll.

options Optional

Ein PeriodicWaveOptions-Wörterbuchobjekt, das die Eigenschaften definiert, die der PeriodicWave haben soll (es erbt auch die in den PeriodicWaveConstraints definierten Optionen):

real: Ein Float32Array, das die Kosinus-Terme enthält, die zur Bildung der Welle verwendet werden sollen (entspricht dem real-Parameter von BaseAudioContext.createPeriodicWave).
imag: Ein Float32Array, das die Sinus-Terme enthält, die zur Bildung der Welle verwendet werden sollen (entspricht dem imag-Parameter von BaseAudioContext.createPeriodicWave).
channelCount: Stellt eine Ganzzahl dar, die bestimmt, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu allen Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Die Verwendung und genaue Definition hängen vom Wert von channelCountMode ab.
channelCountMode: Stellt einen enumerierten Wert dar, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich Standardwerte.)
channelInterpretation: Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation bestimmt, wie Audio Up-Mixing und Down-Mixing erfolgen wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich Standardwerte.)

Rückgabewert

Eine neue Instanz eines PeriodicWave-Objekts.

Beispiele

const real = new Float32Array(2);
const imag = new Float32Array(2);
const ac = new AudioContext();

real[0] = 0;
imag[0] = 0;
real[1] = 1;
imag[1] = 0;

const wave = new PeriodicWave(ac, {
  real,
  imag,
  disableNormalization: false,
});

Spezifikationen

Specification
Web Audio API # dom-periodicwave-periodicwave

Browser-Kompatibilität

BCD tables only load in the browser