AudioBufferSourceNode

Интерфейс AudioBufferSourceNode представляет собой AudioScheduledSourceNode, который представляет собой источник звука, состоящий из аудиоданных в памяти, хранящихся в AudioBuffer.

Этот интерфейс особенно полезен для воспроизведения звука, имеющего особенно строгие требования к точности временных характеристик, например, для звуков, которые должны соответствовать определённому ритму и могут храниться в памяти вместо воспроизведения с диска или сети. Для воспроизведения звуков, требующих точного времени, но которые должны передаваться по сети или воспроизводиться с диска, используйте AudioWorkletNode для реализации их воспроизведения.

У AudioBufferSourceNode нет входов и ровно один выход, имеющий такое же количество каналов, как и AudioBuffer, указанное свойством buffer. Если буфер не задан, то есть, если buffer равен null, на выходе присутствует один канал тишины (каждый образец равен 0).

AudioBufferSourceNode можно воспроизвести только один раз; после каждого вызова start() необходимо создать новый узел, если вы хотите воспроизвести тот же звук снова. К счастью, создание этих узлов очень недорого, и сами AudioBuffer могут быть повторно использованы для нескольких воспроизведений звука. Действительно, вы можете использовать эти узлы в режиме «выстрелил и забыл»: создайте узел, вызовите start() для начала воспроизведения звука и даже не беспокойтесь о том, чтобы удерживать ссылку на него. Он будет автоматически удален из памяти в соответствующее время, что не произойдёт, пока звук не закончится воспроизведение.

Разрешены несколько вызовов stop(). Последний вызов заменяет предыдущий, если AudioBufferSourceNode ещё не достиг конца буфера.

AudioBufferSourceNode()

Создаёт и возвращает новый объект AudioBufferSourceNode. В качестве альтернативы можно использовать фабричный метод BaseAudioContext.createBufferSource(); см. Создание AudioNode.

Наследует свойства от родительского элемента, AudioScheduledSourceNode.

AudioBufferSourceNode.buffer

An AudioBuffer that defines the audio asset to be played, or when set to the value null, defines a single channel of silence (in which every sample is 0.0).

AudioBufferSourceNode.detune

A k-скорость AudioParam representing detuning of playback in cents. This value is compounded with playbackRate to determine the speed at which the sound is played. Its default value is 0 (meaning no detuning), and its nominal range is -∞ to ∞.

AudioBufferSourceNode.loop

A Boolean attribute indicating if the audio asset must be replayed when the end of the AudioBuffer is reached. Its default value is false.

AudioBufferSourceNode.loopStart Optional

A floating-point value indicating the time, in seconds, at which playback of the AudioBuffer must begin when loop is true. Its default value is 0 (meaning that at the beginning of each loop, playback begins at the start of the audio buffer).

AudioBufferSourceNode.loopEnd Optional

A floating-point number indicating the time, in seconds, at which playback of the AudioBuffer stops and loops back to the time indicated by loopStart, if loop is true. The default value is 0.

AudioBufferSourceNode.playbackRate

A k-скорость AudioParam that defines the speed factor at which the audio asset will be played, where a value of 1.0 is the sound's natural sampling rate. Since no pitch correction is applied on the output, this can be used to change the pitch of the sample. This value is compounded with detune to determine the final playback rate.

Наследует методы от родительского элемента, AudioScheduledSourceNode, и переопределяет следующие методы:.

start()

Schedules playback of the audio data contained in the buffer, or begins playback immediately. Additionally allows the start offset and play duration to be set.

В этом примере мы создаём буфер продолжительностью две секунды, заполняем его белым шумом, а затем воспроизводим его с помощью 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
• Web Audio API