Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

AudioContext — graf za obradu zvuka

AudioContext upravlja zvučnim grafom u stvarnom vremenu. Povezuje izvore, analizu i izlaz; za pokretanje obrade može biti potrebna interakcija korisnika.

Verzija: 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 preglednika, a ne dio ECMAScripta. Ako je context instanca sučelja AudioContext, poziv context.createAnalyser() stvara analizator. Metoda instance createAnalyser() i svojstva instance state i destination nasljeđuju se iz BaseAudioContext. context.destination je završni izlaz grafa.

Poziv context.createMediaElementSource(mediaElement) na instanci AudioContext preusmjerava zvuk medijskog elementa u graf. Zadržite stvoreni izvor: ponovno povezivanje istog elementa pogreška je. Resursi s drugog izvorišta bez odgovarajućeg odobrenja CORS-a proizvode tišinu.

Nakon interakcije korisnika pozovite metodu resume() na instanci AudioContext (primjerice, context.resume()) i pričekajte da se vraćeno obećanje ispuni. Svojstvo state prikazuje stanje konteksta. resume() ne pokreće reprodukciju medijskog elementa. Kada završite, upotrijebite close(). Primjer namjerno analizira tišinu. Provjerite dostupnost API-ja u ciljnom pregledniku; Node 24 to ne potvrđuje.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori