包	flash.events
类	public class SampleDataEvent
继承	SampleDataEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

当播放器请求新的音频数据时调度。

在需要管理动态生成的音频时使用此事件。在此环境中，Sound 对象实际上并不包含声音数据。相反，该对象将用作声音数据的套接字，声音数据通过使用您分配给此事件的函数流入该对象。

在您的函数中使用 ByteArray.writeFloat() 方法来写入到包含要播放的已采样数据的 ByteArray 对象 (event.data)。

当您调用 Sound.play() 时，播放器将开始调用事件处理程序并请求包含声音样本的数据块。播放声音时播放器将继续发送事件，直至您停止提供数据或调用 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()。调用任何其他方法或属性将导致“调用无效”异常。仍启用 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();