AudioDecoder: isConfigSupported() statische 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 isConfigSupported() statische Methode der AudioDecoder-Schnittstelle überprüft, ob die gegebene Konfiguration unterstützt wird (das heißt, ob AudioDecoder-Objekte erfolgreich mit der gegebenen Konfiguration konfiguriert werden können).

Syntax

AudioDecoder.isConfigSupported(config)

Parameter

config: Das Wörterbuchobjekt, das von AudioDecoder.configure akzeptiert wird.

Rückgabewert

Ein Promise, das mit einem Objekt aufgelöst wird, das folgende Mitglieder enthält:

supported: Ein boolescher Wert, der true ist, wenn die gegebene Konfiguration durch den Decoder unterstützt wird.
config: Eine Kopie der gegebenen Konfiguration mit allen vom Decoder erkannten Feldern.

Ausnahmen

TypeError: Wird geworfen, wenn die bereitgestellte config ungültig ist; das heißt, wenn sie keine erforderlichen Werte hat (wie ein leeres codec-Feld) oder ungültige Werte hat (wie eine negative sampleRate).

Beispiele

Das folgende Beispiel testet, ob der Browser mehrere Audiocodecs unterstützt.

const codecs = ["mp4a.40.2", "mp3", "alaw", "ulaw"];
const configs = [];
for (const codec of codecs) {
  configs.push({
    codec,
    sampleRate: 48000,
    numberOfChannels: 1,
    not_supported_field: 123,
  });
}
for (const config of configs) {
  const support = await AudioDecoder.isConfigSupported(config);
  console.log(
    `AudioDecoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

Spezifikationen

Specification
WebCodecs # dom-audiodecoder-isconfigsupported

Browser-Kompatibilität

BCD tables only load in the browser