AudioBufferSourceNode: AudioBufferSourceNode() 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 AudioBufferSourceNode()
Konstruktor erstellt eine neue Instanz eines AudioBufferSourceNode
Objekts.
Syntax
new AudioBufferSourceNode(context, options)
Parameter
context
-
Eine Referenz auf einen
AudioContext
. options
Optional-
Optionen sind wie folgt:
buffer
-
Eine Instanz von
AudioBuffer
, die abgespielt werden soll. detune
-
Ein Wert in Cent, um die Geschwindigkeit der Audiostream-Wiedergabe zu modulieren. Sein nominaler Bereich ist (-∞ bis +∞). Der Standardwert ist
0
. loop
-
Ein boolescher Wert, der angibt, ob das Audio in einer Schleife abgespielt werden soll. Der Standardwert ist
false
. Wenn die Schleife während der Wiedergabe dynamisch geändert wird, wird der neue Wert im nächsten Verarbeitungsblock des Audios wirksam. loopEnd
-
Ein optionaler Wert, in Sekunden, wo das Schleifen enden soll, wenn das Attribut
loop
true
ist. Der Standardwert ist0
. Sein Wert ist exklusiv für den Inhalt der Schleife. Die Beispielrahmen, die die Schleife umfassen, laufen von den WertenloopStart
bisloopEnd
-(1/sampleRate
). Es ist sinnvoll, dies auf einen Wert zwischen 0 und der Dauer des Puffers zu setzen. WennloopEnd
kleiner als 0 ist, endet die Schleife bei 0. WennloopEnd
größer als die Dauer des Puffers ist, endet die Schleife am Ende des Puffers. Dieses Attribut wird in ein genaues Beispielrahmenoffset innerhalb des Puffers umgewandelt, indem es mit der Abtastrate des Puffers multipliziert und auf den nächsten ganzzahligen Wert gerundet wird. Somit ist sein Verhalten unabhängig vom Wert des ParametersplaybackRate
. loopStart
-
Ein optionaler Wert in Sekunden, wo das Schleifen beginnen soll, wenn das Attribut
loop
true
ist. Der Standardwert ist0
. Es ist sinnvoll, dies auf einen Wert zwischen 0 und der Dauer des Puffers zu setzen. WennloopStart
kleiner als 0 ist, beginnt die Schleife bei 0. WennloopStart
größer als die Dauer des Puffers ist, beginnt die Schleife am Ende des Puffers. Dieses Attribut wird in ein genaues Beispielrahmenoffset innerhalb des Puffers umgewandelt, indem es mit der Abtastrate des Puffers multipliziert und auf den nächsten ganzzahligen Wert gerundet wird. Somit ist sein Verhalten unabhängig vom Wert des ParametersplaybackRate
. playbackRate
-
Die Geschwindigkeit, mit der der Audiostream wiedergegeben wird. Sein Standardwert ist
1
. Dieser Parameter ist k-rate. Dies ist ein zusammengesetzter Parameter mit Detune. Sein nominaler Bereich ist (-∞ bis +∞). channelCount
-
Repräsentiert eine Ganzzahl, die verwendet wird, um zu bestimmen, wie viele Kanäle bei Up-Mixing und Down-Mixing Verbindungen zu den Eingängen des Knotens verwendet werden. (Siehe
AudioNode.channelCount
für weitere Informationen.) Seine Verwendung und genaue Definition hängen vom Wert vonchannelCountMode
ab. channelCountMode
-
Repräsentiert einen enumerierten Wert, der beschreibt, wie die 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
-
Repräsentiert einen enumerierten Wert, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie Audio Up-Mixing und Down-Mixing erfolgen wird. Die möglichen Werte sind
"speakers"
oder"discrete"
. (SieheAudioNode.channelCountMode
für weitere Informationen einschließlich der Standardwerte.)
Rückgabewert
Eine neue Instanz eines AudioBufferSourceNode
Objekts.
Spezifikationen
Specification |
---|
Web Audio API # dom-audiobuffersourcenode-constructor-audiobuffersourcenode |