AudioEncoder: isConfigSupported() 静态方法

有限可用性

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

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

实验性： 这是一个实验性技术
在生产环境中使用此功能之前，请仔细查看浏览器兼容性表。

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

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

语法

js

AudioEncoder.isConfigSupported(config)

参数

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

规范

规范
WebCodecs # dom-audioencoder-isconfigsupported

浏览器兼容性

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