g200kg > Web Audio API 解説 > 19.各ノードのパラメータ一覧
Web Audio API 解説
2019/01/19
19.各ノードのパラメータ一覧
« Prev 01.前説 02.とりあえず音を出す 03.オシレーターの使い方 04.ノードの接続 05.ノードのライフタイム 06.バッファソースでワンショットサンプルから音を出す 07.パラメータとオートメーション 08.a-rateパラメーターとk-rateパラメーター 09.スクリプトプロセッサーの使い方 10.フィルターの使い方 11.オシレーターのカスタム波形 12.アナライザーの使い方 13.ディレイの使い方 14.ウェイブシェイパーの使い方 15.コンプレッサーの使い方 16.コンボルバーの使い方 17.パンナーの使い方 19.各ノードのパラメータ一覧 Next »
Web Audio APIの各ノードが持つパラメータの一覧です。
- Oscillator : オシレーター
- AudioBufferSource : オーディオバッファソース
- Gain : ゲイン
- BiquadFilter : バイクワッド・フィルター
- IIRFilter : IIR フィルター
- Delay : ディレイ
- ScriptProcessor : スクリプトプロセッサー
- Panner : パンナー
- StereoPanner : ステレオパンナー
- Convolver : コンボルバー
- Analyser : アナライザー
- ChannelSplitter : チャンネルスプリッター
- ChannelMerger : チャンネルマージャー
- DynamicsCompressor : ダイナミクス・コンプレッサー
- WaveShaper : ウェーブシェイパー
- ConstantSOurce : コンスタントソース
OscillatorNode
説明：周期波形を生成します。作成：AudioContext.createOscillator() / new OscillatorNode(audioctx);
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| type | 文字列 | - | "sine" | "sine" "square" "sawtooth" "triangle" "custom" | 波形の指定 "sine" : サイン波 "square" : 矩形波 "sawtooth":鋸歯状波 "triangle":三角波 "custom":カスタム(直接指定できない) |
| frequency | AudioParam | Hz | 440 | -ナイキスト周波数 ～ +ナイキスト周波数 | 周波数の指定。ナイキスト周波数はサンプリング周波数の1/2。通常のブラウザ実装の場合、44100の半分で22050の場合が多い。このパラメータは a-rate です。 |
| detune | AudioParam | セント | 0 | 約-153600 ～ 約+153600 | デチューン。セントは100で半音、1200で1オクターブです。このパラメータは a-rate です。 |
| start([when]) | 関数 | - | - | - | 再生開始。whenは開始時刻(秒) |
| stop([when]) | 関数 | - | - | - | 再生停止。whenは停止時刻(秒) |
| setPeriodicWave (periodicWave) | 関数 | - | - | - | カスタム波形の指定 |
AudioBufferSourceNode
説明：AudioBuffer を再生します。作成：AudioContext.createBufferSource();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| buffer | AudioBuffer | - | null | - | 再生するオーディオバッファ |
| playbackRate | AudioParam | なし | 1 | -∞ ～ +∞ | 再生速度。このパラメータは k-rate です。 |
| detune | AudioParam | なし | 0 | -∞ ～ +∞ | 再生速度のデチューン。このパラメータは k-rate です。 |
| loop | ブール値 | - | false | - | ループ再生の指定 |
| loopStart | 数値 | 秒 | 0 | - | ループ開始位置 |
| loopEnd | 数値 | 秒 | 0 | - | ループ終了位置。0の場合、バッファ全体がループ対象となる |
| start([when [,offset [,duration]]]) | 関数 | - | - | - | 再生開始。whenは開始時刻(秒)。offset/durationはバッファ中の再生位置と長さの指定(単位は秒)。 |
| stop([when]) | 関数 | - | - | - | 再生停止。whenは停止時刻(秒) |
GainNode
説明：信号の振幅を増幅/減衰させます。作成：AudioContext.createGain()
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| gain | AudioParam | なし | 1 | -∞ ～ +∞ | ゲイン。倍率を数値で指定 (デシベルではない)。このパラメータは a-rate です。 |
BiquadFilterNode
説明：二次の各種フィルターを掛けます。作成：AudioContext.createBiquadFilter();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| type | 文字列 | - | "lowpass" | "lowpass" "highpass" "bandpass" "lowshelf" "highshelf" "peaking" "notch" "allpass" | フィルターのタイプ "lowpass":ローパス "highpass":ハイパス "bandpass":バンドパス "lowshelf":ローシェルフ "highshelf":ハイシェルフ "peaking":ピーキング "notch":ノッチ "allpass":オールパス |
| frequency | AudioParam | Hz | 350 | 0～ナイキスト周波数 | フィルターのカットオフ周波数。ナイキスト周波数はサンプリング周波数の1/2で、通常のブラウザ実装の場合は44100の半分、22050の事が多い。このパラメータは a-rate です。 |
| detune | AudioParam | セント | 0 | -∞ ～ +∞ | カットオフ周波数のデチューン。セントは半音の1/100、1200で1オクターブです。このパラメータは a-rate です。 |
| Q | AudioParam | なし | 1 | -∞ ～ +∞ | フィルターのQ。このパラメータは a-rate です。 |
| gain | AudioParam | dB | 0 | -∞ ～ +∞ | フィルターのゲイン。ローシェルフ/ハイシェルフ/ピーキングの場合のみ使用します。このパラメータは a-rate です。 |
| getFrequencyResponse (freq,mag,phase) | 関数 | - | - | - | フィルター特性カーブの取得 |
IIRFilterNode
説明：係数を直接指定してIIRフィルターを掛けます。動作中に特性を可変する事はできません。作成：AudioContext.createIIRFilter(feedforward, feedback);
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| getFrequencyResponse (freq,mag,phase) | 関数 | - | - | - | フィルター特性カーブの取得 |
DelayNode
説明：信号を遅延させます。作成：AudioContext.createDelay([maxDelayTime = 1.0]);
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| delayTime | AudioParam | 秒 | 0 | 0 ～ maxDelayTime | ディレイタイム。上限値のmaxDelayTime は、ノードを作成する時に決められます。このパラメータは a-rate です。 |
ScriptProcessorNode
説明：信号波形をJavaScriptで直接処理します。※ このノードは非推奨となっていて将来削除されます。
作成：AudioContext.createScriptProcessor([bufferSize [,inCh=2 [,outCh=2]]]);
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| onaudioprocess | EventListener | - | - | - | Javascirptの関数を指定 |
| bufferSize | 数値 | - | - | - | リードオンリー。作成時に指定されたオーディオデータの受け渡しのバッファサイズ。256, 512, 1024, 2048, 4096, 8192, 16384のどれか |
PannerNode
説明：三次元空間内に音源を定位させます。作成：AudioContext.createPanner();
なおリスナーのデフォルトは位置(0,0,0)、方向(0,0,-1)。
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| panningModel | 文字列 | - | "equalpower" | "equalpower" "HRTF" | パンニングモデル "equalpower":パワー均等モデル "HRTF":高品質(コンボリューション)モデル |
| positionX | AudioParam | - | 0 | -∞ ～ +∞ | 音源の位置X座標 |
| positionY | AudioParam | - | 0 | -∞ ～ +∞ | 音源の位置Y座標 |
| positionZ | AudioParam | - | 0 | -∞ ～ +∞ | 音源の位置Z座標 |
| orientationX | AudioParam | - | 0 | -∞ ～ +∞ | 音源の方向X座標 |
| orientationY | AudioParam | - | 0 | -∞ ～ +∞ | 音源の方向Y座標 |
| orientationZ | AudioParam | - | 0 | -∞ ～ +∞ | 音源の方向Z座標 |
| distanceModel | 文字列 | - | "inverse" | "linear" "inverse" "exponential" | 距離モデル。リスナーまでの距離に対する音量の減衰方法。 "linear":リニア減衰 "inverse":逆数減衰 "exponential":指数減衰 |
| refDistance | 数値 | なし | 1 | - | 距離モデルで使用する基準距離 |
| maxDistance | 数値 | なし | 10000 | - | 距離モデルで使用する最大距離 |
| rolloffFactor | 数値 | なし | 1 | - | 距離モデルで使用する減衰の速さ |
| coneInnerAngle | 数値 | 度 | 360 | - | 音源の指向性。指向性コーンの内側の角度 |
| coneOuterAngle | 数値 | 度 | 360 | - | 音源の指向性。指向性コーンの外側の角度 |
| coneOuterGain | 数値 | なし | 0 | - | 音源の指向性。指向性コーン外側での減衰率。倍率を指定する |
| setPosition(x, y, z) | 関数 | - | (0,0,0) | - | 音源の位置の設定 |
| setOrientation(x, y, z) | 関数 | - | (1,0,0) | - | 音源の方向の設定 |
StereoPanner
説明：2ch ステレオで左右の定位を行います。作成：AudioContext.createStereoPanner();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| pan | AudioParam | なし | 0 | -1 ～ +1 | 定位。-1 で左、 +1で右 |
ConvolverNode
説明：コンボリューション演算でリバーブ処理等を行います。作成：AudioContext.createConvolver();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| buffer | AudioBuffer | - | null | - | 使用するインパルスレスポンスデータ |
| normalize | ブール値 | - | true | - | インパルスレスポンスデータをノーマライズするかどうかの指定 |
AnalyserNode
説明：信号の周波数データ、波形データを取得します。作成：AudioContext.createAnalyser();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| fftSize | 数値 | - | 2048 | 32 ～ 32768 | FFTを行うサイズ。2のn乗でなくてはならない |
| frequencyBinCount | 数値 | - | 1024 | - | fftSizeの1/2。リードオンリー |
| minDecibels | 数値 | dB | -100 | - | getByteFrequencyDataで使用するFFTデータの最小値 |
| maxDecibels | 数値 | dB | -30 | - | getByteFrequencyDataで使用するFFTデータの最大値 |
| smoothingTimeConstant | 数値 | - | 0.8 | 0～1 | FFTデータのスムージング時定数。0でスムージング無し |
| getFloatFrequencyData (Float32Array array) | 関数 | - | - | - | FFTデータの取得。出力はdB値 |
| getFloatTimeDomainData (Float32Array array) | 関数 | - | - | - | 波形データの取得 |
| getByteFrequencyData (Uint8Array array) | 関数 | - | - | - | FFTデータの取得。出力はdB値をminDecibels/maxDecibels間で変換した値 |
| getByteTimeDomainData (Uint8Array array) | 関数 | - | - | - | 波形データの取得 |
ChannelSplitterNode
説明：多チャンネルの信号を複数に分離します。作成：AudioContext.createChannelSplitter([numOutputs=6]);
| パラメータ無し |
|---|
ChannelMergerNode
説明：複数の信号を多チャンネルの一つの信号に合成します。作成：AudioContext.createChannelMerger([numInput=6]);
| パラメータ無し |
|---|
DynamicsCompressorNode
説明：コンプレッサー処理 (音量の自動調整)を行います。作成：audiocontext.createDynamicsCompressor();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| threshold | AudioParam | dB | -24 | -100～0 | スレッショルド。このパラメータは k-rate です。 |
| knee | AudioParam | dB | 30 | 0～40 | ニー特性。スレッショルドの上側のスムージング幅。このパラメータは k-rate です。 |
| ratio | AudioParam | なし | 12 | 1～20 | コンプレッション率。このパラメータは k-rate です。 |
| reduction | 数値 | dB | 無信号時は0 | -20～0 | 現在のリダクション率。リードオンリー |
| attack | AudioParam | 秒 | 0.003 | 0～1.0 | アタックタイム。このパラメータは k-rate です。 |
| release | AudioParam | 秒 | 0.25 | 0～1.0 | リリースタイム。このパラメータは k-rate です。 |
WaveShaperNode
説明：テーブル参照で波形の変換を行います。作成：AudioContext.createWaveShaper();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | 内容 |
|---|---|---|---|---|---|
| curve | Float32Array | - | null | - | ウェーブシェイピングのカーブ配列 |
| oversample | 文字列 | - | "none" | "none" "2x" "4x" | オーバーサンプリングの指定 |
ConstantSourceNode
説明：一定値を出力します。作成：AudioContext.createConstantSource();
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | レート | 内容 |
|---|---|---|---|---|---|---|
| offset | AudioParam | - | 1 | 単精度 float の取れる範囲 | a-rate | 出力する一定の値を表します。 |
MediaElementAudioSourceNode
説明：HTML のメディア要素 (audio / video) からオーディオを取り出して信号源にします。作成：AudioContext.createMediaElementSource() / new MediaElementAudioSourceNode(AudioContext)
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | レート | 内容 |
|---|---|---|---|---|---|---|
| mediaElement | HTMLMediaElement | - | - | - | - | 信号源にするHTMLのメディア要素です。ノード作成時に指定し ReadOnly です。 |
MediaStreamAudioDestinationNode
説明：オーディオを MediaStream として出力するための出力ポイント作成：AudioContext createMediaStreamDestination(); / new MediaStreamAudioDestinationNode(AudioContext)
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | レート | 内容 |
|---|---|---|---|---|---|---|
| stream | MediaStream | - | - | - | - | このノードから出力される MediaStream を表す。 |
MediaStreamAudioSourceNode
説明：MediaStream のオーディオをWeb Audio API で処理するための入力ポイント作成：AudioContext createMediaStreamSource(strm); / new MediaStreamAudioSourceNode(AudioContext,option)
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | レート | 内容 |
|---|---|---|---|---|---|---|
| mediaStream | MediaStream | - | - | - | - | 入力とする MediaStream を表す。ReanOnly。 |
MediaStreamTrackAudioSourceNode
説明：MediaStream のオーディオをWeb Audio API で処理するための入力ポイント作成：AudioContext createMediaStreamSource(strm); / new MediaStreamAudioSourceNode(AudioContext,option)
| パラメータ | 型 | 単位 | デフォルト値 | 値の範囲 | レート | 内容 |
|---|
« Prev 01.前説 02.とりあえず音を出す 03.オシレーターの使い方 04.ノードの接続 05.ノードのライフタイム 06.バッファソースでワンショットサンプルから音を出す 07.パラメータとオートメーション 08.a-rateパラメーターとk-rateパラメーター 09.スクリプトプロセッサーの使い方 10.フィルターの使い方 11.オシレーターのカスタム波形 12.アナライザーの使い方 13.ディレイの使い方 14.ウェイブシェイパーの使い方 15.コンプレッサーの使い方 16.コンボルバーの使い方 17.パンナーの使い方 19.各ノードのパラメータ一覧 Next »
g200kg