Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

AudioBuffer — amostras de áudio na memória

AudioBuffer armazena canais de amostras PCM na memória; não reproduz som por si só nem representa um ficheiro de áudio.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new AudioBuffer({ length, sampleRate, numberOfChannels: 1 })

AudioBuffer pertence a Web Audio, não a ECMAScript. Armazena canais de amostras PCM de vírgula flutuante de 32 bits. length conta frames, não bytes; duration = length / sampleRate indica a duração em segundos. Um buffer novo contém zeros.

getChannelData(0) expõe o primeiro canal como um Float32Array legível e modificável. copyToChannel() copia amostras para o canal; copyFromChannel() lê-as. Um índice de canal inválido provoca IndexSizeError. Para reproduzir áudio, utiliza-se AudioBufferSourceNode. Verifique a disponibilidade no navegador de destino; Node 24 não comprova que seja suportado.

Exemplos

const buffer = new AudioBuffer({ length: 4, sampleRate: 8000 });
buffer.copyToChannel(new Float32Array([0, 0.5, -0.5, 0]), 0);
console.log(buffer.length, buffer.numberOfChannels);
console.log(Array.from(buffer.getChannelData(0)).join(','));

Resultado

4 1
0,0.5,-0.5,0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes