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
- AnalyserNode
- AnalyserNode: fftSize property
- AnalyserNode: smoothingTimeConstant property
- AnalyserNode: frequencyBinCount property
- AnalyserNode: getByteFrequencyData() method
- AnalyserNode: getByteTimeDomainData() method
- AnalyserNode: minDecibels property
- AnalyserNode: maxDecibels property
- OfflineAudioContext: OfflineAudioContext() constructor
- OfflineAudioContext: startRendering() method
- ECMAScript 2024 Language Specification — TypedArray Objects