AudioDecoder: isConfigSupported() 静态方法

可用性有限

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 专用 Web Workers 中可用。

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

浏览器兼容性