CKTIS / JavaScript
AnalyserNode: FFT spektar i valni oblik u bajtovima
Postavi veličinu FFT prozora i izglađivanje spektra pa odaberi zasebna polja bajtova odgovarajuće duljine za spektar i valni oblik.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 analizira signal bez promjene zvuka koji kroz njega prolazi. Pripada API-ju Web Audio, a ne standardu ECMAScript 2024. Provjeri je li dostupan u ciljnom izvršnom okruženju.
fftSize je broj uzoraka u prozoru brze Fourierove transformacije (FFT). Zadana je vrijednost 2048, a dopuštene su potencije broja dva od 32 do 32768 uključivo. Setter najprije pretvara dodijeljenu vrijednost u tip unsigned long prema pravilima Web IDL-a. Ako rezultat pretvorbe nije dopuštena veličina, setter izaziva iznimku DOMException pod nazivom IndexSizeError. Primjerice, dodjela vrijednosti 256.5 uspijeva jer se vrijednost pretvara u 256. Pri istoj frekvenciji uzorkovanja veći prozor obuhvaća dulji vremenski odsječak i smanjuje razmak između frekvencijskih komponenti. Svojstvo frequencyBinCount samo je za čitanje i uvijek iznosi fftSize / 2.
smoothingTimeConstant određuje težinu prethodne izglađene magnitude svake frekvencijske komponente. Raspon uključuje vrijednosti od 0 do 1, a zadana vrijednost je 0.8; konačna vrijednost izvan raspona izaziva IndexSizeError. Pri 0 prethodna analiza nema utjecaja, a pri 1 novi podaci ne utječu na izglađeni spektar. To je težina bez mjerne jedinice, a ne trajanje u sekundama. Ne izglađuje valni oblik.
getByteFrequencyData(array) zapisuje razine frekvencijskih komponenti u Uint8Array i pretvara decibele u vrijednosti od 0 do 255: razine jednake ili niže od minDecibels daju 0, a razine jednake ili više od maxDecibels daju 255. Upotrijebi frequencyBinCount elemenata. getByteTimeDomainData(array) zapisuje uzastopne uzorke valnog oblika od 0 do 255; 128 označava nultu amplitudu. Za cijeli valni oblik upotrijebi fftSize elemenata. Obje metode vraćaju undefined i prepisuju predano polje: ako je prekratko, dio podataka se gubi; ako je predugo, višak elemenata ostaje nepromijenjen. Ponovno koristi ista polja pri očitanjima i prilagodi im duljinu nakon promjene fftSize.
Primjeri
<!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>Rezultat
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Spremi primjer kao HTML datoteku i otvori je u pregledniku koji podržava Web Audio i izvanmrežno iscrtavanje zvuka temeljeno na obećanjima. Primjer analizira tišinu bez pristupa mikrofonu i bez reprodukcije zvuka. Očekuj 128 frekvencijskih komponenti s vrijednošću `0` i 256 uzoraka s vrijednošću `128` umjesto početnih vrijednosti `42`.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredno · Verzija: 4
Izvori
- 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