音频解码器:isConfigSupported() 静态方法

可用性有限

此功能不是基线功能,因为它在一些最广泛使用的浏览器中无法正常工作。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

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

实验性:这是一个实验性技术
在生产环境中使用之前,请仔细检查浏览器兼容性表

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

语法

js
AudioDecoder.isConfigSupported(config)

参数

config

AudioDecoder.configure接受的字典对象

返回值

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

supported

布尔值,如果给定的配置受解码器支持,则为true

config

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

异常

TypeError

如果提供的config无效,则抛出此异常;即,如果缺少必需的值(例如空的codec字段)或包含无效的值(例如负的sampleRate)。

示例

以下示例测试浏览器是否支持几种音频编解码器。

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 AudioDecoder.isConfigSupported(config);
  console.log(
    `AudioDecoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

规范

规范
WebCodecs
# dom-audiodecoder-isconfigsupported

浏览器兼容性

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