SampleDataEvent  - AS3

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

このイベントには 2 つの用途があります。

• 動的に生成されたオーディオデータを Sound オブジェクトに提供する。
• Microphone オブジェクトのオーディオデータを取得する。

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

関数では、ByteArray.writeFloat() メソッドを使用して、再生するサンプリングデータを格納するイベントの dataプロパティに書き込みます。

Sound オブジェクトに MP3 ファイルが読み込まれていない状態で、このオブジェクトの play() メソッドを呼び出すと、オブジェクトは sampleData イベントの送出を開始し、サウンドのサンプルを要求します。Sound オブジェクトは、データの配信が停止されるか、SoundChannel オブジェクトの stop() メソッドが呼び出されるまで、サウンドの再生中にイベントを送信し続けます。

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

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

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

Sound オブジェクトの extract() メソッドを使用すると、サウンドデータを抽出し、動的ストリームに書き込んでから再生することができます。

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

マイク音声をキャプチャする場合は、sampleData イベントを使用して、マイクからの音声データをキャプチャします。sampleData イベントのイベントリスナーを追加した場合、オーディオサンプルが使用可能になると、Microphone オブジェクトからイベントが送出されます。

イベントハンドラー関数では、ByteArray.readFloat() メソッドを使用して、サンプリングデータが格納されているイベントの dataプロパティを読み取ります。イベントには複数のサンプルが格納されるので、使用可能なデータを読み取るには while 句でループ処理する必要があります。

var soundBytes:ByteArray = new ByteArray();
 while(event.data.bytesAvailable)
 {
      var sample:Number = event.data.readFloat();
      soundBytes.writeFloat(sample);
 }

例を表示

関連する API エレメント