AudioParam
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.
* Some parts of this feature may have varying levels of support.
Web Audio API の AudioParam インターフェイスは、オーディオ関連のパラメーターを表します。通常は AudioNode のパラメーター（GainNode.gain など）です。
AudioParam は特定の値または値の変化に設定でき、特定の時間に特定のパターンに従って発生するようにスケジュールできます。
それぞれの AudioParam には、いつ、どのように値を変更するかを定義するイベントのリストを持っており、最初は空です。このリストが空でない場合、 AudioParam.value 属性を使用した変更は無視されます。このイベントのリストにより、任意のタイムラインベースのオートメーションカーブを使用して、とても正確な時間に変更をスケジュールすることができます。使用される時間は AudioContext.currentTime で定義されたものです。
AudioParam の種類
AudioParam には a-rate パラメーターと k-rate パラメーターの 2 種類があります。それぞれの AudioNode は、そのパラメーターが a-rate と k-rate のどちらであるかを仕様で定義しています。
a-rate
a-rate の AudioParam は、音声信号の各サンプルフレームの現在の音声パラメーターの値を導きます。
k-rate
k-rate の AudioParam は処理されるブロック全体、つまり 128 サンプルフレームに対して同じオーディオパラメーターの初期値を使用します。言い換えれば、ノードによって処理される音声のすべてのフレームに同じ値が適用されます。
インスタンスプロパティ
AudioParam.defaultValue読取専用-
AudioParamを作成する特定のAudioNodeによって定義された属性の初期値を表します。 AudioParam.maxValue読取専用-
パラメーターの公称（有効）範囲の最大可能値を表します。
AudioParam.minValue読取専用-
パラメーターの公称（有効）範囲の最小可能値を表します。
AudioParam.value-
パラメーターの現在の値を浮動小数点値として表します。 最初は
defaultValueの値に設定されています。
インスタンスメソッド
AudioParam.setValueAtTime()-
AudioContext.currentTimeに対して正確な時間にAudioParamの値の変更をスケジュールします。 新しい値はvalue引数によって与えられます。 AudioParam.linearRampToValueAtTime()-
AudioParamの値を徐々に線形に変化させるようにスケジュールします。 変更は、前のイベントに指定された時間に開始され、value引数で指定された新しい値へのランプ関数に従って進み、endTime引数で指定された時間に新しい値に到達します。 AudioParam.exponentialRampToValueAtTime()-
AudioParamの値の段階的な指数関数的な変化をスケジュールします。 変更は前のイベントに指定された時間に開始され、value引数で指定された新しい値への指数関数的な増加をたどり、endTime引数で指定された時間に新しい値に到達します。 AudioParam.setTargetAtTime()-
AudioParamの値に対する変更の開始をスケジュールします。 変更はstartTimeで指定された時間に開始し、target引数で指定された値に向かって指数関数的に移動します。 指数関数的な減衰率は、timeConstant引数によって定義されます。これは、秒単位で測定された時間です。 AudioParam.setValueCurveAtTime()-
AudioParamの値が、指定された開始時間から開始し、指定された期間にわたって、指定された間隔に収まるようにスケーリングされた浮動小数点数の配列で定義された一連の値に従うようにスケジュールします。 AudioParam.cancelScheduledValues()-
AudioParamに対する今後予定されているすべての変更をキャンセルします。 AudioParam.cancelAndHoldAtTime()-
AudioParamに対して将来予定されているすべての変更をキャンセルしますが、他の方法でさらに変更が加えられるまで、指定された時間にその値を保持します。
例
まず、ゲイン値を設定した GainNode の基本的な例です。 値はオーディオのサンプルフレームごとに異なるように設定される可能性があるため、ゲインは a-rate の AudioParam の例です。
const audioCtx = new AudioContext();
const gainNode = audioCtx.createGain();
gainNode.gain.value = 0;
次に、いくつかの値が設定された DynamicsCompressorNode を示す例です。 値はオーディオブロック全体に一度に設定されるため、これらは k-rate の AudioParam の例です。
const compressor = audioCtx.createDynamicsCompressor();
compressor.threshold.setValueAtTime(-50, audioCtx.currentTime);
compressor.knee.setValueAtTime(40, audioCtx.currentTime);
compressor.ratio.setValueAtTime(12, audioCtx.currentTime);
compressor.attack.setValueAtTime(0, audioCtx.currentTime);
compressor.release.setValueAtTime(0.25, audioCtx.currentTime);
仕様書
| Specification |
|---|
| Web Audio API # AudioParam |