AudioBuffer: AudioBuffer() コンストラクター
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021年4月.
AudioBuffer はウェブオーディオ API のコンストラクターで、新しい AudioBuffer オブジェクトを生成します。
構文
new AudioBuffer(options)
引数
options-
オプションは次の通りです。
length-
オーディオバッファーのサイズ（サンプルフレーム単位）。特定の秒数の音声に使用する
lengthを決定するには、numSeconds * sampleRateを使用してください。 numberOfChannels-
バッファーのチャンネル数です。既定値は 1 で、すべてのユーザーエージェントは最低でも 32 チャンネルを対応する必要があります。
sampleRate-
バッファーのサンプリングレート（単位: Hz）。既定では、このオブジェクトを作成する際に使用した
contextのサンプリングレートになります。ユーザーエージェントは 8,000 Hz から 96,000 Hz までのサンプリングレートに対応する必要があります（ただし、この範囲外でもかまいません）。 channelCount-
ノードへの任意の入力にアップミキシングとダウンミキシング接続する際に使用するチャンネル数を決めるための整数を表します。 （詳しくは
AudioNode.channelCountを参照してください。）その使い方や正確な定義はchannelCountModeの値に依存します。 channelCountMode-
ノードの入力と出力の間でチャンネルを一致させる方法を記述する列挙型の値を表します。（既定値を含む詳細は
AudioNode.channelCountModeを参照してください。） channelInterpretation-
チャンネルの意味を記述した列挙型の値を表します。この解釈により、音声のアップミキシングとダウンミキシングがどのように行われるかが定義されることになります。 指定可能な値は
"speakers"または"discrete"です。（既定値を含むより詳細な情報についてはAudioNode.channelCountModeを参照してください。）
非推奨の引数
context非推奨;-
AudioContextへの参照です。この引数は仕様書から削除されました。
例外
NotSupportedErrorDOMException-
1 つ以上のオプションが負の値であるか、あるいは無効な値である場合（例えば
numberOfChannelsがサポートされているよりも大きい、あるいはsampleRateが公称範囲外であるなど）に発生します。 RangeError-
バッファーを割り当てるのに十分なメモリーがない場合に発生します。
仕様書
| Specification |
|---|
| Web Audio API # dom-audiobuffer-audiobuffer |