KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

AudioContext — een audioverwerkingsgrafiek

AudioContext beheert een realtime-audiografiek. Het verbindt bronnen, analyse en uitvoer; voor het starten van de verwerking kan gebruikersinteractie nodig zijn.

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

Syntax

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 is een browser-API en geen onderdeel van ECMAScript. Als context een AudioContext-instantie is, maakt de aanroep context.createAnalyser() een analyser. De instantiemethode createAnalyser() en de instantie-eigenschappen state en destination worden geërfd van BaseAudioContext. context.destination is de uiteindelijke uitvoer van de grafiek.

Met context.createMediaElementSource(mediaElement) op een AudioContext-instantie leid je de audio van een media-element om naar de grafiek. Bewaar de gemaakte bron: hetzelfde element opnieuw koppelen is een fout. Bronnen van een andere oorsprong zonder de juiste CORS-toestemming produceren stilte.

Roep na gebruikersinteractie resume() aan op de AudioContext-instantie (bijvoorbeeld context.resume()) en wacht op de geretourneerde promise. De eigenschap state geeft de status van de context weer. resume() start het afspelen van het media-element niet. Gebruik close() wanneer je klaar bent. Het voorbeeld analyseert bewust stilte. Controleer of de API beschikbaar is in de doelbrowser; Node 24 toont dat niet aan.

Voorbeelden

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;
  }
};

Resultaat

running
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen