Spec-Zone.ru › Web APIs

AudioBuffer: метод getChannelData()

Базовая поддержка Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.

  • Подробнее
  • Полная совместимость
  • Отправить обратную связь

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

Синтаксис

getChannelData(channel)

Параметры

channel

Свойство channel представляет собой индекс, определяющий конкретный канал, для которого нужно получить данные. Значение индекса 0 соответствует первому каналу. Если значение индекса channel больше или равно AudioBuffer.numberOfChannels, будет выброшено исключение INDEX_SIZE_ERR.

Возвращаемое значение

Массив Float32Array.

Примеры

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

const audioCtx = new AudioContext();
const button = document.querySelector("button");
const pre = document.querySelector("pre");
const myScript = document.querySelector("script");

pre.textContent = myScript.textContent;

// Stereo
const channels = 2;
// Create an empty two second stereo buffer at the
// sample rate of the AudioContext
const frameCount = audioCtx.sampleRate * 2.0;

const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);

button.onclick = () => {
  // Fill the buffer with white noise;
  //just random values between -1.0 and 1.0
  for (let channel = 0; channel < channels; channel++) {
    // This gives us the actual ArrayBuffer that contains the data
    const nowBuffering = myArrayBuffer.getChannelData(channel);
    for (let i = 0; i < frameCount; 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
# dom-audiobuffer-getchanneldata

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
getChannelData 14 12 25 15 6 18 25 14 6 1.0 4.4.3

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer/getChannelData

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API