CKTIS / JavaScript
AnalyserNode: spektrum FFT a časový priebeh v bajtoch
Nastav veľkosť okna FFT a vyhladzovanie spektra a zvoľ správnu dĺžku samostatných bajtových polí pre spektrum a časový priebeh.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 analyzuje signál bez toho, aby menil zvuk, ktorý ním prechádza. Patrí do Web Audio API, nie do ECMAScriptu 2024. Over si, či je dostupný v cieľovom prostredí.
fftSize je počet vzoriek v okne rýchlej Fourierovej transformácie (FFT). Predvolená hodnota je 2048; povolené sú mocniny dvojky od 32 do 32768 vrátane. Setter najprv prevedie priradenú hodnotu na typ unsigned long podľa pravidiel Web IDL. Ak výsledok prevodu nie je povolená veľkosť, setter vyvolá výnimku DOMException s názvom IndexSizeError. Napríklad priradenie hodnoty 256.5 prebehne úspešne, pretože sa prevedie na 256. Pri rovnakej vzorkovacej frekvencii väčšie okno pokrýva dlhší časový úsek a zmenšuje odstup medzi frekvenčnými zložkami. Vlastnosť frequencyBinCount je len na čítanie a vždy sa rovná fftSize / 2.
smoothingTimeConstant určuje váhu predchádzajúcej vyhladenej veľkosti každej frekvenčnej zložky. Má rozsah od 0 do 1 vrátane a predvolenú hodnotu 0.8; konečná hodnota mimo rozsahu vyvolá IndexSizeError. Pri 0 predchádzajúca analýza nemá vplyv, pri 1 nové údaje neovplyvňujú vyhladené spektrum. Je to bezrozmerná váha, nie čas v sekundách. Časový priebeh sa tým nevyhladzuje.
getByteFrequencyData(array) zapíše úrovne frekvenčných zložiek do Uint8Array a prevedie decibely na hodnoty od 0 do 255: pri minDecibels alebo nižšie je výsledok 0, pri maxDecibels alebo vyššie je 255. Použi frequencyBinCount prvkov. getByteTimeDomainData(array) zapíše po sebe idúce vzorky časového priebehu od 0 do 255; 128 znamená nulovú amplitúdu. Na celý priebeh použi fftSize prvkov. Obe metódy vracajú undefined a prepisujú odovzdané pole: pri príliš krátkom poli sa časť údajov stratí, pri príliš dlhom ostanú nadbytočné prvky nezmenené. Polia používaj opakovane a po zmene fftSize uprav ich dĺžku.
Príklady
<!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>Výsledok
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Ulož príklad ako súbor HTML a otvor ho v prehliadači s podporou Web Audio a offline vykresľovania zvuku pomocou prísľubov. Príklad analyzuje ticho bez prístupu k mikrofónu alebo prehrávania. Očakávaj 128 frekvenčných zložiek s hodnotou `0` a 256 vzoriek s hodnotou `128` namiesto počiatočných hodnôt `42`.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Pokročilá · Verzia: 4
Zdroje
- 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