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 erzeugt ein neues OscillatorNode-Objekt, welches ein AudioNode darstellt, das eine periodische Wellenform, wie z.B. eine Sinuswelle, repräsentiert und optional die Eigenschaften des Knotens so einstellt, dass sie den Werten eines angegebenen Objekts entsprechen.

Wenn die Standardwerte der Eigenschaften akzeptabel sind, können Sie alternativ die BaseAudioContext.createOscillator() Fabrikmethode verwenden; siehe Erstellen eines AudioNode.

Syntax

new OscillatorNode(context, options)

Parameter

context

Ein Verweis auf ein AudioContext.

options Optional

Ein Objekt, dessen Eigenschaften die anfänglichen Werte für die Eigenschaften des Oszillator-Knotens festlegen. Jede weggelassene Eigenschaft des Objekts nimmt den Standardwert an, wie dokumentiert.

type: Die Form der vom Knoten 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 beliebige periodische Wellenform, die durch ein PeriodicWave-Objekt beschrieben wird.
channelCount: Stellt eine ganze Zahl dar, die angibt, wie viele Kanäle bei der Aufmischung und Abmischung von Verbindungen zu 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 Aufzählungswert dar, der beschreibt, wie Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)
channelInterpretation: Stellt einen Aufzählungswert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation definiert, wie Audio aufgemischt und abgemischt wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)

Rückgabewert

Eine neue Instanz des OscillatorNode-Objekts.

Spezifikationen

Specification
Web Audio API # dom-oscillatornode-oscillatornode

Browser-Kompatibilität

BCD tables only load in the browser