CKTIS / JavaScript
AnalyserNode — zvučni spektar i valni oblik
AnalyserNode omogućuje pristup frekvencijskom spektru i uzorcima valnog oblika bez mijenjanja zvuka koji prolazi kroz njega.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analizira zvuk bez mijenjanja. Dio je Web Audio API-ja, a ne ECMAScripta; Node 24 ne potvrđuje podršku u pregledniku. Provjerite jesu li korišteni konstruktori dostupni.
AnalyserNode.fftSize postavlja veličinu FFT-a: potenciju broja dva od 32 do uključivo 32768, a zadana je vrijednost 2048. Veća veličina poboljšava frekvencijsku razlučivost, ali zahtijeva dulji prozor. Svojstvo samo za čitanje AnalyserNode.frequencyBinCount jednako je fftSize / 2. Ako je veličina nevaljana nakon pretvorbe prema pravilima Web IDL-a u tip unsigned long, baca se iznimka IndexSizeError. Pretvorba može odbaciti razlomljeni dio i dati valjanu veličinu: primjerice, 32.5 postaje 32.
AnalyserNode.smoothingTimeConstant zaglađuje spektar: raspon 0–1, zadana vrijednost 0.8; 0 isključuje zaglađivanje. Ne zaglađuje valni oblik. Konačna vrijednost izvan raspona 0–1 izaziva IndexSizeError, a beskonačna vrijednost ili NaN izaziva TypeError već pri pretvorbi prema pravilima Web IDL-a, prije provjere raspona.
AnalyserNode.getByteFrequencyData(array) popunjava Uint8Array vrijednostima od 0 do 255, skaliranima pomoću minDecibels i maxDecibels, a ne u hercima. AnalyserNode.getByteTimeDomainData(array) zapisuje uzorke valnog oblika: tišina odgovara vrijednosti 128. Veličine međuspremnika su frequencyBinCount i fftSize; kraći međuspremnici skraćuju podatke, a višak elemenata ostaje nepromijenjen.
Primjeri
const context = new OfflineAudioContext(1, 128, 48000);
const analyser = new AnalyserNode(context, {
fftSize: 32,
smoothingTimeConstant: 0
});
const frequency = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(frequency);
analyser.getByteTimeDomainData(waveform);
console.log(analyser.fftSize, frequency.length, waveform.length);Rezultat
32 16 32
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.