flash.media
public final class SoundChannel
继承SoundChannel Inheritance EventDispatcher Inheritance Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

SoundChannel 类控制应用程序中的声音。 Adobe ® Flash ® 应用程序中播放的每一个声音都被分配到一个声道,而且应用程序可以具有混合在一起的多个声道。 SoundChannel 类包含 stop() 方法、用于监控声道幅度(音量)的属性,以及用于对声道设置 SoundTransform 对象的属性。

查看示例

另请参见

Sound
SoundTransform



公共 属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  leftPeak : Number
[read-only] 左声道的当前幅度(音量),范围从 0(静音)至 1(最大幅度)。
SoundChannel
  position : Number
[read-only] 该声音中播放头的当前位置。
SoundChannel
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
  rightPeak : Number
[read-only] 右声道的当前幅度(音量),范围从 0(静音)至 1(最大幅度)。
SoundChannel
  soundTransform : SoundTransform
分配给该声道的 SoundTransform 对象。
SoundChannel
公共 方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
  
停止在该声道中播放声音。
SoundChannel
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件摘要定义方
 Inherited Flash Player 获得操作系统焦点并变为活动状态时调度。EventDispatcher
 Inherited Flash Player 失去操作系统焦点并变为非活动状态时调度。EventDispatcher
   在声音完成播放后调度。SoundChannel
属性详细信息
leftPeak属性
leftPeak:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

左声道的当前幅度(音量),范围从 0(静音)至 1(最大幅度)。


实现
    public function get leftPeak():Number
position属性 
position:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

该声音中播放头的当前位置。


实现
    public function get position():Number
rightPeak属性 
rightPeak:Number  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

右声道的当前幅度(音量),范围从 0(静音)至 1(最大幅度)。


实现
    public function get rightPeak():Number
soundTransform属性 
soundTransform:SoundTransform  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

分配给该声道的 SoundTransform 对象。 SoundTransform 对象包含用于设置音量、平移、左扬声器指定和右扬声器指定的属性。


实现
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

另请参见

方法详细信息
stop()方法
public function stop():void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

停止在该声道中播放声音。

事件详细信息
soundComplete 事件
事件对象类型: flash.events.Event
Event.type property = flash.events.Event.SOUND_COMPLETE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

在声音完成播放后调度。

定义 soundComplete 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已结束声音播放的 Sound 对象。
示例 如何使用示例

以下示例加载一个 MP3 文件,进行播放,并显示在加载和播放该 MP3 文件时所发生的声音事件的相关信息。 Timer 对象每 50 毫秒提供一次有关播放头位置的更新信息。 若要运行此示例,请将一个名为 MySound.mp3 的文件放在 SWF 文件所在的同一目录中。
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.net.URLRequest;
    import flash.utils.Timer;

    public class SoundChannelExample extends Sprite {
        private var url:String = "MySound.mp3";
        private var soundFactory:Sound;
        private var channel:SoundChannel;
        private var positionTimer:Timer;

        public function SoundChannelExample() {
            var request:URLRequest = new URLRequest(url);
            soundFactory = new Sound();
            soundFactory.addEventListener(Event.COMPLETE, completeHandler);
            soundFactory.addEventListener(Event.ID3, id3Handler);
            soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            soundFactory.load(request);

            channel = soundFactory.play();
            channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);

            positionTimer = new Timer(50);
            positionTimer.addEventListener(TimerEvent.TIMER, positionTimerHandler);
            positionTimer.start();
        }
        

        private function positionTimerHandler(event:TimerEvent):void {
            trace("positionTimerHandler: " + channel.position.toFixed(2));
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function id3Handler(event:Event):void {
            trace("id3Handler: " + event);
        }

        private function ioErrorHandler(event:Event):void {
            trace("ioErrorHandler: " + event);
            positionTimer.stop();       
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler: " + event);
        }

        private function soundCompleteHandler(event:Event):void {
            trace("soundCompleteHandler: " + event);
            positionTimer.stop();
        }
    }
}




 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/media/SoundChannel.html