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

CKTIS / JavaScript

AnalyserNode — zvočni spekter in valovna oblika

AnalyserNode omogoča dostop do frekvenčnega spektra in vzorcev valovne oblike, ne da bi spreminjal zvok, ki poteka skozenj.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });

AnalyserNode analizira zvok, ne da bi ga spreminjal. Je del Web Audio API, ne ECMAScripta; Node 24 ne potrjuje podpore v brskalniku. Preverite, ali so uporabljeni konstruktorji na voljo.

AnalyserNode.fftSize določa velikost FFT: potenco števila dve od 32 do vključno 32768; privzeta vrednost je 2048. Večja velikost izboljša frekvenčno ločljivost, vendar zahteva daljše okno. Lastnost samo za branje AnalyserNode.frequencyBinCount je enaka fftSize / 2. Če je velikost po pretvorbi po pravilih Web IDL v tip unsigned long neveljavna, se sproži izjema IndexSizeError. Pretvorba lahko odreže ulomljeni del in da veljavno velikost: na primer, iz 32.5 nastane 32.

AnalyserNode.smoothingTimeConstant gladi spekter: obseg 0–1, privzeta vrednost 0.8; 0 glajenje izklopi. Valovne oblike ne gladi. Končna vrednost zunaj območja 0–1 sproži IndexSizeError, neskončna vrednost ali NaN pa sproži TypeError že med pretvorbo po pravilih Web IDL, še pred preverjanjem območja.

AnalyserNode.getByteFrequencyData(array) napolni Uint8Array z vrednostmi 0–255, skaliranimi z minDecibels in maxDecibels, ne v hercih. AnalyserNode.getByteTimeDomainData(array) zapiše vzorce valovne oblike: tišina ustreza vrednosti 128. Velikosti medpomnilnikov sta frequencyBinCount in fftSize; krajši medpomnilniki podatke odrežejo, odvečni elementi pa ostanejo nespremenjeni.

Primeri

const context = new OfflineAudioContext(1, 128, 48000);
const analyser = new AnalyserNode(context, {
  fftSize: 32,
  smoothingTimeConstant: 0
});
const frequency = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(frequency);
analyser.getByteTimeDomainData(waveform);
console.log(analyser.fftSize, frequency.length, waveform.length);

Rezultat

32 16 32

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri