パッケージ	flash.events
クラス	public class SampleDataEvent
継承	SampleDataEvent Event Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10, AIR 1.5

Flash Player が新しいオーディオデータを要求するときに送出されます。

動的に生成されるオーディオを管理する場合、このイベントを使用します。この環境では、Sound オブジェクトにはサウンドデータは実際には格納されません。代わりに、このイベントに割り当てた関数の使用を通じてストリームされるサウンドデータのソケットとして動作します。

関数では、ByteArray.writeFloat() メソッドを使用して、再生するサンプリングデータを格納する ByteArray オブジェクト（event.data）に書き込みます。

Sound.play() を呼び出すと、Flash Player はイベントハンドラの呼び出しを開始し、サウンドサンプルを含むデータチャンクを要求します。サウンドの再生中、Flash Player は、データの供給を停止するまで、または SoundChannel.stop() が呼び出されるまで、イベントを送信し続けます。

イベントの待ち時間はプラットフォームにより異なりますが、Flash Player の将来のバージョンでは変更できるようになります。特定の待ち時間に依存せず、計算するようにしてください。ActionScript で待ち時間を計算するには、((SampleDataEvent.position/44.1) - SoundChannelObject.position) という数式を使用します。

SampleDataEvent オブジェクトで 2048 以上 8192 以下の数のサンプルを用意します。最適なパフォーマンスを得るには、できるだけ多くのサンプルを用意します。用意するサンプルが少なければ少ないほど、再生中にクリック音およびポップ音が発生する可能性が高くなります。この現象はプラットフォームごとに異なり、また、様々な状況で発生します（例えば、ブラウザのサイズを変更した場合）。あるプラットフォームで 2048 のみのサンプルを用意した状態で動作するコードを記述しても、その同じコードを別のプラットフォームで実行した場合には動作しないことがあります。待ち時間をできるだけ短くするには、ユーザーが選択できるデータの量を考慮します。

用意したサンプル数が 2048 より少ない場合、Flash Player は存在するサンプルを再生し、その後、サウンドファイルの末尾に達したかのようにサウンドを停止し、SoundComplete イベントを生成します。

Sound.extract() メソッドを使用して、Sound オブジェクトからデータを抽出することもできます。データ抽出後、再生のダイナミックストリームにそのデータを書き込むことができます。

Sound オブジェクトでこのイベントを使用する場合、有効な他の Sound メソッドは、Sound.extract() と Sound.play() のみです。他のメソッドまたはプロパティを呼び出すと、「invalid call」例外が発生します。SoundChannel オブジェクトのすべてのメソッドおよびプロジェクトは、この場合でも有効です。

例を表示

関連項目

---

var mySound:Sound = new Sound();
function sineWaveGenerator(event:SampleDataEvent):void {
    for ( var c:int=0; c<8192; c++ ) {
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
    }
}

mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator);
mySound.play();