AudioDecoder: configure()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Die configure()-Methode des AudioDecoder-Interfaces stellt eine Steuerungsnachricht in die Warteschlange, um den Audiodecoder für das Dekodieren von Datenblöcken zu konfigurieren.

Syntax

js
configure(config)

Parameter

config

Ein Wörterbuchobjekt, das die folgenden Mitglieder enthält:

codec

Ein String, der einen gültigen Codec-String enthält. Siehe "codecs"-Parameter für Details zur Konstruktion von Codec-Strings.

sampleRate

Eine Ganzzahl, die die Anzahl der Abtastungen pro Sekunde darstellt.

numberOfChannels

Eine Ganzzahl, die die Anzahl der Audiokanäle darstellt.

description Optional

Ein ArrayBuffer, ein TypedArray oder ein DataView, das eine Sequenz von codecspezifischen Bytes, häufig als Extradata bekannt, enthält.

Hinweis: Die Einträge im WebCodecs Codec Registry verweisen auf eine Spezifikation, die beschreibt, ob und wie das optionale description-Mitglied zu befüllen ist.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn das bereitgestellte config ungültig ist.

InvalidStateError DOMException

Wird ausgelöst, wenn der state "closed" ist.

NotSupportedError DOMException

Wird ausgelöst, wenn das bereitgestellte config gültig ist, aber der User-Agent keinen Codec bereitstellen kann, der dieses Profil dekodieren kann.

Beispiele

Im folgenden Beispiel wird der audioDecoder mit dem opus-Codec konfiguriert.

js
audioDecoder.configure({
  codec: "opus",
  sampleRate: 44100,
  numberOfChannels: 2,
});

Spezifikationen

Specification
WebCodecs
# dom-audiodecoder-configure

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
configure

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support