AudioDecoder: configure() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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
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.
descriptionOptional-
Ein
ArrayBuffer, einTypedArrayoder einDataView, 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
configungültig ist. InvalidStateErrorDOMException-
Wird ausgelöst, wenn der
state"closed"ist. NotSupportedErrorDOMException-
Wird ausgelöst, wenn die bereitgestellte
configgü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.
audioDecoder.configure({
codec: "opus",
sampleRate: 44100,
numberOfChannels: 2,
});
Spezifikationen
| Spezifikation |
|---|
| WebCodecs # dom-audiodecoder-configure |