AudioParam: value-Eigenschaft

Eine Gleitkommazahl (Number), die den Wert des Parameters zur aktuellen Zeit angibt. Dieser Wert liegt zwischen den in den Eigenschaften minValue und maxValue angegebenen Werten.

Der intern zur Speicherung von value verwendete Datentyp ist eine einfachgenaue (32-Bit) Gleitkommazahl, während JavaScript 64-Bit doppelgenaue Gleitkommazahlen verwendet. Daher entspricht der Wert, den Sie aus der Eigenschaft value lesen, möglicherweise nicht immer genau dem, was Sie gesetzt haben.

Betrachten Sie folgendes Beispiel:

const source = new AudioBufferSourceNode(/* … */);
const rate = 5.3;
source.playbackRate.value = rate;
console.log(source.playbackRate.value === rate);

Die Protokollausgabe wird false sein, da der Abspielratenparameter, rate, in die 32-Bit-Gleitkommazahl umgewandelt wurde, die 5.3 am nächsten kommt, was 5.300000190734863 ergibt. Eine Lösung besteht darin, die Methode Math.fround() zu verwenden, die den einfachgenauen Wert zurückgibt, der dem angegebenen 64-Bit-JavaScript-Wert entspricht, wenn value gesetzt wird, wie folgt:

const source = new AudioBufferSourceNode(/* … */);
const rate = Math.fround(5.3);
source.playbackRate.value = rate;
console.log(source.playbackRate.value === rate);

In diesem Fall wird die Protokollausgabe true sein.

Der value eines AudioParam kann entweder fest oder sich im Laufe der Zeit ändernd sein. Dies wird durch den value-Getter widergespiegelt, der den Wert des Parameters basierend auf dem jüngsten Render-Quantum der Audio-Rendering-Engine zurückgibt, also dem Moment, an dem Audiopuffer verarbeitet und aktualisiert werden. Zusätzlich zur Verarbeitung von Audiopuffern aktualisiert jedes Render-Quantum den value jedes AudioParam nach Bedarf, basierend auf der aktuellen Zeit und allen festgelegten zeitbasierten Parameterwertänderungen.

Beim ersten Erstellen des Parameters ist sein Wert auf seinen Standardwert gesetzt, der von AudioParam.defaultValue vorgegeben ist. Dies ist der Wert des Parameters zum Zeitpunkt von 0,0 Sekunden und bleibt der Wert des Parameters bis zum ersten Render-Quantum, in dem der Wert geändert wird.

Während jedes Render-Quanta führt der Browser folgende Aufgaben im Zusammenhang mit der Verwaltung des Wertes eines Parameters aus:

• Wenn der value-Setter verwendet wurde, wird der Wert des Parameters auf den angegebenen Wert geändert.
• Wenn die aktuelle Zeit gleich oder größer ist als die durch einen vorherigen Aufruf von setValueAtTime() angegebene Zeit, wird der value auf den Wert geändert, der in setValueAtTime() übergeben wurde.
• Wenn Methoden zum Ändern von Werten mit schrittweisem oder Rampeffekt aufgerufen wurden und die aktuelle Zeit innerhalb des Zeitbereichs liegt, über den die schrittweise Änderung erfolgen soll, wird der Wert basierend auf dem entsprechenden Algorithmus aktualisiert. Diese Methoden zum Ändern von Werten mit Rampeffekt oder schrittweise sind unter anderem linearRampToValueAtTime(), setTargetAtTime() und setValueCurveAtTime().

Somit wird der value eines Parameters so verwaltet, dass er den Zustand des Parameters im Laufe der Zeit genau widerspiegelt.

Dieses Beispiel ändert sofort die Lautstärke eines GainNode auf 40 %.

const audioCtx = new AudioContext();
const gainNode = audioCtx.createGain();
gainNode.gain.value = 0.4;
// which is identical to:
gainNode.gain.setValueAtTime(0.4, audioCtx.currentTime);

• Verwendung der Web Audio API