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: Dieses Feature ist verfügbar in Dedicated Web Workers.

Die configure() Methode der AudioDecoder-Schnittstelle stellt eine Steuerungsnachricht in die Warteschlange, um den Audiodecoder für das Dekodieren von Chunks zu konfigurieren.

Syntax

js
configure(config)

Parameter

config

Ein Wörterbuch-Objekt, das die folgenden Mitglieder enthält:

codec

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

sampleRate

Eine ganze Zahl, die die Anzahl der Rahmenproben pro Sekunde darstellt.

numberOfChannels

Eine ganze Zahl, die die Anzahl der Audiokanäle darstellt.

description Optional

Ein ArrayBuffer, ein TypedArray oder ein DataView, das eine Sequenz von codecspezifischen Bytes enthält, allgemein bekannt als extradata.

Hinweis: Die Registrierung in der WebCodecs Codec Registry verweist auf eine Spezifikation, die festlegt, ob und wie das optionale description-Element ausgefüllt werden muss.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

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

InvalidStateError DOMException

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

NotSupportedError DOMException

Wird ausgelöst, wenn das angegebene config gültig ist, aber der Benutzeragent keinen Codec bereitstellen kann, der dieses Profil dekodieren kann.

Beispiele

Das folgende Beispiel konfiguriert den audioDecoder mit dem opus Codec.

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

Spezifikationen

Specification
WebCodecs
# dom-audiodecoder-configure

Browser-Kompatibilität

BCD tables only load in the browser