WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AnalyserNode: FFT-Spektrum und Wellenform als Bytes

Lege FFT-Fenstergröße und Spektralglättung fest und dimensioniere getrennte Byte-Arrays für Frequenzbins und Abtastwerte im Zeitbereich.

Version: 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 analysiert ein Signal, ohne es bei der Durchleitung zu verändern. Der Knoten gehört zur Web Audio API, nicht zu ECMAScript 2024. Prüfe, ob deine Zielumgebung ihn unterstützt.

fftSize ist die Anzahl der Abtastwerte im Fenster der schnellen Fourier-Transformation (FFT). Der Standardwert ist 2048; zulässig sind Zweierpotenzen von 32 bis einschließlich 32768. Der Setter wandelt den zugewiesenen Wert zunächst gemäß Web IDL in unsigned long um. Ergibt die Umwandlung keine zulässige Größe, löst der Setter eine DOMException namens IndexSizeError aus. Die Zuweisung von 256.5 gelingt beispielsweise, weil der Wert in 256 umgewandelt wird. Bei gleicher Abtastrate deckt ein größeres Fenster mehr Zeit ab und verringert den Abstand zwischen den Frequenzbins. Die schreibgeschützte Eigenschaft frequencyBinCount entspricht stets fftSize / 2.

smoothingTimeConstant gewichtet den vorherigen geglätteten Betrag jedes Frequenzbins. Der Bereich reicht einschließlich der Grenzen von 0 bis 1, der Standardwert ist 0.8; ein endlicher Wert außerhalb des Bereichs löst IndexSizeError aus. Bei 0 hat die vorherige Analyse keinen Einfluss, bei 1 haben neue Daten keinen Einfluss auf das geglättete Spektrum. Das Gewicht ist dimensionslos, keine Dauer in Sekunden. Die Wellenform wird dadurch nicht geglättet.

getByteFrequencyData(array) schreibt die Binpegel als Werte von 0 bis 255 in ein Uint8Array: Pegel bis einschließlich minDecibels ergeben 0, Pegel ab maxDecibels ergeben 255. Verwende frequencyBinCount Elemente. getByteTimeDomainData(array) schreibt aufeinanderfolgende Abtastwerte von 0 bis 255; 128 steht für die Amplitude null. Verwende fftSize Elemente für die vollständige Wellenform. Beide Methoden geben undefined zurück und überschreiben das übergebene Array: Ist es zu kurz, gehen Daten verloren; ist es zu lang, bleiben die überzähligen Elemente unverändert. Verwende die Arrays bei weiteren Abfragen erneut und passe ihre Länge nach einer Änderung von fftSize an.

Beispiele

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

Ergebnis

spectrum: 128 bins; all 0: true
waveform: 256 samples; all 128: true

Speichere das Beispiel als HTML-Datei und öffne sie in einem Browser, der Web Audio und Promise-basiertes Offline-Rendering unterstützt. Das Beispiel analysiert Stille ohne Mikrofonzugriff oder Wiedergabe. Erwartet werden 128 Bins mit `0` und 256 Abtastwerte mit `128` anstelle der anfänglichen Werte `42`.

Zugehörige Lektionen

  • JavaScript · Lektion 34 · Fortgeschritten · Version: 4

Quellen