CKTIS / JavaScript
AudioContext — graf spracovania zvuku
AudioContext spravuje zvukový graf v reálnom čase. Prepája zdroje, analýzu a výstup; spustenie spracovania môže vyžadovať interakciu používateľa.
Verzia: 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 je rozhranie API prehliadača, nie súčasť ECMAScriptu. Ak je context inštanciou AudioContext, volanie context.createAnalyser() vytvorí analyzátor. Inštančná metóda createAnalyser() a inštančné vlastnosti state a destination sú zdedené z BaseAudioContext. context.destination je konečný výstup grafu.
Volanie context.createMediaElementSource(mediaElement) na inštancii AudioContext presmeruje zvuk mediálneho prvku do grafu. Vytvorený zdroj si ponechajte: opätovné priradenie toho istého prvku je chyba. Zdroje z iného pôvodu bez príslušného oprávnenia CORS produkujú ticho.
Po interakcii používateľa zavolajte metódu resume() na inštancii AudioContext (napríklad context.resume()) a počkajte na splnenie vráteného prísľubu. Vlastnosť state uvádza stav kontextu. resume() nespúšťa prehrávanie mediálneho prvku. Po skončení použite close(). Príklad zámerne analyzuje ticho. Dostupnosť API overte v cieľovom prehliadači; Node 24 ju nepotvrdzuje.
Prí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ýsledok
running true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.