CKTIS / JavaScript
AnalyserNode: FFT спектър и форма на сигнала в байтове
Настрой прозореца на FFT и изглаждането на спектъра, след което оразмери отделни байтови масиви за честотния спектър и времевите отсчети.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const analyser = context.createAnalyser();
analyser.fftSize = windowSize;
analyser.smoothingTimeConstant = smoothing;
const spectrum = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(spectrum);
analyser.getByteTimeDomainData(waveform);AnalyserNode анализира сигнал, без да променя звука, който преминава през него. Възелът е част от Web Audio API, а не от ECMAScript 2024. Провери дали е наличен в целевата среда за изпълнение.
fftSize е броят отсчети в прозореца на бързото преобразуване на Фурие (FFT). Стойността по подразбиране е 2048; допустими са степени на две от 32 до 32768 включително. При задаване на свойството стойността първо се преобразува към типа unsigned long според правилата на Web IDL. Ако резултатът от преобразуването не е допустим размер, се хвърля изключение DOMException с име IndexSizeError. Например присвояването на 256.5 е успешно, защото стойността се преобразува в 256. При постоянна честота на дискретизация по-големият прозорец обхваща повече време и намалява разстоянието между честотните компоненти. Свойството frequencyBinCount е само за четене и винаги е равно на fftSize / 2.
smoothingTimeConstant определя теглото на предишната изгладена големина на всяка честотна компонента. Диапазонът е от 0 до 1 включително, а стойността по подразбиране е 0.8; крайна стойност извън диапазона предизвиква IndexSizeError. При 0 предишният анализ не влияе на резултата, а при 1 новите данни не влияят на изгладения спектър. Това е безразмерно тегло, а не време в секунди. То не изглажда формата на сигнала.
getByteFrequencyData(array) записва нивата на честотните компоненти в Uint8Array, като преобразува децибелите в стойности от 0 до 255: нивата на или под minDecibels дават 0, а нивата на или над maxDecibels дават 255. Използвай frequencyBinCount елемента. getByteTimeDomainData(array) записва последователни отсчети на сигнала от 0 до 255; 128 означава нулева амплитуда. За пълната форма на сигнала използвай fftSize елемента. И двата метода връщат undefined и презаписват подадения масив: ако е твърде къс, част от данните се губи, а ако е твърде дълъг, излишните елементи остават непроменени. Използвай масивите повторно при следващи прочитания и коригирай дължините им след промяна на fftSize.
Примери
<!doctype html>
<meta charset="utf-8">
<title>AnalyserNode: silence</title>
<pre id="output"></pre>
<script>
(async () => {
const context = new OfflineAudioContext(1, 512, 48000);
const analyser = context.createAnalyser();
analyser.fftSize = 256;
analyser.smoothingTimeConstant = 0;
analyser.connect(context.destination);
const spectrum = new Uint8Array(analyser.frequencyBinCount).fill(42);
const waveform = new Uint8Array(analyser.fftSize).fill(42);
await context.startRendering();
analyser.getByteFrequencyData(spectrum);
analyser.getByteTimeDomainData(waveform);
const lines = [
`spectrum: ${spectrum.length} bins; all 0: ${spectrum.every(value => value === 0)}`,
`waveform: ${waveform.length} samples; all 128: ${waveform.every(value => value === 128)}`
];
document.getElementById('output').textContent = lines.join('\n');
for (const line of lines) console.log(line);
})();
</script>Резултат
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Запази примера като HTML файл и го отвори в браузър с поддръжка на Web Audio и офлайн обработка на звук с обещания. Примерът анализира тишина без достъп до микрофон и без възпроизвеждане на звук. Очакват се 128 честотни компоненти със стойност `0` и 256 отсчета със стойност `128` вместо началните стойности `42`.
Свързани уроци
- JavaScript · Урок 34 · Напреднало · Версия: 4
Източници
- AnalyserNode
- AnalyserNode: fftSize property
- AnalyserNode: smoothingTimeConstant property
- AnalyserNode: frequencyBinCount property
- AnalyserNode: getByteFrequencyData() method
- AnalyserNode: getByteTimeDomainData() method
- AnalyserNode: minDecibels property
- AnalyserNode: maxDecibels property
- OfflineAudioContext: OfflineAudioContext() constructor
- OfflineAudioContext: startRendering() method
- ECMAScript 2024 Language Specification — TypedArray Objects