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 貢獻者編輯。