Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri