Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

AnalyserNode: widmo FFT i przebieg czasowy w bajtach

Ustaw rozmiar FFT i wygładzanie widma, a następnie dobierz osobne tablice bajtów do odczytu widma częstotliwościowego i przebiegu czasowego.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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 analizuje sygnał, nie zmieniając go na wyjściu. Należy do Web Audio API, a nie do ECMAScriptu 2024; sprawdź dostępność interfejsu w docelowym środowisku.

fftSize to liczba próbek w oknie szybkiej transformaty Fouriera (FFT). Domyślnie wynosi 2048; dopuszczalne są potęgi dwójki od 32 do 32768 włącznie. Setter najpierw konwertuje przypisaną wartość na typ unsigned long zgodnie z Web IDL. Jeśli wynik konwersji nie jest jednym z dopuszczalnych rozmiarów, setter zgłasza DOMException o nazwie IndexSizeError. Na przykład przypisanie 256.5 powiedzie się, ponieważ po konwersji otrzymamy 256. Przy stałej częstotliwości próbkowania większe okno obejmuje dłuższy odcinek sygnału i daje mniejszy odstęp między prążkami. Właściwość frequencyBinCount jest tylko do odczytu i zawsze wynosi fftSize / 2.

smoothingTimeConstant określa wagę poprzedniej wartości przy wygładzaniu amplitudy każdego prążka widma. Zakres to od 0 do 1 włącznie, domyślnie 0.8; skończona wartość spoza zakresu powoduje IndexSizeError. Przy 0 poprzednia analiza nie wpływa na wynik, a przy 1 nowe dane nie wpływają na wygładzane widmo. To współczynnik bez jednostki, nie czas w sekundach. Nie wygładza przebiegu czasowego.

getByteFrequencyData(array) zapisuje do Uint8Array poziomy prążków przeskalowane z decybeli do zakresu 0–255: poziomy równe lub niższe od minDecibels dają 0, a równe lub wyższe od maxDecibels dają 255. Użyj frequencyBinCount elementów. getByteTimeDomainData(array) zapisuje kolejne próbki przebiegu w zakresie 0–255, gdzie 128 oznacza amplitudę zerową. Do pełnego odczytu użyj fftSize elementów. Obie metody zwracają undefined i nadpisują przekazaną tablicę: przy zbyt krótkiej część danych przepada, a w zbyt długiej nadmiarowe elementy pozostają bez zmian. Używaj tablic ponownie między odczytami i dopasuj ich długości po zmianie fftSize.

Przykłady

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

Wynik

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

Zapisz przykład jako plik HTML i otwórz go w przeglądarce obsługującej Web Audio i renderowanie offline oparte na obietnicach. Przykład analizuje ciszę, bez dostępu do mikrofonu i bez odtwarzania. Oczekiwany wynik to 128 prążków o wartości `0` i 256 próbek o wartości `128`, zamiast początkowych wartości `42`.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4

Źródła