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 介面上的指數內插法。

GainNode 正在增加輸出的增益。

EventTarget AudioNode GainNode
輸入數量 1
輸出數量 1
聲道計數模式 "max"
聲道計數 2(在預設計數模式下未使用)
聲道詮釋 "speakers"

建構子

GainNode()

建立並回傳一個新的 GainNode 物件。或者你也可以使用 BaseAudioContext.createGain() 工廠方法;參見建立 AudioNode

實體屬性

繼承其父介面 AudioNode 的屬性。

GainNode.gain Read only

一個 a-rateAudioParam,表示要應用的增益量。你必須設定 AudioParam.value 或使用 AudioParam 的方法來改變增益的效果。

實體方法

沒有自身的方法;繼承其父介面 AudioNode 的方法。

範例

參見 BaseAudioContext.createGain() 的範例程式碼,其中展示了如何使用 AudioContext 來建立 GainNode

規範

Specification
Web Audio API
# GainNode

瀏覽器相容性

參見