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: Dieses Feature ist verfügbar in Dedicated Web Workers.

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

js
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.

js
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