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.