BaseAudioContext: метод decodeAudioData()

Метод decodeAudioData() интерфейса BaseAudioContext используется для асинхронного декодирования данных аудиофайла, содержащихся в ArrayBuffer, загруженного с помощью fetch(), XMLHttpRequest или FileReader. Декодированный AudioBuffer пересэмплируется до частоты дискретизации AudioContext, а затем передается в коллбек или промис.

Это предпочтительный метод создания источника аудио для Web Audio API из аудиодорожки. Этот метод работает только с полными данными файла, а не фрагментами.

Эта функция реализует два альтернативных способа асинхронного возвращения данных аудио или сообщений об ошибках: она возвращает Promise, который выполняется с данными аудио, а также принимает аргументы коллбека для обработки успеха или неудачи. Основной метод взаимодействия с этой функцией — через возвращаемое значение Promise, а параметры коллбека предоставляются по соображениям совместимости со старыми версиями.

arrayBuffer

ArrayBuffer, содержащий аудиоданные для декодирования, обычно получаемый с помощью fetch(), XMLHttpRequest или FileReader.

successCallback Необязательно

Функция обратного вызова, которая вызывается при успешном завершении декодирования. Единственный аргумент этого коллбека — AudioBuffer, представляющий decodedData (декодированные PCM-аудиоданные). Обычно вы захотите поместить декодированные данные в AudioBufferSourceNode, из которого их можно воспроизводить и обрабатывать по вашему желанию.

errorCallback Необязательно

Необязательный коллбек для обработки ошибок при декодировании аудиоданных.

Объект Promise, который выполняется с decodedData. Если вы используете синтаксис XHR, вы проигнорируете это возвращаемое значение и вместо этого используете функцию обратного вызова.

В этом разделе мы сначала рассмотрим синтаксис на основе промисов, а затем на основе коллбеков.

В этом примере loadAudio() использует fetch() для получения аудиофайла и декодирует его в AudioBuffer. Затем он кеширует audioBuffer в глобальной переменной buffer для последующего воспроизведения.

let audioCtx;
let buffer;
let source;

async function loadAudio() {
  try {
    // Load an audio file
    const response = await fetch("viper.mp3");
    // Decode it
    buffer = await audioCtx.decodeAudioData(await response.arrayBuffer());
  } catch (err) {
    console.error(`Unable to fetch the audio file. Error: ${err.message}`);
  }
}

В этом примере loadAudio() использует fetch() для получения аудиофайла и декодирует его в AudioBuffer с помощью версии decodeAudioData() на основе коллбеков. В коллбеке он воспроизводит декодированный буфер.

let audioCtx;
let source;

function playBuffer(buffer) {
  source = audioCtx.createBufferSource();
  source.buffer = buffer;
  source.connect(audioCtx.destination);
  source.loop = true;
  source.start();
}

async function loadAudio() {
  try {
    // Load an audio file
    const response = await fetch("viper.mp3");
    // Decode it
    audioCtx.decodeAudioData(await response.arrayBuffer(), playBuffer);
  } catch (err) {
    console.error(`Unable to fetch the audio file. Error: ${err.message}`);
  }
}

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