attachSound

添加一段声音。

getBytesLoaded

返回制定倒入声音文件的字节数。

getBytesTotal

返回声音文件的大小。

getPan

返回最近一次setPan方法设置的平衡度。

getTransform

返回最近一次setTransform方法设置的音效。

getVolume

返回最近一次setVolume方法设置的音量。

loadSound

将MP3倒入Flash播放器

setPan

设置左右声道的平衡度。

setTransform

设置一些特殊的音效。

setVolume

设置音量。

start

开始播放声音。

stop

停止播放声音。

方法

说明

Sound.duration

声音文件的长度，毫秒。

Sound.position

声音文件的播放时间。

用法

描述

Sound.onLoad

引导声音文件时被调用。

Sound.onSoundComplete

声音文件停止播放时被调用。

语法

new Sound();

new Sound( target );

参数

target是某个电影片断的目标路径。

说明

构造函数；为某个电影片断生成一个声音对象；没有指定target参数的Sound对象可以控制所有时间轴的声音。

播放器

Flash 5或更新的版本

示例

globalSound = new Sound();

mySound = new Sound( myMovie );

参看

无

语法

mySound.attachSound( idName );

参数

idName必须是以字符串形式给出；它同attachMovie中的idName一样，需要在Symbol Linkage Properties对话框中指定。

说明

方法 。直接从物件库中取出一段声音附加在声音对象中。

播放器

Flash 5或更新的版本

示例

无

参看

无

语法

MySound.duration

参数

无

说明

属性（只读）；声音的持续时间，毫秒。

播放器

Flash 6

示例

无

参看

无

语法

Sound.getBytesLoaded()

参数

无

返回值

导入文件的字节数，整数。

说明

方法 。返回指定声音对象的导入字节数。可以比较getBytesLoaded返回值和getBytesTotal的返回值，确定导入文件进度百分比。

播放器

Flash 6

示例

无

参看

getBytesTotal

语法

Sound.getBytesTotal()

参数

无

返回值

整数，声音对象的大小，字节数。

说明

方法 。返回指定声音对象的大小，字节数。

播放器

Flash 6

示例

无

参看

GetBytesLoaded

语法

mySound.getPan();

参数

无

说明

方法 。返回最近一次调用setPan方法设置的左右声道的声音平衡度，返回值的取值范围是[-100，100]。声音平衡度将会受到setVolume和setTransform方法的影响。

播放器

Flash 5或更新的版本

示例

无

参看

Sound.setPan    Sound.setTransform

语法

mySound.getTransform();

参数

无

说明

方法 。返回最近一次调用setTransform方法设置的声音效果，返回值是一个Object对象。

播放器

Flash 5或更新的版本

示例

无

参看

Sound.setTransform

语法

mySound.getVolume();

参数

无

说明

方法 。返回最近一次调用setVolume方法设置的音量。

播放器

Flash 5或更新的版本

示例

无

参看

Sound.setVolume

语法

mySound.loadSound(“url”,isStreaming)

参数

url：服务器上MP3声音文件的地址。

isStreaming：布尔值，确定声音是流式或事件声音。

返回值

无

说明

方法 。为声音对象导入一个MP3文件做实例。使用isStreaming参数说明声音是事件声音或流式声音。播放之前，事件声音必须完全下载。事件声音用动作脚本声音对象管理，并对这个对象的所有方法和属性做出反应。流式声音在下载的同时播放。当缓冲器内接收到足够的数据之后就可以开始重放。与事件声音相比，流式声音仅仅存在于虚拟内存里面，不下载到本地硬盘。

播放器

Flash 6

示例

下面的例子导入一个事件声音：

s.loadSound(“http://serverpath:port/mp3filename”,false);

下面的例子导入一个流式声音：

loadSound(http://serverpath:port/mp3filename,true);

参看

无

语法

mySoundObject.onLoad=callbackFunction

参数

mySoundObject：声音对象。

callbackFunction：函数。

返回值

无

说明

事件句柄；导入声音时自动调用。在onLoad事件调用之前，必须要建立可执行的函数。可以使用匿名函数或者是指定函数。

播放器

Flash 6

示例

无

参看

OnSoundComplete

语法

mySoundObject.onSoundComplete=callbackFunction

参数

mySoundObject：声音对象。

callbackFunction：函数。

返回值

无

说明

事件；声音播放结束之后自动调用。可以使用onSoundComplete事件作为基于声音结束的影片的触发器事件。在调用onSoundComplete事件之前，必须要建立相应可执行函数。可以使用匿名函数或指定函数。

播放器

Flash 6

示例

用法1：下例使用匿名函数：

s = new Sound();

s.attachSound("mySound");

s.onSoundComplete = function() { trace("mySound completed"); };

s.start();

用发2：下例使用指定函数：

function callback1() {

trace("mySound completed");

}

s = new Sound();

s.attachSound("mySound");

s.onSoundComplete = callback1;

s.start();

参看

无

语法

mySound.position

参数

无

返回值

声音的播放时间，毫秒。

说明

只读属性 。以毫秒返回声音的播放时间。如果声音循环，则在每次循环开始position都会重置为0。

播放器

Flash 6

示例

无

参看

无

语法

mySound.setPan( pan );

参数

pan是一个整数，取值范围为[-100，100]，设为-100将只使用左声道，设为100将只使用右声道。

说明

方法 。设置声音的左右声道平衡度。平衡度将会受到setVolume和setTransform方法的影响。

播放器

Flash 5或更新的版本

示例

下面的例子使用setVolume和setPan方法来操纵一段名为u2的声音：

onClipEvent( mouseMove ) {

   //初始化一个声音对象

   s = new Sound( this );

   //从物件库中附加一段名为u2的声音

   s.attachSound( "u2" );

   //将音量设置为最大音量的50%

   s.setVolume( 50 );

   //关闭右声道

   s.setPan( -100 );

   //从声音的第30秒位置开始播放，并重复5次

   s.play( 30, 5 );

}

参看

Sound.setTransform    Sound.setVolume

语法

mySound.setTransform( soundTransformObject );

参数

soundTransformObject是一个Object对象，其中必须包含以下四个属性 。

ll指定左输入输出到左声道的百分比，取值范围是[-100，100]；

lr指定右输入输出到左声道的百分比，取值范围是[-100，100]；

rr指定右输入输出到右声道的百分比，取值范围是[-100，100]；

rl指定左输入输出到右声道的百分比，取值范围是[-100，100]；

那么左右输出的结果可以用以下公式进行计算：

左输出 = 左输入 * ll + 右输入 * lr；

右输出 = 左输入 * rr + 右输入 * rl；

其中左输入和右输入的大小是由声音本身决定的。

左右声道平均播放声音的设定如下所示：

ll = 100;

lr = 0;

rr = 100;

rl = 0;

所有声音都在做声道播放的设定如下所示：

ll = 100;

lr = 100;

rr = 0;

rl = 0;

说明

方法 。为指定的声音对象设置音效。调用该方法将会使setPan和setVolume方法所做的设置失效。

声音将会占用较大的磁盘空间和内存空间。因为立体声比单声道声音的数据量要大两倍，所以通常使用的是22khz、6位的单声道声音。使用setTransform方法可以把单声道声音播放出立体声效果，也可以把立体声声音以单声道方式播放，此外还可以加入一些特殊的音效。

播放器

Flash 5或更新的版本

示例

例如下面例子将一个立体声声音以单声道方式播放：

mySound = new Sound( this );

mySound.attachSound( "u2" );

myTransformObj = new Object();

myTransformObj.ll = 100;

myTransformObj.lr = 100;

myTransformObj.rr = 0;

myTransformObj.rl = 0;

mySound.setTransform( myTransformObj );

参看

无

语法

mySound.setVolume( volume );

参数

volume取值范围是[0,100]，缺省值为100。

说明

方法 。设置音量。

播放器

Flash 5或更新的版本

示例

下面的例子中在载入动画时将音量设置为50%，然后随着动画的播放，声音逐渐由左声道过渡到右声道：

onClipEvent( load ) {

   i = -100;

   s = new Sound();

   s.setVolume( 50 );

}

onClipEvent( enterFrame ) {

   s.setVolume( i++ );

}

参看

Sound.setPan    Sound.setTransform

语法

mySound.start();

mySound.start( [secondOffset, loop] );

参数

secondOffset指定了声音开始播放的位置。比如一段声音长度为30秒，将这个参数设为15的话，这段声音将从15秒的位置开始播放；

loop给出的是声音循环播放的次数。

以上两个参数是可选参数。

说明

方法 。开始播放一段声音。

播放器

Flash 5或更新的版本

示例

无

参看

Sound.stop

语法

Sound.stop();

Sound.stop( ["idName"] );

参数

idName是某段声音的标识名，可选参数。

说明

方法 。如果不指定参数则停止所有声音的播放，或者只停止播放标识名为idName的声音。

播放器

Flash 5或更新的版本

示例

无

参看

Sound.start

语法

_soundbuftime = integer;

参数

integer是一个整数，单位为秒。

说明

全局属性 。设定声音流的缓冲区大小，单位以秒计算，缺省值为5秒。

播放器

Flash 4或更新的版本

示例

无

参看

无