Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła