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

CKTIS / JavaScript

AudioContext — un graphe de traitement audio

AudioContext gère un graphe audio en temps réel. Il relie les sources, l’analyse et la sortie ; le démarrage du traitement peut nécessiter une interaction de l’utilisateur.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const context = new AudioContext();
const analyser = context.createAnalyser();
const source = context.createMediaElementSource(mediaElement);
source.connect(analyser);
analyser.connect(context.destination);
await context.resume();
console.log(context.state);

AudioContext est une API de navigateur, et non une partie d’ECMAScript. Si context est une instance d’AudioContext, l’appel context.createAnalyser() crée un analyseur. La méthode d’instance createAnalyser() et les propriétés d’instance state et destination sont héritées de BaseAudioContext. context.destination est la sortie finale du graphe.

L’appel context.createMediaElementSource(mediaElement) sur une instance d’AudioContext redirige le son d’un élément multimédia vers le graphe. Conservez la source créée : associer de nouveau le même élément est une erreur. Les ressources provenant d’une autre origine et dépourvues d’autorisation CORS appropriée produisent du silence.

Après une interaction de l’utilisateur, appelez resume() sur l’instance d’AudioContext (par exemple, context.resume()) et attendez la résolution de la promesse renvoyée. La propriété state indique l’état du contexte. resume() ne démarre pas la lecture de l’élément multimédia. Utilisez close() lorsque vous avez terminé. L’exemple analyse volontairement le silence. Vérifiez la disponibilité de l’API dans le navigateur cible ; Node 24 ne permet pas de l’établir.

Exemples

const button = document.createElement('button');
button.textContent = 'Run';
document.body.append(button);

button.onclick = async () => {
  button.disabled = true;
  let context;
  try {
    context = new AudioContext();
    const media = new Audio();
    const source = context.createMediaElementSource(media);
    const analyser = context.createAnalyser();
    source.connect(analyser);
    analyser.connect(context.destination);
    await context.resume();
    const samples = new Float32Array(analyser.fftSize);
    analyser.getFloatTimeDomainData(samples);
    console.log(context.state);
    console.log(samples.every(value => value === 0));
  } catch (error) {
    console.error(error);
  } finally {
    if (context) await context.close();
    button.disabled = false;
  }
};

Résultat

running
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources