Звуковой буфер

Интерфейс AudioBuffer представляет собой небольшой аудио-фрагмент в памяти, созданный из аудиофайла с помощью метода AudioContext.decodeAudioData(), или из исходных данных с помощью AudioContext.createBuffer(). После размещения в AudioBuffer, аудио можно воспроизвести, передав его в AudioBufferSourceNode.

Объекты этих типов предназначены для хранения коротких аудио-фрагментов, обычно менее 45 секунд. Для более длинных звуков более подходящими являются объекты, реализующие MediaElementAudioSourceNode. Буфер содержит форму волны аудиосигнала, закодированную как серия амплитуд в формате: неинтерлированный IEEE754 32-битный линейный PCM с номинальным диапазоном между -1 и +1, то есть 32-битный буфер с плавающей точкой, где каждый образец находится между -1.0 и 1.0. Если у AudioBuffer несколько каналов, они хранятся в отдельных буферах.

AudioBuffer()

Создает и возвращает новый экземпляр объекта AudioBuffer.

AudioBuffer.sampleRate Только для чтения

Возвращает число с плавающей точкой, представляющее частоту дискретизации данных PCM, хранящихся в буфере, в образцах в секунду.

AudioBuffer.length Только для чтения

Возвращает целое число, представляющее длину данных PCM, хранящихся в буфере, в образцах-кадрах.

AudioBuffer.duration Только для чтения

Возвращает число с плавающей точкой двойной точности, представляющее длительность данных PCM, хранящихся в буфере, в секундах.

AudioBuffer.numberOfChannels Только для чтения

Возвращает целое число, представляющее количество дискретных аудиоканалов, описываемых данными PCM, хранящимися в буфере.

AudioBuffer.getChannelData()

Возвращает Float32Array, содержащий данные PCM, связанные с каналом, определенным параметром channel (причем 0 представляет первый канал).

AudioBuffer.copyFromChannel()

Копирует образцы из указанного канала AudioBuffer в массив destination.

AudioBuffer.copyToChannel()

Копирует образцы в указанный канал AudioBuffer, из массива source.

Следующий простой пример демонстрирует, как создать AudioBuffer и заполнить его случайным белым шумом. Полный исходный код можно найти в нашем репозитории webaudio-examples; также доступна рабочая онлайн-версия.

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 array 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