AudioDecoder: configure() 方法

可用性有限

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

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

AudioDecoder 接口的 configure() 方法用于入队一个控制消息，以配置音频解码器以解码数据块。

语法

configure(config)

一个包含以下成员的字典对象

codec: 包含有效编解码器字符串的字符串。有关编解码器字符串构造的详细信息，请参阅 "codecs" 参数。
sampleRate: 每秒帧采样数。
numberOfChannels: 音频通道数。
description 可选: 一个 ArrayBuffer、一个 TypedArray 或一个 DataView，其中包含一系列特定于编解码器的字节，通常称为 extradata。

注意： WebCodecs 编解码器注册表中的注册链接到一个详细说明如何以及是否需要填充可选的 description 成员的规范。

无（undefined）。

TypeError: 如果提供的 config 无效，则抛出此异常。
InvalidStateError DOMException: 如果 state 为 "closed"，则抛出此异常。
NotSupportedError DOMException: 如果提供的 config 有效，但用户代理无法提供可解码此配置文件的编解码器，则抛出此异常。

以下示例使用 opus 编解码器配置 audioDecoder。

audioDecoder.configure({
  codec: "opus",
  sampleRate: 44100,
  numberOfChannels: 2,
});

规范
WebCodecs # dom-audiodecoder-configure

此页面最后修改于 2025年5月28日，由 MDN 贡献者编辑。