CKTIS / JavaScript
AnalyserNode: FFT-spectrum en golfvorm als bytes
Stel de FFT-venstergrootte en spectrumafvlakking in en kies aparte byte-arrays met de juiste lengte voor het spectrum en de golfvorm.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 analyseert een signaal zonder het doorgestuurde audiosignaal te veranderen. Het knooppunt hoort bij de Web Audio API, niet bij ECMAScript 2024. Controleer of je doelomgeving het ondersteunt.
fftSize is het aantal samples in het venster van de snelle Fouriertransformatie (FFT). De standaardwaarde is 2048; alleen machten van twee van 32 tot en met 32768 zijn toegestaan. De setter zet de toegewezen waarde eerst volgens Web IDL om naar unsigned long. Als het resultaat geen toegestane grootte is, werpt de setter een DOMException met de naam IndexSizeError. Zo slaagt het toewijzen van 256.5 omdat de waarde wordt omgezet naar 256. Bij een vaste samplefrequentie beslaat een groter venster meer tijd en liggen de frequentiebins dichter bij elkaar. De alleen-lezen eigenschap frequencyBinCount is altijd gelijk aan fftSize / 2.
smoothingTimeConstant bepaalt het gewicht van de vorige afgevlakte magnitude van iedere frequentiebin. Het bereik loopt van 0 tot en met 1, met 0.8 als standaardwaarde; een eindige waarde buiten het bereik veroorzaakt IndexSizeError. Bij 0 heeft de vorige analyse geen invloed; bij 1 hebben nieuwe gegevens geen invloed op het afgevlakte spectrum. Het is een gewicht zonder eenheid, geen duur in seconden. Het vlakt de golfvorm niet af.
getByteFrequencyData(array) schrijft de binniveaus naar een Uint8Array en zet decibels om naar waarden van 0 tot 255: op of onder minDecibels wordt het 0, op of boven maxDecibels wordt het 255. Gebruik frequencyBinCount elementen. getByteTimeDomainData(array) schrijft opeenvolgende samples van de golfvorm met waarden van 0 tot 255; 128 staat voor amplitude nul. Gebruik fftSize elementen voor de volledige golfvorm. Beide methoden geven undefined terug en overschrijven de opgegeven array: in een te korte array gaan gegevens verloren, in een te lange array blijven de extra elementen ongewijzigd. Hergebruik de arrays tussen uitlezingen en pas de lengtes aan als fftSize verandert.
Voorbeelden
<!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>Resultaat
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Sla het voorbeeld op als HTML-bestand en open het in een browser met ondersteuning voor Web Audio en offline rendering op basis van promises. Het voorbeeld analyseert stilte zonder microfoontoegang of afspelen. Verwacht 128 bins met `0` en 256 samples met `128`, in plaats van de beginwaarden `42`.
Gerelateerde lessen
- JavaScript · Les 34 · Gevorderd · Versie: 4
Bronnen
- 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