CKTIS / JavaScript
AnalyserNode — audiospectrum en golfvorm
AnalyserNode biedt frequentiespectrum- en golfvormsamples zonder het passerende audiosignaal te wijzigen.
Versie: 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 analyseert audio zonder deze te wijzigen. Dit is onderdeel van de Web Audio API, niet van ECMAScript; Node 24 bevestigt geen browserondersteuning. Controleer of de gebruikte constructors beschikbaar zijn.
AnalyserNode.fftSize stelt de FFT-grootte in: een macht van twee van 32 tot en met 32768, standaard 2048. Grotere waarden verbeteren de frequentieresolutie, maar vereisen een langer venster. De alleen-lezen eigenschap AnalyserNode.frequencyBinCount is gelijk aan fftSize / 2. Als de grootte na de Web IDL-conversie naar unsigned long ongeldig is, wordt IndexSizeError gegooid. De conversie kan het deel achter de komma afkappen en zo een geldige grootte opleveren: 32.5 wordt bijvoorbeeld 32.
AnalyserNode.smoothingTimeConstant maakt het spectrum vloeiender: bereik 0–1, standaard 0.8; 0 schakelt de afvlakking uit. De golfvorm wordt niet afgevlakt. Een eindige waarde buiten het bereik 0–1 veroorzaakt IndexSizeError, maar een niet-eindige waarde zoals NaN veroorzaakt al tijdens de Web IDL-conversie een TypeError, voordat het bereik wordt gecontroleerd.
AnalyserNode.getByteFrequencyData(array) vult een Uint8Array met waarden van 0–255, geschaald met minDecibels en maxDecibels, niet in hertz. AnalyserNode.getByteTimeDomainData(array) schrijft golfvormsamples: stilte komt overeen met 128. De buffergroottes zijn respectievelijk frequencyBinCount en fftSize; kortere buffers kappen gegevens af en overtollige elementen blijven ongewijzigd.
Voorbeelden
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);Resultaat
32 16 32
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.