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 der AudioDecoder-Schnittstelle reiht eine Steuerungsnachricht ein, um den Audiodecoder zum Dekodieren von Chunks zu konfigurieren.

Syntax

js
configure(config)

Parameter

config

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

codec

Ein String mit einem gültigen Codec-String. Einzelheiten zur Erstellung von Codec-Strings finden Sie im "codecs"-Parameter.

sampleRate

Eine Ganzzahl, die die Anzahl der Frame-Samples 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 codec-spezifischen Bytes enthält, die häufig als Extradata bekannt sind.

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

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

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

InvalidStateError DOMException

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

NotSupportedError DOMException

Wird ausgelöst, wenn die bereitgestellte 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