BaseAudioContext: метод createBuffer()

Метод createBuffer() интерфейса BaseAudioContext используется для создания нового пустого объекта AudioBuffer, который затем можно заполнить данными и воспроизвести с помощью AudioBufferSourceNode.

Дополнительную информацию об аудиобуферах можно найти на странице справки AudioBuffer.

Для более глубокого понимания работы аудиобуферов, включая назначение параметров, прочитайте статью «Аудиобуферы: кадры, образцы и каналы» в нашем руководстве по основным концепциям здесь.

numOfChannels

Целое число, представляющее количество каналов, которые должен иметь этот буфер. Значение по умолчанию равно 1, и все агенты пользователя должны поддерживать как минимум 32 канала.

length

Целое число, представляющее размер буфера в кадрах с образцами (каждый кадр с образцом — это размер образца в байтах, умноженный на numOfChannels). Чтобы определить length для определённого количества секунд аудио, используйте numSeconds * sampleRate.

sampleRate

Частота дискретизации линейных аудиоданных в кадрах с образцами в секунду. Все браузеры должны поддерживать частоты дискретизации в диапазоне от 8000 Гц до 96000 Гц.

Объект AudioBuffer, настроенный в соответствии с указанными параметрами.

NotSupportedError DOMException

Выбрасывается, если один или несколько параметров имеют отрицательное значение или другое недопустимое значение (например, numberOfChannels превышает поддерживаемое значение или sampleRate выходит за номинальный диапазон).

RangeError

Выбрасывается, если для выделения буфера недостаточно памяти.

Сначала несколько простых тривиальных примеров, чтобы помочь объяснить, как используются параметры:

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

Если вы используете этот вызов, вы получите стерео буфер (два канала), который, когда воспроизводится в AudioContext, работающем со скоростью 44100 Гц (очень распространённый стандарт, большинство обычных звуковых карт работают с этой скоростью), будет воспроизводиться в течение 0,5 секунды: 22050 кадров / 44100 Гц = 0,5 секунды.

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

Если вы используете этот вызов, вы получите моно буфер (один канал), который, когда воспроизводится в AudioContext со скоростью 44100 Гц, будет автоматически преобразован к частоте 44100 Гц (и, следовательно, даст 44100 кадров), и будет воспроизводиться в течение 1,0 секунды: 44100 кадров / 44100 Гц = 1 секунда.

Теперь давайте рассмотрим более сложный createBuffer() пример, в котором мы создаём буфер длительностью три секунды, заполняем его белым шумом, а затем воспроизводим его через AudioBufferSourceNode. Комментарий чётко объясняет, что происходит. Вы также можете запустить код онлайн или посмотреть исходный код.

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

• Использование Web Audio API