Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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