CKTIS / JavaScript
AnalyserNode — zvukové spektrum a průběh
AnalyserNode zpřístupňuje frekvenční spektrum a vzorky průběhu, aniž mění procházející zvuk.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analyzuje zvuk, aniž by jej měnil. Jde o součást Web Audio API, nikoli ECMAScriptu; Node 24 nepotvrzuje podporu v prohlížeči. Ověřte dostupnost použitých konstruktorů.
AnalyserNode.fftSize nastavuje velikost FFT: mocninu dvou od 32 do 32768 včetně, výchozí hodnota je 2048. Větší velikost zlepšuje frekvenční rozlišení za cenu delšího okna. Vlastnost pouze pro čtení AnalyserNode.frequencyBinCount se rovná fftSize / 2. Pokud je velikost po převodu podle Web IDL na typ unsigned long neplatná, vyvolá se výjimka IndexSizeError. Převod může odříznout zlomkovou část a dát platnou velikost: například z 32.5 vznikne 32.
AnalyserNode.smoothingTimeConstant vyhlazuje spektrum: rozsah 0–1, výchozí hodnota 0.8; hodnota 0 vyhlazování vypne. Průběh nevyhlazuje. Konečná hodnota mimo rozsah 0–1 vyvolá IndexSizeError, zatímco nekonečná hodnota nebo NaN vyvolá TypeError už při převodu podle Web IDL, ještě před kontrolou rozsahu.
AnalyserNode.getByteFrequencyData(array) naplní Uint8Array hodnotami 0–255 škálovanými pomocí minDecibels a maxDecibels, nikoli v hertzech. AnalyserNode.getByteTimeDomainData(array) zapíše vzorky průběhu: ticho odpovídá hodnotě 128. Velikosti bufferů jsou frequencyBinCount a fftSize; kratší buffery data zkrátí, přebytečné prvky zůstanou beze změny.
Příklady
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);Výsledek
32 16 32
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.