ScriptProcessorNode

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

ScriptProcessorNode インターフェイスは、JavaScript を使って音声を生成、処理、または分析することを可能にします。

EventTarget AudioNode ScriptProcessorNode

メモ: この機能は AudioWorkletsAudioWorkletNode インターフェイスに置き換えられました。

ScriptProcessorNode インターフェイスは AudioNode 音声処理モジュールであり、入力音声データを含む 2 つのバッファーと処理後の出力音声データを含む 1 つのバッファーにリンクされています。入力バッファーに新しいデータが入るたびに AudioProcessingEvent インターフェイスを実装したイベントがオブジェクトに送られ、出力バッファーがデータでいっぱいになるとイベントハンドラーは終了します。

ScriptProcessorNode は、入力をバッファーに格納し、 audioprocess イベントを送信します。 EventHandler は入力バッファーを受け取り、出力バッファーを満たし、 ScriptProcessorNode によって出力に送信されます。

入力バッファーと出力バッファーのサイズは BaseAudioContext.createScriptProcessor メソッドが呼び出されたときの作成時に定義します(どちらも BaseAudioContext.createScriptProcessorbufferSize 引数で定義されます)。バッファサイズは 256 から 16384 までの 2 の累乗、つまり 256512102420484096819216384 のいずれかでなければなりません。小さい数値のほうが遅延を低減させますが、音声の途切れやグリッチを避けるために大きな値が必要な場合もあります。

もしバッファーサイズが定義されていない場合、これが推奨ですが、ブラウザーは経験則的に適切と思われるものを選びます。

入力数 1
出力数 1
チャンネルカウントモード "max"
チャンネルカウント 2 (既定のカウントモードで使用しない)
チャンネルの解釈 "speakers"

プロパティ

親である AudioNode からプロパティを継承しています

ScriptProcessorNode.bufferSize 読取専用

入力と出力の両方のバッファーサイズを表す整数を返します。この値は、 256 から 16384 までの範囲の 2 のべき乗の値です。

メソッド

固有のメソッドはありません。親である AudioNode からメソッドを継承しています

イベント

これらのイベントは addEventListener() を使って、あるいはこのインターフェイスの onイベント名 プロパティにイベントリスナーを割り当てることで待ち受けます。

audioprocess

ScriptProcessorNode の入力バッファーが処理可能な状態になったときに発行されます。 また、onaudioprocess イベントハンドラープロパティでも利用可能です。

コード例については BaseAudioContext.createScriptProcessor() を参照してください。

仕様書

2014 年 8 月 29 日のウェブオーディオ API 仕様書の公開以降、この機能は非推奨となりました。標準化される予定はなくなりました。

AudioWorkletsAudioWorkletNode インターフェイスに置き換えられました。

ブラウザーの互換性

BCD tables only load in the browser

関連情報