Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

AnalyserNode: spekter FFT in valovna oblika v bajtih

Nastavi velikost okna FFT in glajenje spektra, nato izberi ločeni bajtni polji ustreznih dolžin za spekter in časovne vzorce.

Različica: 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, ne da bi spremenil zvok, ki potuje skozenj. Je del API-ja Web Audio, ne standarda ECMAScript 2024. Preveri, ali je na voljo v ciljnem izvajalnem okolju.

fftSize je število vzorcev v oknu hitre Fourierove transformacije (FFT). Privzeta vrednost je 2048; dovoljene so potence števila dve od 32 do vključno 32768. Nastavljalnik dodeljeno vrednost najprej pretvori v tip unsigned long po pravilih Web IDL. Če rezultat pretvorbe ni dovoljena velikost, sproži izjemo DOMException z imenom IndexSizeError. Dodelitev vrednosti 256.5 na primer uspe, ker se vrednost pretvori v 256. Pri nespremenjeni frekvenci vzorčenja večje okno zajema daljši časovni odsek in zmanjša razmik med frekvenčnimi komponentami. Lastnost frequencyBinCount je samo za branje in je vedno enaka fftSize / 2.

smoothingTimeConstant določa utež prejšnje zglajene velikosti vsake frekvenčne komponente. Razpon je od 0 do 1 vključno, privzeta vrednost pa je 0.8; končna vrednost zunaj razpona sproži IndexSizeError. Pri 0 prejšnja analiza ne vpliva na rezultat, pri 1 pa novi podatki ne vplivajo na zglajeni spekter. To je utež brez enote, ne trajanje v sekundah. Valovne oblike ne gladi.

getByteFrequencyData(array) zapiše ravni frekvenčnih komponent v Uint8Array in pretvori decibele v vrednosti od 0 do 255: pri minDecibels ali manj je rezultat 0, pri maxDecibels ali več pa 255. Uporabi frequencyBinCount elementov. getByteTimeDomainData(array) zapiše zaporedne vzorce valovne oblike od 0 do 255; 128 pomeni ničelno amplitudo. Za celotno valovno obliko uporabi fftSize elementov. Obe metodi vrneta undefined in prepišeta podano polje: pri prekratkem polju se del podatkov izgubi, pri predolgem pa odvečni elementi ostanejo nespremenjeni. Polji ponovno uporabljaj med branji in jima po spremembi fftSize prilagodi dolžino.

Primeri

<!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

Shrani primer kot datoteko HTML in jo odpri v brskalniku, ki podpira Web Audio in upodabljanje zvoka brez predvajanja z uporabo obljub. Primer analizira tišino brez dostopa do mikrofona ali predvajanja. Pričakuj 128 frekvenčnih komponent z vrednostjo `0` in 256 vzorcev z vrednostjo `128` namesto začetnih vrednosti `42`.

Povezane lekcije

  • JavaScript · Lekcija 34 · Napredna · Različica: 4

Viri