GainNode

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

GainNode 介面代表音量的變化。它是一個 AudioNode 音訊處理模組,在輸入資料傳播到輸出之前,會對輸入資料應用指定的增益。GainNode 始終只有一個輸入和一個輸出,兩者具有相同數量的通道。

增益是一個無單位的值,隨時間變化,它乘以所有輸入通道的每個相應樣本。如果修改,新的增益會立即應用,從而在生成的音訊中產生不悅耳的“咔噠”聲。為避免這種情況發生,切勿直接修改該值,而應使用 AudioParam 介面上的指數插值方法。

The GainNode is increasing the gain of the output.

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

建構函式

GainNode()

建立並返回一個新的 GainNode 物件。作為替代,您可以使用 BaseAudioContext.createGain() 工廠方法;請參閱 建立 AudioNode

例項屬性

繼承自其父級 AudioNode 的屬性.

GainNode.gain 只讀

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

例項方法

無特定方法;繼承自其父級 AudioNode 的方法.

示例

請參閱 BaseAudioContext.createGain() 瞭解使用 AudioContext 建立 GainNode 的示例程式碼。

規範

規範
Web Audio API
# GainNode

瀏覽器相容性

另見