SampleDataEvent  - AS3

套件	flash.events
類別	public class SampleDataEvent
繼承	SampleDataEvent Event Object

這個事件有兩個用途：

• 為 Sound 物件提供動態產生的音效資料
• 為 Microphone 物件取得音效資料

使用 Sound 物件動態產生音效 使用 sampleData 事件以動態播放產生的音效。在這個環境中，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()。呼叫任何其他方法或屬性會產生「無效呼叫」例外。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 元素