音频解码器:configure() 方法

可用性有限

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

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

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

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

configure()方法是AudioDecoder接口的方法,用于将控制消息排队以配置音频解码器进行解码块。

语法

js
configure(config)

参数

config

包含以下成员的字典对象

codec

包含有效编解码器字符串的字符串。有关编解码器字符串构建的详细信息,请参阅"编解码器"参数

sampleRate

表示每秒帧样本数的整数。

numberOfChannels

表示音频通道数的整数。

description 可选

一个ArrayBuffer、一个TypedArray或一个DataView,包含一系列编解码器特定字节,通常称为 extradata。

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

返回值

无 (undefined).

异常

TypeError

如果提供的 config 无效,则抛出此异常。

InvalidStateError DOMException

如果state"closed",则抛出此异常。

NotSupportedError DOMException

如果提供的 config 有效,但用户代理无法提供可以解码此配置文件的编解码器,则抛出此异常。

示例

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

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

规范

规范
WebCodecs
# dom-audiodecoder-configure

浏览器兼容性

BCD 表仅在浏览器中加载