mx.effects.effectClasses
public class SoundEffectInstance
继承SoundEffectInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object

SoundEffectInstance 类用于实现 SoundEffect 效果的实例类。Flex 在播放 SoundEffect 效果时会自动创建此类的实例;您无需自己创建。

另请参见

mx.effects.Fade


公共属性
 属性定义方
  bufferTime : Number = 1000
SoundEffect 类使用内部 Sound 对象来控制 MP3 文件。
SoundEffectInstance
 InheritedclassName : String
[只读 (read-only)] 效果类的名称,如“FadeInstance”。
EffectInstance
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedduration : Number
效果的持续时间(以毫秒为单位)。
EffectInstance
 Inheritedeffect : IEffect
创建此 IEffectInstance 对象的 IEffect 对象。
EffectInstance
 InheritedeffectTargetHost : IEffectTargetHost
一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。
EffectInstance
 InheritedhideFocusRing : Boolean
确定在开始播放效果时,效果是否应隐藏对焦环。
EffectInstance
  isLoading : Boolean
[只读 (read-only)] 如果已加载 MP3,则此属性为 true。
SoundEffectInstance
  loops : int = 0
循环模式下播放该声音的次数,其中值 0 表示此效果播放一次,值 1 表示此效果播放两次,依此类推。
SoundEffectInstance
  panEasingFunction : Function
均衡效果的缓动函数。
SoundEffectInstance
  panFrom : Number
Sound 对象的初始平移。
SoundEffectInstance
  panTo : Number
Sound 对象的最终平移。
SoundEffectInstance
 InheritedplayheadTime : Number
[只读 (read-only)] 播放效果时所处的当前位置。
EffectInstance
 InheritedpropertyChanges : PropertyChanges
指定包含一组属性的初始值和结束值的 PropertyChanges 对象,这些属性与效果的目标相关。
EffectInstance
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 InheritedrepeatCount : int
效果的重复次数。
EffectInstance
 InheritedrepeatDelay : int
重复播放效果前需要等待的时间(以毫秒为单位)。
EffectInstance
  sound : Sound
对内部 Sound 对象的引用。
SoundEffectInstance
  soundChannel : SoundChannel
[只读 (read-only)] 已加载了 MP3 文件的 SoundChannel 对象。
SoundEffectInstance
  source : Object
要播放的 MP3 文件的 URL 或类。
SoundEffectInstance
 InheritedstartDelay : int
开始播放效果前需要等待的时间(以毫秒为单位)。
EffectInstance
  startTime : Number = 0
MP3 文件中的初始位置(以毫秒为单位),应在此位置开始回放。
SoundEffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
如果为 true,则在播放效果时阻止所有背景处理。
EffectInstance
 Inheritedtarget : Object
要应用此效果的 UIComponent 对象。
EffectInstance
 InheritedtriggerEvent : Event
触发播放效果的事件(如果有)。
EffectInstance
  useDuration : Boolean = true
如果为 true,则会在 duration 属性中指定的时间过后停止效果。
SoundEffectInstance
  volumeEasingFunction : Function
音量效果的缓动函数。
SoundEffectInstance
  volumeFrom : Number
Sound 对象的初始音量。
SoundEffectInstance
  volumeTo : Number
Sound 对象的最终音量。
SoundEffectInstance
公共方法
 方法定义方
  
构造函数。
SoundEffectInstance
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
中断当前播放的效果实例,立即跳转到效果的结束位置。
EffectInstance
 Inherited
在完成效果播放时由 end() 方法调用。
EffectInstance
 Inherited
每次完成重复效果的迭代播放后调用。
EffectInstance
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
如果由 EffectManager 触发效果,则会调用此方法。
EffectInstance
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
暂停效果,直到调用 resume() 方法。
EffectInstance
 Inherited
在目标上播放效果实例。
EffectInstance
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
在效果由 pause() 方法暂停后继续播放效果。
EffectInstance
 Inherited
从效果的当前位置开始反向播放效果。
EffectInstance
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
经过 startDelay 所占用的这段时间后,在目标上播放效果实例。
EffectInstance
 Inherited
停止播放效果,使目标保持当前状态。
EffectInstance
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
属性详细信息
bufferTime属性
public var bufferTime:Number = 1000

SoundEffect 类使用内部 Sound 对象来控制 MP3 文件。此属性指定声音数据应在 Sound 对象的缓冲区中存储的最短时间(以毫秒为单位)。在开始回放以及在网络中断后继续回放之前,Sound 对象将一直等待,直至至少拥有这一数量的数据为止。

默认值为 1000.

isLoading属性 
isLoading:Boolean  [只读 (read-only)]

如果已加载 MP3,则此属性为 true



实现
    public function get isLoading():Boolean
loops属性 
public var loops:int = 0

循环模式下播放该声音的次数,其中值 0 表示此效果播放一次,值 1 表示此效果播放两次,依此类推。如果要重复播放 MP3 文件,也是使用 useDuration 属性的设置来确定回放时间。

duration 属性的优先级高于此属性的优先级。如果效果的持续时间短于播放一次声音所需的时间,则声音将不循环。

默认值为 0.

panEasingFunction属性 
public var panEasingFunction:Function

均衡效果的缓动函数。此函数用于在 panFrom 值和 panTo 值之间进行插值。

panFrom属性 
public var panFrom:Number

Sound 对象的初始平移。此值介于 -1.0 和 1.0 之间,其中 -1.0 表示仅使用左声道,1.0 表示仅使用右声道,而 0.0 表示在两个声道间平均地均衡声音。

默认值为 0.

panTo属性 
public var panTo:Number

Sound 对象的最终平移。此值介于 -1.0 和 1.0 之间,其中 -1.0 表示仅使用左声道,1.0 表示仅使用右声道,而 0.0 表示在两个声道间平均地均衡声音。

默认值为 0.

sound属性 
public var sound:Sound

对内部 Sound 对象的引用。SoundEffect 使用此实例来播放 MP3 文件。

soundChannel属性 
soundChannel:SoundChannel  [只读 (read-only)]

已加载了 MP3 文件的 SoundChannel 对象。



实现
    public function get soundChannel():SoundChannel
source属性 
source:Object  [读写]

要播放的 MP3 文件的 URL 或类。如果已使用 Embed 关键字嵌入 MP3 文件,即可将 MP3 文件的 Class 对象传递给 source 属性。否则,为 MP3 文件指定完整的 URL。



实现
    public function get source():Object
    public function set source(value:Object):void
startTime属性 
public var startTime:Number = 0

MP3 文件中的初始位置(以毫秒为单位),应在此位置开始回放。

默认值为 0.

useDuration属性 
public var useDuration:Boolean = true

如果为 true,则会在 duration 属性中指定的时间过后停止效果。如果为 false,则会在 MP3 完成播放或循环后停止效果。

默认值为 true.

volumeEasingFunction属性 
public var volumeEasingFunction:Function

音量效果的缓动函数。使用此函数可在 volumeFromvolumeTo 值之间进行插值。

volumeFrom属性 
public var volumeFrom:Number

Sound 对象的初始音量。此值介于 0.0 和 1.0 之间。

默认值为 1.0.

volumeTo属性 
public var volumeTo:Number

Sound 对象的最终音量。此值介于 0.0 和 1.0 之间。

默认值为 1.0.

构造函数详细信息
SoundEffectInstance()构造函数
public function SoundEffectInstance(target:Object)

构造函数。

参数
target:Object — 要使用此效果为其设置动画的 Object。