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) 进行计算。

提供给 SampleDataEvent 对象的 data 属性的样本的数目在 2048 到 8192 之间。为了获得最佳性能，请尽可能多地提供样本。提供的样本越少，在播放过程中就越有可能出现单击和弹出事件。此行为在不同的平台上会有所不同，并且会在各种情况下发生。例如，当调整浏览器的大小时。在仅提供 2048 个样本时，您可能会编写可在一个平台上运行的代码，但在不同的平台上运行时，同样的代码可能无法正常工作。要尽可能缩短滞后时间，请考虑允许用户选择数据量。

如果提供的样本数少于 2048 个，则 Sound 对象将播放其余的样本，然后停止声音，就像到达了声音文件的末尾，并生成 complete 事件。

可以使用 Sound 对象的 extract() 方法提取其声音数据，然后将声音数据写入动态流以进行播放。

将 sampleData 事件与 Sound 对象一起使用时，仅启用 extract() 和 play() Sound 方法。调用任何其他方法或属性将导致“调用无效”异常。仍启用 SoundChannel 对象的所有方法和属性。

捕获麦克风音频使用 sampleData 事件从麦克风捕获音频数据。为 sampleData 事件添加事件侦听器时，由于音频样本可用，麦克风将调度此事件。

在事件处理函数中，使用 ByteArray.readFloat() 方法读取事件的 data) 属性，此属性包含取样数据。此事件将包含多个样本，因此应使用 while 循环读取可用的数据：

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

查看示例

相关 API 元素