AudioBufferSourceNode

Konstruktor

AudioBufferSourceNode()

Erstellt und gibt ein neues AudioBufferSourceNode Objekt zurück. Alternativ können Sie die BaseAudioContext.createBufferSource() Fabrikmethode verwenden; siehe Erstellen eines AudioNode.

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioScheduledSourceNode.

AudioBufferSourceNode.buffer

Ein AudioBuffer, das das abzuspielende Audio-Asset definiert, oder wenn auf den Wert null gesetzt, einen einzelnen Kanal der Stille definiert (bei dem jedes Sample 0.0 ist).

AudioBufferSourceNode.detune

Ein k-rate AudioParam, das die Verstimmung der Wiedergabe in Cents darstellt. Dieser Wert wird mit playbackRate kombiniert, um die Geschwindigkeit zu bestimmen, mit der der Klang abgespielt wird. Sein Standardwert ist 0 (was keine Verstimmung bedeutet), und sein Nennbereich ist -∞ bis ∞.

AudioBufferSourceNode.loop

Ein Boolean-Attribut, das anzeigt, ob das Audio-Asset wiedergegeben werden muss, wenn das Ende des AudioBuffer erreicht ist. Sein Standardwert ist false.

AudioBufferSourceNode.loopStart Optional

Ein Gleitkommawert, der die Zeit in Sekunden angibt, zu der die Wiedergabe des AudioBuffer beginnen muss, wenn loop true ist. Sein Standardwert ist 0 (was bedeutet, dass zu Beginn jeder Schleife die Wiedergabe am Anfang des Audiopuffers beginnt).

AudioBufferSourceNode.loopEnd Optional

Eine Gleitkommazahl, die die Zeit in Sekunden angibt, zu der die Wiedergabe des AudioBuffer stoppt und zur durch loopStart angegebenen Zeit zurückkehrt, wenn loop true ist. Der Standardwert ist 0.

AudioBufferSourceNode.playbackRate

Ein k-rate AudioParam, der den Geschwindigkeitsfaktor definiert, mit dem das Audio-Asset abgespielt wird, wobei ein Wert von 1.0 der natürlichen Abtastrate des Klangs entspricht. Da keine Tonhöhenkorrektur auf den Ausgang angewendet wird, kann dies verwendet werden, um die Tonhöhe des Samples zu ändern. Dieser Wert wird mit detune kombiniert, um die endgültige Wiedergaberate zu bestimmen.

Instanzmethoden

Erbt Methoden von seinem Elternteil, AudioScheduledSourceNode, und überschreibt die folgende Methode:.

start()

Plant die Wiedergabe der im Puffer enthaltenen Audiodaten oder beginnt die Wiedergabe sofort. Zusätzlich können der Startversatz und die Spieldauer eingestellt werden.

Beispiele

In diesem Beispiel erstellen wir einen zwei Sekunden langen Puffer, füllen ihn mit weißem Rauschen und spielen ihn dann mit einem AudioBufferSourceNode ab. Die Kommentare sollten klar erklären, was vor sich geht.

const audioCtx = new AudioContext();

// Create an empty three-second stereo buffer at the sample rate of the AudioContext
const myArrayBuffer = audioCtx.createBuffer(
  2,
  audioCtx.sampleRate * 3,
  audioCtx.sampleRate,
);

// Fill the buffer with white noise;
// just random values between -1.0 and 1.0
for (let channel = 0; channel < myArrayBuffer.numberOfChannels; channel++) {
  // This gives us the actual ArrayBuffer that contains the data
  const nowBuffering = myArrayBuffer.getChannelData(channel);
  for (let i = 0; i < myArrayBuffer.length; i++) {
    // Math.random() is in [0; 1.0]
    // audio needs to be in [-1.0; 1.0]
    nowBuffering[i] = Math.random() * 2 - 1;
  }
}

// Get an AudioBufferSourceNode.
// This is the AudioNode to use when we want to play an AudioBuffer
const source = audioCtx.createBufferSource();
// set the buffer in the AudioBufferSourceNode
source.buffer = myArrayBuffer;
// connect the AudioBufferSourceNode to the
// destination so we can hear the sound
source.connect(audioCtx.destination);
// start the source playing
source.start();

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Web Audio API
• Web Audio API