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
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
, einTypedArray
oder einDataView
, 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.
audioDecoder.configure({
codec: "opus",
sampleRate: 44100,
numberOfChannels: 2,
});
Spezifikationen
Specification |
---|
WebCodecs # dom-audiodecoder-configure |
Browser-Kompatibilität
BCD tables only load in the browser