CKTIS / JavaScript
AnalyserNode — widmo i przebieg dźwięku
AnalyserNode udostępnia widmo częstotliwości i próbki przebiegu, nie zmieniając przesyłanego dźwięku.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analizuje dźwięk bez jego modyfikacji. To Web Audio API, nie ECMAScript; obecność Node 24 nie potwierdza obsługi w przeglądarce. Sprawdź dostępność używanych konstruktorów.
AnalyserNode.fftSize określa rozmiar FFT: potęga dwójki od 32 do 32768, domyślnie 2048. Większy rozmiar poprawia rozdzielczość częstotliwości kosztem dłuższego okna. AnalyserNode.frequencyBinCount jest tylko do odczytu i wynosi fftSize / 2. Jeśli po konwersji Web IDL na typ unsigned long rozmiar jest niedozwolony, zgłaszany jest IndexSizeError. Konwersja może odrzucić część ułamkową i dać prawidłowy rozmiar: na przykład 32.5 zmienia się w 32.
AnalyserNode.smoothingTimeConstant wygładza widmo: zakres 0–1, domyślnie 0.8; 0 wyłącza wygładzanie. Nie wygładza przebiegu czasowego. Wartość skończona spoza zakresu 0–1 powoduje IndexSizeError, natomiast wartość nieskończona lub NaN powoduje TypeError podczas konwersji Web IDL, jeszcze przed sprawdzeniem zakresu.
AnalyserNode.getByteFrequencyData(array) wypełnia Uint8Array wartościami 0–255 skalowanymi przez minDecibels i maxDecibels, nie hercami. AnalyserNode.getByteTimeDomainData(array) zapisuje przebieg: cisza odpowiada 128. Rozmiary buforów to odpowiednio frequencyBinCount i fftSize; krótszy bufor ucina dane, nadmiarowe elementy pozostają niezmienione.
Przykłady
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);Wynik
32 16 32
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.