BaseAudioContext: Methode createBuffer()

numOfChannels

Ein Ganzzahlwert, der die Anzahl der Kanäle darstellt, die dieser Puffer haben soll. Der Standardwert ist 1, und alle Benutzeragenten müssen mindestens 32 Kanäle unterstützen.

length

Ein Ganzzahlwert, der die Größe des Puffers in Sample-Frames darstellt (wobei jedes Sample-Frame die Größe eines Samples in Bytes multipliziert mit numOfChannels ist). Um die length für eine bestimmte Anzahl von Sekunden Audio zu bestimmen, verwenden Sie numSeconds * sampleRate.

sampleRate

Die Abtastrate der linearen Audiodaten in Sample-Frames pro Sekunde. Alle Browser müssen Abtastraten im Bereich von mindestens 8.000 Hz bis 96.000 Hz unterstützen.

Ein AudioBuffer, der basierend auf den angegebenen Optionen konfiguriert ist.

NotSupportedError DOMException

Wird ausgelöst, wenn eine oder mehrere der Optionen negativ oder anderweitig ungültig sind (wie zum Beispiel numberOfChannels, das höher ist als unterstützt, oder eine sampleRate außerhalb des nominalen Bereichs).

RangeError

Wird ausgelöst, wenn nicht genug Speicher verfügbar ist, um den Puffer zuzuweisen.

Zuerst ein paar einfache triviale Beispiele, um zu erklären, wie die Parameter verwendet werden:

const audioCtx = new AudioContext();
const buffer = audioCtx.createBuffer(2, 22050, 44100);

Wenn Sie diesen Aufruf verwenden, erhalten Sie einen Stereopuffer (zwei Kanäle), der, wenn er auf einem AudioContext läuft, der mit 44100Hz arbeitet (sehr häufig, die meisten normalen Soundkarten arbeiten mit dieser Rate), 0,5 Sekunden dauert: 22050 Frames / 44100Hz = 0,5 Sekunden.

const audioCtx = new AudioContext();
const buffer = audioCtx.createBuffer(1, 22050, 22050);

Wenn Sie diesen Aufruf verwenden, erhalten Sie einen Monopuffer (ein Kanal), der, wenn er auf einem AudioContext läuft, der mit 44100Hz arbeitet, automatisch auf 44100Hz umgesampelt wird (und daher 44100 Frames ergibt) und 1,0 Sekunde dauert: 44100 Frames / 44100Hz = 1 Sekunde.

Schauen wir uns nun ein komplexeres createBuffer()-Beispiel an, in dem wir einen drei Sekunden langen Puffer erstellen, ihn mit Weißem Rauschen füllen und dann über einen AudioBufferSourceNode abspielen. Der Kommentar sollte deutlich erklären, was vor sich geht. Sie können den Code live ausführen oder den Quellcode anzeigen.

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();

• Verwendung der Web Audio API