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 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, ein TypedArray oder ein DataView, 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