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.