Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

AnalyserNode : spectre FFT et forme d’onde en octets

Réglez la taille de la fenêtre FFT et le lissage spectral, puis utilisez deux tableaux d’octets de tailles adaptées au spectre et à la forme d’onde.

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

Syntaxe

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 analyse un signal sans le modifier lorsqu’il le transmet. Ce nœud relève de l’API Web Audio, et non d’ECMAScript 2024 ; vérifiez sa disponibilité dans l’environnement cible.

fftSize est le nombre d’échantillons dans la fenêtre de la transformée de Fourier rapide (FFT). Sa valeur par défaut est 2048 ; seules les puissances de deux de 32 à 32768 incluses sont admises. Le mutateur convertit d’abord la valeur affectée en unsigned long selon les règles de Web IDL. Si la valeur obtenue n’est pas une taille autorisée, il déclenche une DOMException nommée IndexSizeError. Par exemple, affecter 256.5 réussit, car la valeur est convertie en 256. À fréquence d’échantillonnage fixe, une fenêtre plus grande couvre une durée plus longue et rapproche les raies spectrales. La propriété frequencyBinCount, en lecture seule, vaut toujours fftSize / 2.

smoothingTimeConstant pondère l’amplitude lissée précédente de chaque raie. Sa plage va de 0 à 1 inclus, et sa valeur par défaut est 0.8 ; une valeur finie hors plage déclenche IndexSizeError. À 0, l’analyse précédente n’a aucun effet ; à 1, les nouvelles données n’influencent pas le spectre lissé. Ce coefficient est sans unité, et non une durée en secondes. Il ne lisse pas la forme d’onde.

getByteFrequencyData(array) écrit les niveaux des raies dans un Uint8Array en convertissant les décibels en valeurs de 0 à 255 : un niveau inférieur ou égal à minDecibels donne 0, et un niveau supérieur ou égal à maxDecibels donne 255. Utilisez frequencyBinCount éléments. getByteTimeDomainData(array) écrit les échantillons successifs de la forme d’onde entre 0 et 255 ; 128 indique une amplitude nulle. Utilisez fftSize éléments pour la forme d’onde complète. Les deux méthodes renvoient undefined et écrasent le contenu du tableau fourni : s’il est trop court, des données sont perdues ; s’il est trop long, les éléments excédentaires restent inchangés. Réutilisez les tableaux entre les lectures et adaptez leur taille après toute modification de fftSize.

Exemples

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

Résultat

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

Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur qui prend en charge Web Audio et le rendu hors ligne par promesse. L’exemple analyse le silence sans accéder au microphone ni diffuser de son. Attendez-vous à 128 raies à `0` et 256 échantillons à `128`, à la place des valeurs initiales `42`.

Leçons associées

  • JavaScript · Leçon 34 · Avancé · Version : 4

Sources