Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

AnalyserNode — zvukové spektrum a priebeh

AnalyserNode sprístupňuje frekvenčné spektrum a vzorky priebehu bez zmeny prechádzajúceho zvuku.

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

Syntax

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

AnalyserNode analyzuje zvuk bez toho, aby ho menil. Patrí do Web Audio API, nie do ECMAScriptu; Node 24 nepotvrdzuje podporu v prehliadači. Overte dostupnosť použitých konštruktorov.

AnalyserNode.fftSize nastavuje veľkosť FFT: mocninu dvoch od 32 do 32768 vrátane, predvolená hodnota je 2048. Väčšia veľkosť zlepšuje frekvenčné rozlíšenie za cenu dlhšieho okna. Vlastnosť iba na čítanie AnalyserNode.frequencyBinCount sa rovná fftSize / 2. Ak je veľkosť po konverzii podľa Web IDL na typ unsigned long neplatná, vyvolá sa výnimka IndexSizeError. Konverzia môže odrezať zlomkovú časť a dať platnú veľkosť: napríklad z 32.5 vznikne 32.

AnalyserNode.smoothingTimeConstant vyhladzuje spektrum: rozsah 0–1, predvolená hodnota 0.8; hodnota 0 vyhladzovanie vypne. Priebeh nevyhladzuje. Konečná hodnota mimo rozsahu 0–1 vyvolá IndexSizeError, kým nekonečná hodnota alebo NaN vyvolá TypeError už pri konverzii podľa Web IDL, ešte pred kontrolou rozsahu.

AnalyserNode.getByteFrequencyData(array) naplní Uint8Array hodnotami 0–255 škálovanými pomocou minDecibels a maxDecibels, nie v hertzoch. AnalyserNode.getByteTimeDomainData(array) zapíše vzorky priebehu: ticho zodpovedá hodnote 128. Veľkosti bufferov sú frequencyBinCount a fftSize; kratšie buffery údaje skrátia a nadbytočné prvky zostanú nezmenené.

Príklady

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);

Výsledok

32 16 32

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje