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
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
| Specification |
|---|
| WebCodecs # dom-audiodecoder-configure |
Browser-Kompatibilität
Loading…