Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

AudioContext — graf przetwarzania dźwięku

AudioContext zarządza grafem dźwięku w czasie rzeczywistym. Łączy źródła, analizę i wyjście; uruchomienie może wymagać interakcji użytkownika.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

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 to przeglądarkowe API, nie część ECMAScript. Jeśli context jest instancją AudioContext, wywołanie context.createAnalyser() tworzy analizator. Metoda createAnalyser() oraz właściwości instancji state i destination są dziedziczone z BaseAudioContext. context.destination jest końcowym wyjściem grafu.

Wywołanie context.createMediaElementSource(mediaElement) na instancji AudioContext przekierowuje dźwięk elementu multimedialnego do grafu. Zachowaj utworzone źródło: ponowne powiązanie tego samego elementu jest błędem. Zasoby obcego pochodzenia bez odpowiedniej autoryzacji CORS dają ciszę.

Po interakcji użytkownika wywołaj metodę resume() na instancji AudioContext (np. context.resume()) i poczekaj na spełnienie zwróconej obietnicy. Właściwość state wskazuje stan kontekstu. resume() nie uruchamia odtwarzania elementu. Po zakończeniu użyj close(). Przykład celowo analizuje ciszę. Sprawdź dostępność API w docelowej przeglądarce; Node 24 jej nie potwierdza.

Przykłady

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;
  }
};

Wynik

running
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła