KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen