OscillatorNode: OscillatorNode() 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 OscillatorNode() Konstruktor der Web Audio API erstellt ein neues OscillatorNode Objekt, das ein AudioNode darstellt und eine periodische Wellenform erzeugt, wie zum Beispiel eine Sinuswelle. Dabei können optional die Eigenschaften der Node so gesetzt werden, dass sie mit den in einem angegebenen Objekt enthaltenen Werten übereinstimmen.

Wenn die Standardwerte der Eigenschaften akzeptabel sind, können Sie optional die BaseAudioContext.createOscillator() Factory-Methode verwenden; siehe Erstellen eines AudioNode.

Syntax

js
new OscillatorNode(context, options)

Parameter

context

Eine Referenz zu einem AudioContext.

options Optional

Ein Objekt, dessen Eigenschaften die Anfangswerte für die Eigenschaften der Oszillator-Node spezifizieren. Alle im Objekt ausgelassenen Eigenschaften nehmen den in der Dokumentation angegebenen Standardwert an.

type

Die Form der von der Node erzeugten Welle. Gültige Werte sind "sine", "square", "sawtooth", "triangle" und "custom". Der Standardwert ist "sine".

detune

Ein Verstimmungswert (in Cent), der die frequency um den angegebenen Betrag verschiebt. Der Standardwert ist 0.

frequency

Die Frequenz (in Hertz) der periodischen Wellenform. Der Standardwert ist 440.

periodicWave

Eine willkürliche periodische Wellenform, die durch ein PeriodicWave Objekt beschrieben wird.

channelCount

Stellt eine Ganzzahl dar, die bestimmt, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu allen Eingängen der Node 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 der Node abgestimmt werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen einschließlich der Standardwerte.)

channelInterpretation

Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation definiert, 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 der Standardwerte.)

Rückgabewert

Eine neue OscillatorNode Objektinstanz.

Spezifikationen

Specification
Web Audio API
# dom-oscillatornode-oscillatornode

Browser-Kompatibilität