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