AudioContext: resume() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die resume()-Methode der AudioContext-Schnittstelle setzt den Zeitverlauf in einem zuvor angehaltenen Audio-Kontext fort.

Diese Methode führt zu einer INVALID_STATE_ERR-Ausnahme, wenn sie auf einem OfflineAudioContext aufgerufen wird.

Syntax

js
resume()

Parameter

Keine.

Rückgabewert

Ein Promise, das aufgelöst wird, wenn der Kontext fortgesetzt wurde. Das Versprechen wird abgelehnt, wenn der Kontext bereits geschlossen wurde.

Beispiele

Der folgende Ausschnitt stammt aus unserem AudioContext-Zustände-Demo (sehen Sie es live.) Wenn die Suspendieren/Fortsetzen-Schaltfläche geklickt wird, wird der AudioContext.state abgefragt — wenn er running ist, wird suspend() aufgerufen; wenn er suspended ist, wird resume() aufgerufen. In jedem Fall wird die Textbeschriftung der Schaltfläche entsprechend aktualisiert, sobald das Versprechen aufgelöst wird.

js
susResBtn.onclick = () => {
  if (audioCtx.state === "running") {
    audioCtx.suspend().then(() => {
      susResBtn.textContent = "Resume context";
    });
  } else if (audioCtx.state === "suspended") {
    audioCtx.resume().then(() => {
      susResBtn.textContent = "Suspend context";
    });
  }
};

Spezifikationen

Specification
Web Audio API
# dom-audiocontext-resume

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch