声音类 Sound类

Sound类

所在的包：flash.media

继承object

Sound 类允许您在应用程序中使用声音。使用 Sound类可以创建 Sound对象、将外部 MP3 文件加载到该对象并播放该文件、关闭声音流，以及访问有关声音的数据，如有关流中字节数和 ID3 元数据的信息。可通过以下项对声音执行更精细的控制：声音源（声音的 SoundChannel 或 Microphone 对象）和 SoundTransform 类中用于控制向计算机扬声器输出声音的属性。

ActionScript 3.0 的 SoundAPI 与 ActionScript 2.0 不同。在 ActionScript 3.0 中，将无法采用声音对象并在层次结构中对其进行排列以控制其属性。

使用此类时，请考虑 Flash Player 安全模型（这些考虑不适用于动态生成的声音）：

• 如果执行调用的 SWF 文件在网络沙箱中，并且要加载的声音文件是本地文件，则不允许加载和播放声音。
• 默认情况下，若执行调用的 SWF 文件是本地文件并且试图加载和播放远程声音，则不允许加载和播放声音。用户必须授予明确许可才能允许此类访问。
• 某些处理声音的操作受到限制。除非您实现一个 URL 策略文件，否则位于其他域中的 SWF 文件无法访问已加载声音中的数据。受此限制约束的与声音相关的 API 为 Sound.id3、SoundMixer.computeSpectrum()、SoundMixer.bufferTime 和 SoundTransform 类。

公共属性：bytesLoaded : uint　　[只读 (read-only)] 返回此声音对象中当前可用的字节数。

　　bytesTotal : int　　[只读 (read-only)] 返回此声音对象中总的字节数。

　　length : Number　　[只读 (read-only)] 当前声音的长度（以毫秒为单位）。

　　url : String　　[只读 (read-only)] 从中加载此声音的 URL。

　　id3 : ID3Info　　[只读 (read-only)] 提供对作为 MP3 文件一部分的元数据的访问。

公共方法：

　　Sound(stream:URLRequest = null, context:SoundLoaderContext = null)　　创建一个新的 Sound对象。

　　close():void　　关闭该流，从而停止所有数据的下载。

　　extract(target:ByteArray, length:Number, startPosition:Number = -1):Number　　从 Sound对象提取原始声音数据。

　　load(stream:URLRequest, context:SoundLoaderContext = null):void　　启动从指定 URL 加载外部 MP3 文件的过程。

　　play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel　　生成一个新的 　　　　  SoundChannel 对象来回放该声音。

 

事件：complete　　成功加载数据后调度

　　id3　　在存在可用于MP3声音的ID3数据时由sound对象调度

　　ioError　　在出现输入/输出错误并由此导致加载操作失败时调度。

　　open　　在加载操作开始时调度

　　progress　　在加载操作进行过程中接收到数据时调度。

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

 

转载于:https://www.cnblogs.com/--2174521/archive/2012/11/01/2743944.html