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 des AudioDecoder
-Interfaces stellt eine Steuerungsnachricht in die Warteschlange, um den Audiodecoder für das Dekodieren von Datenblöcken zu konfigurieren.
Syntax
configure(config)
Parameter
config
-
Ein Wörterbuchobjekt, das die folgenden Mitglieder enthält:
codec
-
Ein String, der einen gültigen Codec-String enthält. Siehe "codecs"-Parameter für Details zur Konstruktion von Codec-Strings.
sampleRate
-
Eine Ganzzahl, die die Anzahl der Abtastungen pro Sekunde darstellt.
numberOfChannels
-
Eine Ganzzahl, die die Anzahl der Audiokanäle darstellt.
description
Optional-
Ein
ArrayBuffer
, einTypedArray
oder einDataView
, das eine Sequenz von codecspezifischen Bytes, häufig als Extradata bekannt, enthält.
Hinweis:
Die Einträge im WebCodecs Codec Registry verweisen auf eine Spezifikation, die beschreibt, ob und wie das optionale description
-Mitglied zu befüllen ist.
Rückgabewert
Keiner (undefined
).
Ausnahmen
TypeError
-
Wird ausgelöst, wenn das bereitgestellte
config
ungültig ist. InvalidStateError
DOMException
-
Wird ausgelöst, wenn der
state
"closed"
ist. NotSupportedError
DOMException
-
Wird ausgelöst, wenn das bereitgestellte
config
gültig ist, aber der User-Agent keinen Codec bereitstellen kann, der dieses Profil dekodieren kann.
Beispiele
Im folgenden Beispiel wird der audioDecoder
mit dem opus
-Codec konfiguriert.
audioDecoder.configure({
codec: "opus",
sampleRate: 44100,
numberOfChannels: 2,
});
Spezifikationen
Specification |
---|
WebCodecs # dom-audiodecoder-configure |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
configure |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support