VideoDecoder：isConfigSupported() 静态方法

可用性有限

此功能不是基线功能，因为它在一些最广泛使用的浏览器中不起作用。

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中。

注意：此功能在专用 Web 工作线程中可用。

isConfigSupported() 是 VideoDecoder 接口的静态方法，用于检查给定的配置是否受支持（即，是否可以使用给定的配置成功配置 VideoDecoder 对象）。

语法

js
VideoDecoder.isConfigSupported(config)

参数

config

VideoDecoder.configure 接受的字典对象

返回值

一个Promise，解析为包含以下成员的对象

supported

一个布尔值，如果给定的配置受解码器支持，则为true。

config

给定配置的副本，其中包含解码器识别到的所有字段。

异常

TypeError

如果提供的config无效，则抛出此异常；即，如果缺少必需的值（例如空的codec字段）或具有无效的值（例如负的codedWidth）。

示例

以下示例测试浏览器是否支持多个视频编解码器的加速和非加速版本。

js
const codecs = ["avc1.42001E", "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
    }`,
  );
}

规范

规范
WebCodecs
# dom-videodecoder-isconfigsupported

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。