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

Syntax

AudioEncoder.isConfigSupported(config)

Parameter

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

Rückgabewert

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

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

Ausnahmen

TypeError: Wird ausgelöst, wenn die bereitgestellte config ungültig ist; das heißt, wenn erforderliche Werte fehlen (wie ein leeres codec-Feld) oder ungültige Werte vorhanden sind (wie eine negative sampleRate).

Beispiele

Das folgende Beispiel prüft, 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 AudioEncoder.isConfigSupported(config);
  console.log(
    `AudioEncoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

Spezifikationen

Specification
WebCodecs # dom-audioencoder-isconfigsupported

Browser-Kompatibilität

BCD tables only load in the browser