Sound 类

可用性

Flash Player 5。

说明

Sound 类使您可以控制影片中的声音。可以在影片正在播放时从库中向该影片剪辑添加声音,并控制这些声音。如果在创建新 Sound 对象时没有指定 target,则可以使用方法控制整个影片的声音。

在调用 Sound 类的方法之前,您必须使用构造函数 new Sound 创建 Sound 对象。

Sound 类的方法摘要

方法

说明

Sound.attachSound()

附加在参数中指定的声音。

Sound.getBytesLoaded()

返回为指定声音加载的字节数。

Sound.getBytesTotal()

以字节为单位返回声音的大小。

Sound.getPan()

返回上一个 setPan() 调用的值。

Sound.getTransform()

返回上一个 setTransform() 调用的值。

Sound.getVolume()

返回上一个 setVolume() 调用的值。

Sound.loadSound()

将 MP3 文件加载到 Flash Player 中。

Sound.setPan()

设置声音的左/右均衡。

Sound.setTransform()

设置要在每个扬声器中播放的每个声道(左声道和右声道)的音量。

Sound.setVolume()

设置声音的音量级别。

Sound.start()

从头开始播放声音,或者可选择从参数中设置的某偏移点开始播放声音。

Sound.stop()

停止指定声音或当前播放的所有声音。

Sound 类的属性摘要

属性

说明

Sound.duration

声音的长度,以毫秒为单位。

Sound.ID3

提供对作为 MP3 文件一部分的元数据的访问。

Sound.position

声音已播放的毫秒数。

Sound 类的事件处理函数摘要

事件处理函数

说明

Sound.onID3

每次有新的 ID3 数据可用时调用。

Sound.onLoad

加载声音时调用。

Sound.onSoundComplete

声音停止播放时调用。

Sound 类的构造函数

可用性

Flash Player 5。

用法

new Sound([target])

参数

target Sound 对象操作的影片剪辑实例。此参数是可选的。 

返回

无。

说明

构造函数;为指定的影片剪辑创建新的 Sound 对象。如果没有指定目标实例,则 Sound 对象控制影片中的所有声音。

示例

下面的示例创建名为 global_sound 的新 Sound 对象。示例中的第二行调用 setVolume() 并将影片中的所有声音的音量调整为 50%。

global_sound = new Sound();
global_sound.setVolume(50);

下面的示例创建一个新 Sound 对象,将目标影片剪辑 my_mc 传递给它,然后调用 start 方法,该方法开始播放 my_mc 中的所有声音。

movie_sound = new Sound(my_mc);
movie_sound.start();