CKTIS / JavaScript
AnalyserNode: spektrum FFT a časový průběh v bajtech
Nastav velikost okna FFT a vyhlazování spektra a zvol správnou délku samostatných bajtových polí pro spektrum a časový průběh.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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, aniž by měnil zvuk, který jím prochází. Patří do Web Audio API, nikoli do ECMAScriptu 2024. Ověř, že je v cílovém prostředí dostupný.
fftSize je počet vzorků v okně rychlé Fourierovy transformace (FFT). Výchozí hodnota je 2048; povolené jsou mocniny dvou od 32 do 32768 včetně. Setter nejprve převede přiřazenou hodnotu na typ unsigned long podle pravidel Web IDL. Pokud výsledek převodu není povolenou velikostí, setter vyvolá výjimku DOMException s názvem IndexSizeError. Například přiřazení hodnoty 256.5 uspěje, protože se převede na 256. Při stejné vzorkovací frekvenci větší okno pokrývá delší časový úsek a zmenšuje rozestupy mezi frekvenčními složkami. Vlastnost frequencyBinCount je jen pro čtení a vždy se rovná fftSize / 2.
smoothingTimeConstant určuje váhu předchozí vyhlazené velikosti každé frekvenční složky. Je v rozsahu od 0 do 1 včetně, výchozí hodnota je 0.8; konečná hodnota mimo rozsah vyvolá IndexSizeError. Při 0 nemá předchozí analýza vliv, při 1 nová data vyhlazené spektrum neovlivní. Jde o bezrozměrnou váhu, ne o dobu v sekundách. Časový průběh se tím nevyhlazuje.
getByteFrequencyData(array) zapíše úrovně frekvenčních složek do Uint8Array a převede decibely na hodnoty od 0 do 255: při minDecibels a níže je výsledek 0, při maxDecibels a výše je 255. Použij frequencyBinCount prvků. getByteTimeDomainData(array) zapíše po sobě jdoucí vzorky časového průběhu od 0 do 255; 128 označuje nulovou amplitudu. Pro úplný průběh použij fftSize prvků. Obě metody vracejí undefined a přepisují předané pole: v příliš krátkém poli se část dat ztratí, v příliš dlouhém zůstanou přebytečné prvky beze změny. Pole používej opakovaně a po změně fftSize uprav jejich délku.
Pří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ýsledek
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Ulož příklad jako soubor HTML a otevři ho v prohlížeči s podporou Web Audio a offline vykreslování zvuku pomocí příslibů. Příklad analyzuje ticho bez přístupu k mikrofonu a bez přehrávání. Očekávej 128 frekvenčních složek s hodnotou `0` a 256 vzorků s hodnotou `128` místo počátečních hodnot `42`.
Související lekce
- JavaScript · Lekce 34 · Pokročilá · Verze: 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