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

Syntax

VideoDecoder.isConfigSupported(config)

Parameter

config: Das Wörterbuch-Objekt, das von VideoDecoder.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 Decoder unterstützt wird.
config: Eine Kopie der gegebenen Konfiguration mit allen vom Decoder 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 wenn ungültige Werte vorhanden sind (wie z. B. eine negative codedWidth).

Beispiele

Das folgende Beispiel testet, ob der Browser beschleunigte und nicht beschleunigte Versionen mehrerer Video-Codecs unterstützt.

const codecs = [
  "avc1.42001E",
  "hvc1.1.6.L123.00",
  "vp8",
  "vp09.00.10.08",
  "av01.0.04M.08",
];
const accelerations = ["prefer-hardware", "prefer-software"];

const configs = [];
for (const codec of codecs) {
  for (const acceleration of accelerations) {
    configs.push({
      codec,
      hardwareAcceleration: acceleration,
      codedWidth: 1280,
      codedHeight: 720,
      not_supported_field: 123,
    });
  }
}

for (const config of configs) {
  const support = await VideoDecoder.isConfigSupported(config);
  console.log(
    `VideoDecoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

Spezifikationen

Specification
WebCodecs # dom-videodecoder-isconfigsupported

Browser-Kompatibilität

BCD tables only load in the browser