音频解码器:configure() 方法
注意:此功能在专用 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 表仅在浏览器中加载