CKTIS / JavaScript
AnalyserNode: spettro FFT e forma d’onda in byte
Imposta la finestra FFT e la media temporale dello spettro, poi dimensiona due array di byte distinti per lo spettro e la forma d’onda.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 analizza un segnale senza modificare l’audio che lo attraversa. Fa parte della Web Audio API, non di ECMAScript 2024; verifica che sia disponibile nell’ambiente di esecuzione di destinazione.
fftSize è il numero di campioni nella finestra della trasformata rapida di Fourier (FFT). Il valore predefinito è 2048; sono ammesse le potenze di due da 32 a 32768 inclusi. Il setter converte prima il valore assegnato nel tipo unsigned long secondo le regole di Web IDL. Se il valore ottenuto non è una dimensione ammessa, il setter genera una DOMException denominata IndexSizeError. Ad esempio, l’assegnazione di 256.5 riesce perché il valore viene convertito in 256. A frequenza di campionamento fissa, una finestra più ampia copre un intervallo di tempo maggiore e riduce la distanza tra i bin di frequenza. La proprietà di sola lettura frequencyBinCount vale sempre fftSize / 2.
smoothingTimeConstant assegna un peso alla magnitudine già mediata di ogni bin nella precedente analisi. L’intervallo va da 0 a 1 inclusi e il valore predefinito è 0.8; un valore finito fuori intervallo genera IndexSizeError. Con 0 l’analisi precedente non influisce sul risultato; con 1 i nuovi dati non influiscono sullo spettro mediato. È un peso adimensionale, non una durata in secondi. Non attenua le variazioni della forma d’onda.
getByteFrequencyData(array) scrive i livelli dei bin in un Uint8Array, convertendo i decibel in valori da 0 a 255: i livelli pari o inferiori a minDecibels danno 0, quelli pari o superiori a maxDecibels danno 255. Usa frequencyBinCount elementi. getByteTimeDomainData(array) scrive i campioni consecutivi della forma d’onda da 0 a 255; 128 indica ampiezza zero. Usa fftSize elementi per la forma d’onda completa. Entrambi i metodi restituiscono undefined e sovrascrivono l’array passato: se è troppo corto si perdono dati, mentre gli elementi in eccesso rimangono invariati. Riutilizza gli array tra le letture e adattane le dimensioni dopo aver modificato fftSize.
Esempi
<!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>Risultato
spectrum: 128 bins; all 0: true waveform: 256 samples; all 128: true
Salva l’esempio come file HTML e aprilo in un browser che supporti Web Audio e il rendering offline basato su promesse. L’esempio analizza il silenzio senza accedere al microfono né riprodurre audio. Il risultato atteso è di 128 bin a `0` e 256 campioni a `128`, al posto dei valori iniziali `42`.
Lezioni correlate
- JavaScript · Lezione 34 · Avanzato · Versione: 4
Fonti
- 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