WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

AudioContext — ein Audioverarbeitungsgraph

AudioContext verwaltet einen Echtzeit-Audiographen. Er verbindet Quellen, Analyse und Ausgabe; zum Starten der Verarbeitung kann eine Interaktion durch die nutzende Person erforderlich sein.

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

Syntax

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 ist eine Browser-API und kein Bestandteil von ECMAScript. Ist context eine AudioContext-Instanz, erstellt der Aufruf context.createAnalyser() einen Analysator. Die Instanzmethode createAnalyser() und die Instanzeigenschaften state und destination werden von BaseAudioContext geerbt. context.destination ist der endgültige Ausgang des Graphen.

Der Aufruf context.createMediaElementSource(mediaElement) auf einer AudioContext-Instanz leitet den Ton eines Medienelements in den Graphen um. Bewahre die erstellte Quelle auf: Dasselbe Element erneut zuzuordnen, ist ein Fehler. Ressourcen von anderen Ursprüngen ohne entsprechende CORS-Berechtigung führen zu Stille.

Rufe nach einer Nutzerinteraktion resume() auf der AudioContext-Instanz auf (zum Beispiel context.resume()) und warte auf das zurückgegebene Promise. Die Eigenschaft state gibt den Status des Kontexts an. resume() startet nicht die Wiedergabe des Medienelements. Verwende nach Abschluss close(). Das Beispiel analysiert absichtlich Stille. Prüfe die Verfügbarkeit der API im Zielbrowser; Node 24 belegt sie nicht.

Beispiele

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

Ergebnis

running
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen