BaseAudioContext: Methode createPeriodicWave()
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 createPeriodicWave()
-Methode des BaseAudioContext
-Interfaces wird verwendet, um eine PeriodicWave
zu erstellen. Diese Welle wird verwendet, um eine periodische Wellenform zu definieren, die zur Formung der Ausgabe eines OscillatorNode
verwendet werden kann.
Syntax
createPeriodicWave(real, imag)
createPeriodicWave(real, imag, constraints)
Parameter
real
-
Ein Array von Kosinus-Terms (traditionell die A-Terme).
imag
-
Ein Array von Sinus-Terms (traditionell die B-Terme).
Die Arrays real
und imag
müssen die gleiche Länge haben, sonst wird ein Fehler ausgelöst.
constraints
Optional-
Ein Wörterbuchobjekt, das angibt, ob die Normalisierung deaktiviert werden soll. Wenn nicht angegeben, ist die Normalisierung standardmäßig aktiviert. Es enthält eine Eigenschaft:
disableNormalization
-
Wenn auf
true
gesetzt, wird die Normalisierung für die periodische Welle deaktiviert. Der Standardwert istfalse
.
Hinweis: Wenn normalisiert, wird die resultierende Welle einen maximalen absoluten Spitzenwert von 1 haben.
Rückgabewert
Eine PeriodicWave
.
Beispiele
Das folgende Beispiel veranschaulicht die einfache Verwendung von createPeriodicWave()
, um ein PeriodicWave
-Objekt zu erstellen, das eine einfache Sinuswelle enthält.
const real = new Float32Array(2);
const imag = new Float32Array(2);
const ac = new AudioContext();
const osc = ac.createOscillator();
real[0] = 0;
imag[0] = 0;
real[1] = 1;
imag[1] = 0;
const wave = ac.createPeriodicWave(real, imag, { disableNormalization: true });
osc.setPeriodicWave(wave);
osc.connect(ac.destination);
osc.start();
osc.stop(2);
Dies funktioniert, weil ein Klang, der nur einen Grundton enthält, definitionsgemäß eine Sinuswelle ist.
Hier erstellen wir eine PeriodicWave
mit zwei Werten. Der erste Wert ist der DC-Offset, der den Wert angibt, bei dem der Oszillator startet. Ein Wert von 0
ist hier gut, da er die Kurve in der Mitte des Bereichs [-1.0; 1.0]
startet. Die zweiten und nachfolgenden Werte sind Sinus- und Kosinuskomponenten, ähnlich dem Ergebnis einer Fourier-Transformation, die Zeitbereichswerte in Frequenzbereichswerte umwandelt. Hiermit spezifizieren Sie mit createPeriodicWave()
die Frequenzen, und der Browser führt eine inverse Fourier-Transformation aus, um einen Zeitbereichspuffer für die Frequenz des Oszillators zu erhalten. In diesem Beispiel setzen wir nur eine Komponente mit voller Lautstärke (1.0
) auf den Grundton, wodurch wir eine Sinuswelle erhalten. Beachten Sie, dass der Grundton der Frequenz des Oszillators entspricht (die standardmäßig 440 Hz
beträgt). Daher verschiebt sich die Frequenz dieser periodischen Welle in entsprechender Weise, wenn die Frequenz des Oszillators geändert wird.
Die Koeffizienten der Fourier-Transformation sollten in aufsteigender Reihenfolge angegeben werden (z.B. etc.) und können positiv oder negativ sein. Ein einfacher, aber nicht der beste Weg, um solchene Koeffizienten manuell zu erhalten, ist die Verwendung eines Grafikrechners.
Spezifikationen
Specification |
---|
Web Audio API # dom-baseaudiocontext-createperiodicwave |
Browser-Kompatibilität
BCD tables only load in the browser