CKTIS / JavaScript
AudioContext — graf za obdelavo zvoka
AudioContext upravlja zvočni graf v realnem času. Povezuje vire, analizo in izhod; za zagon obdelave je lahko potrebna interakcija uporabnika.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 API brskalnika in ni del ECMAScript. Če je context primerek AudioContext, klic context.createAnalyser() ustvari analizator. Metoda primerka createAnalyser() in lastnosti primerka state in destination so podedovane iz BaseAudioContext. context.destination je končni izhod grafa.
Klic context.createMediaElementSource(mediaElement) na primerku AudioContext preusmeri zvok predstavnostnega elementa v graf. Ustvarjeni vir ohrani: ponovna povezava istega elementa je napaka. Viri z drugega izvora brez ustrezne odobritve CORS ustvarijo tišino.
Po interakciji uporabnika pokliči metodo resume() na primerku AudioContext (na primer context.resume()) in počakaj, da se vrnjena obljuba izpolni. Lastnost state prikazuje stanje konteksta. resume() ne začne predvajanja predstavnostnega elementa. Ko končaš, uporabi close(). Primer namenoma analizira tišino. Razpoložljivost API-ja preveri v ciljnem brskalniku; Node 24 je ne potrjuje.
Primeri
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;
}
};Rezultat
running true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.