ConstantSourceNode: offset-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 schreibgeschützte offset-Eigenschaft der ConstantSourceNode-Schnittstelle gibt ein AudioParam-Objekt zurück, das den numerischen a-rate-Wert angibt, der immer von der Quelle zurückgegeben wird, wenn der nächste Sample angefordert wird.
Hinweis:
Während das AudioParam namens offset schreibgeschützt ist, ist die
value-Eigenschaft darin nicht. Sie können also den Wert von
offset ändern, indem Sie den Wert von
ConstantSourceNode.offset.value setzen:
myConstantSourceNode.offset.value = newValue;
Wert
Ein AudioParam-Objekt, das den a-rate-Wert angibt, der von diesem Knoten für jeden
Sample zurückgegeben wird. Der Standardwert ist 1.0.
Um den aktuellen Wert des offset-Parameters zuzugreifen, greifen Sie über die value-Eigenschaft des Parameters zu, wie im obigen Syntaxkasten gezeigt.
Beispiele
Dieses Beispiel zeigt, wie man eine ConstantSourceNode einrichtet, sodass deren
offset als Eingabe für ein Paar von GainNodes verwendet wird; dieser Code-Ausschnitt stammt aus dem vollständigen Beispiel, das Sie in Steuerung mehrerer Parameter mit ConstantSourceNode finden können.
gainNode2 = context.createGain();
gainNode3 = context.createGain();
gainNode2.gain.value = gainNode3.gain.value = 0.5;
volumeSliderControl.value = gainNode2.gain.value;
constantSource = context.createConstantSource();
constantSource.connect(gainNode2.gain);
constantSource.connect(gainNode3.gain);
Zuerst werden die Gain-Knoten erstellt und konfiguriert, und der Wert eines Schiebereglers wird so gesetzt, dass er mit dem Gain auf den beiden Knoten übereinstimmt. Dann erstellen wir eine neue
ConstantSourceNode und machen sie zur Quelle für die [GainNode.gain](/de/docs/Web/API/GainNode/gain) Werte der beiden Gain-Knoten. Jeder dieser Werte ist ebenfalls ein
AudioParam.
Angenommen, wir haben einen Ereignishandler (für click-Ereignisse in diesem Fall), der darauf reagieren muss, indem er den Wert der beiden Gain-Knoten ändert. Bei der oben genannten Verknüpfung kann dies mit diesem einfachen Ereignishandler geschehen:
function handleClickEvent(event) {
constantSource.offset.value = volumeSliderControl.value;
}
Alles, was diese Funktion tun muss, ist den aktuellen Wert der Schiebereglersteuerung abzurufen, die wir zur Steuerung der Gains der gekoppelten Knoten verwenden, und dann diesen Wert in den offset-Parameter der ConstantSourceNode zu speichern. Dies geschieht, indem der Inhalt seiner AudioParam.value-Eigenschaft geändert wird. Die beiden Gain-Knoten übernehmen schnell den neuen Lautstärkepegel.
Spezifikationen
| Specification |
|---|
| Web Audio API # dom-constantsourcenode-offset |