WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AnalyserNode — Audiospektrum und Wellenform

AnalyserNode stellt Frequenzspektrum und Wellenform-Samples bereit, ohne das durchlaufende Audiosignal zu verändern.

Version: 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 analysiert Audio, ohne es zu verändern. Dies ist die Web Audio API, nicht ECMAScript; Node 24 belegt keine Browserunterstützung. Prüfe, ob die verwendeten Konstruktoren verfügbar sind.

AnalyserNode.fftSize legt die FFT-Größe fest: eine Zweierpotenz von 32 bis einschließlich 32768, Standardwert 2048. Größere Größen verbessern die Frequenzauflösung, erfordern aber ein längeres Zeitfenster. Das schreibgeschützte AnalyserNode.frequencyBinCount entspricht fftSize / 2. Ist die Größe nach der Web-IDL-Konvertierung in unsigned long ungültig, wird IndexSizeError ausgelöst. Die Konvertierung kann die Nachkommastellen abschneiden und so eine gültige Größe ergeben: Aus 32.5 wird zum Beispiel 32.

AnalyserNode.smoothingTimeConstant glättet das Spektrum: Wertebereich 0–1, Standardwert 0.8; 0 deaktiviert die Glättung. Die Wellenform wird dadurch nicht geglättet. Ein endlicher Wert außerhalb des Bereichs 0–1 löst IndexSizeError aus. Ein nicht endlicher Wert wie NaN löst dagegen bereits bei der Web-IDL-Konvertierung TypeError aus, noch vor der Bereichsprüfung.

AnalyserNode.getByteFrequencyData(array) füllt ein Uint8Array mit Werten von 0–255, skaliert anhand von minDecibels und maxDecibels, nicht in Hertz. AnalyserNode.getByteTimeDomainData(array) schreibt Wellenform-Samples: Stille entspricht dem Wert 128. Die Puffergrößen betragen jeweils frequencyBinCount und fftSize; kürzere Puffer schneiden Daten ab, überschüssige Elemente bleiben unverändert.

Beispiele

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

Ergebnis

32 16 32

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen