GainNode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
GainNode
介面表示音量的改變。它是一個 AudioNode
音訊處理模組,會將指定的增益應用於輸入資料,然後再傳播到輸出。GainNode
總是只有一個輸入和一個輸出,兩者都有相同數量的聲道。
增益是一個無單位的數值,會隨時間變化,並與所有輸入聲道的每個對應取樣相乘。如果修改了增益,新的增益會立即套用,導致在最終的音訊中產生不悅耳的「喀嚓聲」。為了避免這種情況發生,切勿直接改變數值,而應使用 AudioParam
介面上的指數內插法。
輸入數量 | 1 |
---|---|
輸出數量 | 1 |
聲道計數模式 | "max" |
聲道計數 | 2 (在預設計數模式下未使用) |
聲道詮釋 | "speakers" |
建構子
GainNode()
-
建立並回傳一個新的
GainNode
物件。或者你也可以使用BaseAudioContext.createGain()
工廠方法;參見建立 AudioNode。
實體屬性
繼承其父介面 AudioNode
的屬性。
GainNode.gain
Read only-
一個 a-rate 的
AudioParam
,表示要應用的增益量。你必須設定AudioParam.value
或使用AudioParam
的方法來改變增益的效果。
實體方法
沒有自身的方法;繼承其父介面 AudioNode
的方法。
範例
參見 BaseAudioContext.createGain()
的範例程式碼,其中展示了如何使用 AudioContext
來建立 GainNode
。
規範
Specification |
---|
Web Audio API # GainNode |