ConvolverNode:ConvolverNode() 建構函式

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

Web Audio API 的 ConvolverNode() 建構函式建立一個新的 ConvolverNode 物件例項。

語法

js
new ConvolverNode(context, options)

引數

context

AudioContext 的引用。

options 可選

選項如下:

buffer

一個單聲道、立體聲或四聲道 AudioBuffer,其中包含 ConvolverNode 用於建立混響效果的(可能是多聲道的)脈衝響應。

disableNormalization

一個布林值,用於控制脈衝響應是否會透過等效功率進行歸一化。預設為 false

channelCount

表示一個整數,用於確定在 上混和下混 連線到節點時使用的通道數。(有關更多資訊,請參閱 AudioNode.channelCount。)其用法和精確定義取決於 channelCountMode 的值。

channelCountMode

表示一個列舉值,描述了節點輸入和輸出之間匹配通道的方式。(有關預設值等更多資訊,請參見 AudioNode.channelCountMode。)

channelInterpretation

表示一個列舉值,描述了通道的含義。這種解釋將定義音訊 上混和下混 的發生方式。可能的值是 "speakers""discrete"。(有關更多資訊,包括預設值,請參閱 AudioNode.channelCountMode。)

返回值

一個新的 ConvolverNode 物件例項。

異常

NotSupportedError DOMException

如果引用的 AudioBuffer 沒有正確的通道數,或者其取樣率與關聯的 AudioContext 不同,則會引發此錯誤。

規範

規範
Web Audio API
# dom-convolvernode-convolvernode

瀏覽器相容性