CKTIS / JavaScript
AudioContext — graf zpracování zvuku
AudioContext spravuje zvukový graf v reálném čase. Propojuje zdroje, analýzu a výstup; spuštění zpracování může vyžadovat interakci uživatele.
Verze: 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 je rozhraní API prohlížeče, nikoli součást ECMAScriptu. Je-li context instancí AudioContext, volání context.createAnalyser() vytvoří analyzátor. Instanční metoda createAnalyser() a instanční vlastnosti state a destination jsou zděděné z BaseAudioContext. context.destination je konečný výstup grafu.
Volání context.createMediaElementSource(mediaElement) na instanci AudioContext přesměruje zvuk mediálního prvku do grafu. Vytvořený zdroj si ponechte: opětovné přiřazení stejného prvku je chyba. Zdroje z jiného původu bez odpovídajícího oprávnění CORS produkují ticho.
Po interakci uživatele zavolejte metodu resume() na instanci AudioContext (například context.resume()) a počkejte na splnění vráceného příslibu. Vlastnost state udává stav kontextu. resume() nespouští přehrávání mediálního prvku. Po dokončení použijte close(). Příklad záměrně analyzuje ticho. Dostupnost API ověřte v cílovém prohlížeči; Node 24 ji nepotvrzuje.
Příklady
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;
}
};Výsledek
running true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.