YoungBoy' Blog.

<?xml version="1.0" encoding="utf-8"?> [ 作者博客: www.RiaHome.cn 作者主页: www.Y-boy.cn ]

<!--
原创作品/教程:
作者主页: www.Y-boy.cn
作者博客: www.RiaHome.cn
作品简介:
     用Flex3.0, 结合 AS3.0, 用 Sound 类写了个 mp3 播放器,
 可导出为 AIR. 功能: 播放进度的显示与调节, 音量大小的调节,左
 右声道的调节, 播放与停止; 

     对此教程有什么不明白, 可以到作者主页(www.Y-boy.cn)或者
 博客(www.RiaHome.cn)留言.
     如本教程有错误, 望高手指点指点......作者(Y-boy)在此说声谢谢!
    
 特别注明: 欢迎大家交流学习, 也欢迎大家转载, 但上面信息也是本教程的一部分, 请保留.
-->

<mx:Application  xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" creationComplete="myInit()">

 <mx:Script>
  <![CDATA[
  import flash.events.*;
  import flash.net.URLRequest;
  import flash.media.Sound;
  import flash.media.SoundChannel;
  import flash.media.SoundTransform;
  import flash.utils.Timer;
  import flash.events.TimerEvent;
  
  //mp3 的 url 地址
  private var soundURL:String = "She is my sin.mp3";
  //访问 url 上的东西都用 URLRequest 了
  private var request:URLRequest = new URLRequest(soundURL);
  private var my_sound:Sound=new Sound(); // 新建 Sound 对象
  //声明 SoundChannel 类型的变量 my_channel
  private var my_channel:SoundChannel;
  //新建 myTimer 对象并定义循环的时间间隔为10毫秒,循环次数为无限次(参数中的0表示无限次)
  private var myTimer:Timer = new Timer(10, 0);
    

  private function myInit():void{
   my_sound.load(request); // 载入外部 mp3: She is my sin.mp3
   }
  //播放音乐:
  private function playSound(): void{
   my_channel = my_sound.play(); // 音乐正式开始播放
   //添加事件侦听器, 功能: 循环执行 timerHandler 函数(但这里还没有开始循环执行)
   myTimer.addEventListener(TimerEvent.TIMER, timerHandler);
   myTimer.start(); // 这里才开始循环执行 timerHandler 函数
  }
  //停止音乐:
  private function stopSound():void{
   //停止对函数 timerHandler 的循环执行, 因为音乐开始时 myTimer 对象就对函数 timerHandler 循环执行了
   myTimer.stop();
   my_channel.stop(); // 正式停止音乐
   progress_hs.value = 0; // 使那"播放进度"条的值回到0,即回到最左端
  }
  //定义被 myTimer 循环执行的函数 timerHandler
  private function timerHandler(event:TimerEvent):void{
   //功能: 显示音乐的播放进度, 进度条会随着音乐的继续播放而向右缓缓移动;
   //把这个公式翻译为中文: 播放进度条的值=当前音乐播放时间/音乐的总时间
   progress_hs.value = my_channel.position/my_sound.length;
  }
  //改变播放进度: 每当 "播放进度" 条被用户拉动过而使其值改变时,就执行以下函数
  private function changeProgress():void{
   //音乐停止且必须停止,是为了从新的播放时间点开始播放
   //(感觉这里麻烦了点, 如果有更好的方法,恳请高手指点!请联系我:
   // www.Y-boy.cn 或 www.RiaHome.cn ,谢谢!)
   my_channel.stop();
   //使音乐从新的时间点开始播放,新的时间点是小括号内的值,
   //即:"播放进度"条的值*音乐的总时间, 为什么会这样呢?
   //因为 HSlider 控件(那条"播放进度")的长度在下面被定义为1,
   //使得"播放进度"条的值在闭区间[0,1]内, 所以只需再乘以音乐的总时间就行了
   my_channel = my_sound.play(progress_hs.value*my_sound.length);
  }
  //改变音量: 每当 "音量大小" 控制条被用户拉动过而使其值改变时,就执行以下函数
  private function changeVolume():void{
   //把 my_channel.soundTransform 赋值给 my_transform
   var my_transform:SoundTransform = my_channel.soundTransform;
   my_transform.volume = volume_hs.value; // 把"音量大小"控制条当前值赋给 my_transform.volume
   my_channel.soundTransform = my_transform; // 给 my_channel.soundTransform 赋值
   /*
        这里的用法很特别, 像使用 AS2.0 里面的滤镜(Filters)那样, 先创建一个 "第三者",
    对 "第三者" 进行操作, 最后才把 "第三者" 赋值给 "当事人" . AS2.0 里面的滤镜的 "第三者"
    是数组, 这里的 "第三者" 是 my_transform . 这里不能跟 AS2.0 里面的滤镜相比, 只不过为
    了方便理解, 才这么说. (个人见解, 如有错请指出!)
   */
  }
  //改变左右声道: 每当 "左右声道" 控制条被用户拉动过而使其值改变时,就执行以下函数
  private function changePan():void{
   //此处用法与上面的 改变音量 相同, 理解 改变音量 的, 就能理解这里
   var my_transform:SoundTransform = my_channel.soundTransform;
   my_transform.pan = pan_vs.value;
   my_channel.soundTransform = my_transform;
  }  
  
  ]]>

[ 作者博客: www.RiaHome.cn 作者主页: www.Y-boy.cn ]
 </mx:Script>
 
 <!-- 显示歌曲名称 -->
 <mx:Label text="歌曲:She is my sin" fontSize="12"/>
 
 <!-- 播放进度条 -->
 <mx:Label text="播放进度:" fontSize="12" y="25"/>
 <mx:HSlider id="progress_hs" width="100" minimum="0" maximum="1"
  x="60" y="25" mouseDown="myTimer.stop()" mouseUp="myTimer.start()"
  change="changeProgress()"/>
 
 <!-- 音量控制条 -->
 <mx:Label text="音量大小:" fontSize="12" y="52"/>
 <mx:HSlider id="volume_hs" width="100" minimum="0" maximum="1"
  y="52" x="60" value="0.8" change="changeVolume()"/>
 
 <!-- 左右声道控制条 -->
 <mx:Label text="左右声道:" fontSize="12" x="-1" y="78"/>
 <mx:HSlider id="pan_vs" width="100" minimum="-1" maximum="1"
  x="60" y="80" value="0" change="changePan()"/>
 
 <!-- 播放和停止按钮 -->
 <mx:Button label="play" y="116" x="50" click="playSound()"/>
 <mx:Button label="stop" y="116" x="109" click="stopSound()"/>
 
</mx:Application>

<!--[ 作者博客: www.RiaHome.cn 作者主页: www.Y-boy.cn ]
 害怕本教程写得不好, 不能使读者明白, 在这里详细解说一下:
 已使用 MXML 里的控件: Label、Button、HSlider
  Label 控件: 各 Label 用于显示文字标题;
  Button 控件: 音乐的播放与停止, 其中：
       <mx:Button label="play" y="116" x="50" click="playSound()"/>里
   的 click 属性和属性的值起主要作用，这个属性值是一个函数, 此处为 playSound() 函
   数. 播放和停止的函数的功能上面有详细解释了, 这里不重复说.
   
  HSlider 控件:
     这里有三个 HSlider 控件, 分别是:
       播放进度条(progress_hs)、音量控制条(volume_hs)、左右声道控制条(pan_vs).
   
  一、播放进度条(progress_hs)有两个作用: 显示当前播放进度和调节播放进度.
   1、当用户没有拉动此进度条时,它会随着音乐的继续播放而向右缓缓移动,实现此功能的主要代码是:
   
     //进度条能时时刻刻随着音乐的播放而向右移动主要是这个 Timer 类, 它好比以前
     //的 onEnterFrame 和 setInterval, 意义是: 在指定时间间隔内重复执行代码,
     //这里就是在每 10 毫秒内执行一次, 次数为无限次.
     private var myTimer:Timer = new Timer(10, 0);
     
     //AS3.0 事事皆侦听! 这里是要创建侦听器, 小括号内的第二个参数就是下面将要重复执行的函数
     myTimer.addEventListener(TimerEvent.TIMER, timerHandler);
     
     private function timerHandler(event:TimerEvent):void{
     //功能: 显示音乐的播放进度, 进度条会随着音乐的继续播放而向右缓缓移动;
     //把这个公式翻译为中文: 播放进度条的值=当前音乐播放时间/音乐的总时间
      progress_hs.value = my_channel.position/my_sound.length;
     }
     
   2、当用户希望音乐快进或者后退, 就要拉动进度条了. 这里就要注意以下几点:
   
     (1) 用户拉动进度条时, 不希望上面的 timerHandler() 函数被重复执行,
     否则进度条是不能被拉动的. 解决方法: 在此 HSlider 控件标签 <mx:HSlider id="progress_hs" />
     内加上 mouseDown="myTimer.stop()" . 意义: 当鼠标按下(mouseDown)这个控件时, 调用 myTimer
     的 .stop() 方法, 使其停止工作, 以使 timerHandler() 函数不再被重复执行.
     
     (2) 当用户调节好进度条后, 需要释放鼠标, 那么上面的 timerHandler() 函数需要被再次重复执行,
     好让进度条继续随着音乐播放而向右移动. 那么在释放鼠标的瞬间需要让 myTimer 继续工作, 实现此功
     能的代码是: mouseUp="myTimer.start()" . 在释放鼠标后, 同时希望音乐能跟着用户的意愿,在指
     定的时间位置上播放, 实现此功能的主要代码是:
       <mx:HSlider id="progress_hs" change="changeProgress()"/>  里面
       的 change="changeProgress()" 就是代表: 每当 "播放进度" 条被用户拉动过
       而使其值改变时,就执行 changeProgress() 函数
       
       private function changeProgress():void{
        //音乐停止且必须停止,是为了从新的播放时间点开始播放
        //(感觉这里麻烦了点, 如果有更好的方法,恳请高手指点!
        //请联系我: www.Y-boy.cn 或 www.RiaHome.cn ,谢谢!)
        my_channel.stop();
        //使音乐从新的时间点开始播放,新的时间点是小括号内的值,
        //即:"播放进度"条的值*音乐的总时间, 为什么会这样呢?
        //因为 HSlider 控件(那条"播放进度")的长度在下面被定义为1,
        //使得"播放进度"条的值在闭区间[0,1]内, 所以只需再乘以音乐的总时间就行了
        my_channel = my_sound.play(progress_hs.value*my_sound.length);
       }
       
  二、音量控制条(volume_hs)
       拉动音量控制条, 以达到调节音量大小的功能, 也是使用标签内的 change="" 属性,
   双引号内放的就是要执行的函数. 在上面也有详细的注释了, 这里不展开来说了.
   重点是: flash.media 包下的 Sound类、SoundChannel类和SoundTransform类三者间的关系.
  三、左右声道控制条(pan_vs)
   原理和音量控制条(volume_hs)一样, 不详说, 请见谅！

-->

文件(包含源文件、教程和AIR成品)下载:   压缩包下载