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
-
Ein Verweis auf einen
AudioContext
. options
Optional-
Die Optionen sind wie folgt:
buffer
-
Eine Instanz von
AudioBuffer
, die abgespielt werden soll. detune
-
Ein Wert in Cent, um die Geschwindigkeit des Rendervorgangs des Audiostreams zu modulieren. Der nominale 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 modifiziert wird, wird der neue Wert im nächsten Audiobearbeitungsblock wirksam. loopEnd
-
Ein optionaler Wert in Sekunden, wo die Schleife enden soll, falls das Attribut
loop
true
ist. Der Standardwert ist0
. Sein Wert bezieht sich ausschließlich auf den Inhalt der Schleife. Die Beispielrahmen, die die Schleife umfassen, laufen von den WertenloopStart
bisloopEnd
-(1/sampleRate
). Es ist sinnvoll, diesen Wert zwischen 0 und der Dauer des Puffers festzulegen. 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 einen genauen Beispielrahmenoffset innerhalb des Puffers umgewandelt, indem es mit der Abtastrate des Puffers multipliziert und auf den nächsten ganzzahligen Wert gerundet wird. Sein Verhalten ist somit unabhängig von dem Wert desplaybackRate
-Parameters. loopStart
-
Ein optionaler Wert in Sekunden, wo die Schleife beginnen soll, falls das Attribut
loop
true
ist. Der Standardwert ist0
. Es ist sinnvoll, diesen Wert zwischen 0 und der Dauer des Puffers festzulegen. 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 einen genauen Beispielrahmenoffset innerhalb des Puffers umgewandelt, indem es mit der Abtastrate des Puffers multipliziert und auf den nächsten ganzzahligen Wert gerundet wird. Sein Verhalten ist somit unabhängig von dem Wert desplaybackRate
-Parameters. playbackRate
-
Die Geschwindigkeit, mit der der Audiostream gerendert wird. Der Standardwert ist
1
. Dieser Parameter ist k-rate. Dies ist ein zusammengesetzter Parameter mit Detune. Sein nominaler Bereich ist (-∞ bis +∞). channelCount
-
Stellt eine ganze Zahl dar, die bestimmt, wie viele Kanäle verwendet werden, wenn Up-Mixing und Down-Mixing Verbindungen zu den Eingängen des Knotens vorgenommen werden. (Siehe
AudioNode.channelCount
für weitere Informationen.) Seine Nutzung und präzise Definition hängen vom Wert vonchannelCountMode
ab. channelCountMode
-
Stellt einen aufzählbaren Wert dar, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgestimmt werden müssen. (Siehe
AudioNode.channelCountMode
für weitere Informationen, einschließlich der Standardwerte.) channelInterpretation
-
Stellt einen aufzählbaren Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation definiert, wie das 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 |
Browser-Kompatibilität
BCD tables only load in the browser