CKTIS / JavaScript
AnalyserNode — аудиоспектър и форма на вълната
AnalyserNode предоставя честотния спектър и проби от формата на вълната, без да променя преминаващия през него звук.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode анализира аудио, без да го променя. Това е част от Web Audio API, а не от ECMAScript; Node 24 не доказва поддръжка в браузърите. Проверете дали използваните конструктори са налични.
AnalyserNode.fftSize задава размера на FFT: степен на две от 32 до 32768 включително, със стойност по подразбиране 2048. По-големият размер подобрява честотната разделителна способност, но изисква по-дълъг прозорец. Свойството само за четене AnalyserNode.frequencyBinCount е равно на fftSize / 2. Ако размерът е невалиден след преобразуването по правилата на Web IDL към типа unsigned long, се хвърля изключение IndexSizeError. Преобразуването може да отреже дробната част и да даде валиден размер: например 32.5 става 32.
AnalyserNode.smoothingTimeConstant изглажда спектъра: диапазон 0–1, стойност по подразбиране 0.8; 0 изключва изглаждането. То не изглажда формата на вълната. Крайна стойност извън диапазона 0–1 предизвиква IndexSizeError, а безкрайна стойност или NaN предизвиква TypeError още при преобразуването по правилата на Web IDL, преди проверката на диапазона.
AnalyserNode.getByteFrequencyData(array) запълва Uint8Array със стойности от 0 до 255, мащабирани с minDecibels и maxDecibels, а не в херци. AnalyserNode.getByteTimeDomainData(array) записва проби от формата на вълната: тишината съответства на 128. Размерите на буферите са съответно frequencyBinCount и fftSize; по-късите буфери отрязват данните, а излишните елементи остават непроменени.
Примери
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);Резултат
32 16 32
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.