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 |
См. также
© 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