GainNode: GainNode() コンストラクター

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Web Audio APIGainNode() コンストラクターは、新しい GainNode オブジェクトを作成します。これは音量の変更を表す AudioNode です。

構文

js
new GainNode(context, options)

引数

context

BaseAudioContext (たとえば AudioContext) への参照です。

options 省略可

以下のオプションが指定できます。

gain

適用するゲインです。このパラメーターは a-rate で、公称の範囲は (-∞,+∞) です。デフォルト値は 1 です。

channelCount

このノードへの入力についてアップミキシングとダウンミキシングを行う際に用いるチャンネル数の決定に用いる整数です。(詳しくは AudioNode.channelCount を参照してください) この使用法と正確な定義は channelCountMode の値によります。

channelCountMode

ノードの入力と出力でチャンネルを対応させる方法を表す列挙値です。(デフォルト値など詳しくは AudioNode.channelCountMode を参照してください)

channelInterpretation

チャンネルの意味を表す列挙値です。この意味により、音声のアップミキシングとダウンミキシングを行う方法を決定します。取りうる値は "speakers" および "discrete" です。(デフォルト値など詳しくは AudioNode.channelCountMode を参照してください)

返値

新しい GainNode オブジェクトのインスタンスを返します。

仕様書

Specification
Web Audio API
# dom-gainnode-constructor-gainnode

ブラウザーの互換性

BCD tables only load in the browser