修改声音播放控制例子以及说明

修改声音播放控制例子以及说明

Author: yjtx

egret/06-sound.md

@@ -1,57 +1,49 @@
 Egret框架入门第一步 - 声音
 ===============
 
-声音也是游戏里的一个必备因素，包括背景音乐，动作音效等等。在Egret中负责声音处理的是SoundContext类，准确的说，是SoundContext的继承者（比如HTML5SoundContext类）。在第四小节中我们介绍过，Egret是一个跨平台的解决方案(虽然目前尚未完全实现)，我们目前主要工作在它对HTML5的支持上，对应到声音上，我们使用的是HTML5SoundContext。
+声音也是游戏里的一个必备因素，包括背景音乐，动作音效等等。目前egret支持的音乐文件格式只有mp3。
 
-如果您具备一些HTML5的开发经验，应该知道目前浏览器对于声音的支持是有问题的：[支持的格式不统一](http://www.html5cn.com.cn/news/course/2012-10-06/139.html)。所以我们在Egret中，也要注意到这个问题。在准备声音素材的时候，可以让同一个音效具备3种格式：
-
-* ogg
-* mp3
-* wav
-
-然后在运行时判断所处环境，来决定播放哪一种格式。判断的函数如下：
+和图片创建一样，播放音乐文件也需要先加载音乐文件。
 
 ```
-/**判断格式是否支持,format可以传递：ogg,mp3,wav*/
-private checkSoundCanPlay(format:String):boolean {
-    var au = document.createElement('audio');
-    var _check = function (typeStr) {
-        var result = au.canPlayType(typeStr);
-        return result != "no" && result != "";
-    };
-    if (au.canPlayType) {
-        if(format=="mp3") {
-            return _check("audio/mpeg");
-        } else if(format=="ogg") {
-            return _check('audio/ogg; codecs="vorbis"');
-        } else if(format=="wav") {
-            return _check('audio/wav; codecs="1"');
-        } else {
-            return false;
-        }
-    }
-    return false;
+/**资源配置文件*/
+{
+"resources":
+    [
+        {"name":"sfx_die","type":"sound","url":"assets/sfx_die.mp3"}
+    ],
+
+"groups":
+    [
+        {"name":"demo6","keys":"sfx_die"}
+    ]
 }
-```
 
-然后使用如下的语句即可播放声音：
+/**加载所需资源*/
+public loadResource():void {
+    //使用资源管理器加载资源
+    RES.addEventListener(RES.ResourceEvent.GROUP_COMPLETE, this.onResourceLoadComplete, this);
+    RES.loadConfig("resources/resource.json", "resources/");
+    RES.loadGroup("demo6");
+}
+```
 
+加载完毕后就可以对音乐文件进行 播放和停止的操作啦。
 ```
-var soundContext:egret.SoundContext = egret.SoundContext.getInstance();//Egret中处理声音的是SoundContext
-//soundContext.preloadSound("sfx_die.ogg");//可以预加载声音，以便需要的时候立刻播放
-var soundPath:string = "sfx_die";//声音的前缀
-if(this.checkSoundCanPlay("ogg"))//根据支持情况设置声音的后缀
-    soundPath += ".ogg";
-else if(this.checkSoundCanPlay("mp3"))
-    soundPath += ".mp3";
-else
-    soundPath += ".wav";
-soundContext.playMusic(soundPath,true);//播放声音，第二个参数决定是否重复
-egret.Ticker.getInstance().setTimeout(function (){
-    soundContext.stopMusic(true);//停止播放
-},this,3000);//延迟3秒调用
+/**播放声音*/
+private onResourceLoadComplete():void {
+    //获取音乐文件
+    var sound:egret.Sound = RES.getRes("sfx_die");
+    //播放音乐文件
+    sound.play();
+    //3秒后音乐播放结束
+    egret.Ticker.getInstance().setTimeout(function () {
+        //音乐播放结束
+        sound.stop();
+    }, this, 3000);//间隔时间为3秒钟
+}
+
 ```
-> 您不一定要准备齐全3种格式，请根据您的目标平台自行决定
 
 - - -
 

egret/demo/HelloEgret/resources/resource.json

@@ -7,7 +7,8 @@
         {"name":"icons","type":"sheet","url":"assets/icons.json"},
         {"name":"monkey_png","type":"img","url":"assets/monkey.png"},
         {"name":"monkey_json","type":"json","url":"assets/monkey.json"},
-        {"name":"bitmapFont","type":"font","url":"assets/font.fnt"}
+        {"name":"bitmapFont","type":"font","url":"assets/font.fnt"},
+        {"name":"sfx_die","type":"sound","url":"assets/sfx_die.mp3"}
 	],
 
 "groups":
@@ -16,6 +17,7 @@
         {"name":"demo2","keys":"egretIcon,icons"},
         {"name":"demo3","keys":"monkey_png,monkey_json"},
         {"name":"demo4","keys":"bitmapFont"},
+        {"name":"demo6","keys":"sfx_die"},
         {"name":"demo7","keys":"egretIcon"},
         {"name":"demo8","keys":"egretIcon"}
 	]

egret/demo/HelloEgret/src/Demo6.ts

@@ -1,60 +1,45 @@
 /**
  * Sound Demo
  */
-class Demo6 extends egret.DisplayObjectContainer{
+class Demo6 extends egret.DisplayObjectContainer {
 
     public constructor() {
         super();
-        this.addEventListener(egret.Event.ADDED_TO_STAGE,this.startGame,this);
+        this.addEventListener(egret.Event.ADDED_TO_STAGE, this.startGame, this);
     }
 
     /**游戏启动后，会自动执行此方法*/
     public startGame():void {
         this.initDefaultText();
-        this.initSound();
+        this.loadResource();
     }
+
     /**显示文本*/
     private initDefaultText():void {
         var label1 = new egret.TextField();
         label1.textColor = 0xffffff;
         label1.text = "演示声音如何播放";
         this.addChild(label1);
     }
-    /**播放声音*/
-    private initSound():void {
-        var soundContext:egret.SoundContext = egret.SoundContext.getInstance();//Egret中处理声音的是SoundContext
-        //soundContext.preloadSound("sfx_die.ogg");//可以预加载声音，以便需要的时候立刻播放
-        var soundPath:string = "sfx_die";//声音的前缀
-        if(this.checkSoundCanPlay("ogg"))//根据支持情况设置声音的后缀
-            soundPath += ".ogg";
-        else if(this.checkSoundCanPlay("mp3"))
-            soundPath += ".mp3";
-        else
-            soundPath += ".wav";
-        soundContext.playMusic(soundPath,true);//播放声音，第二个参数决定是否重复
-        egret.Ticker.getInstance().setTimeout(function (){
-            soundContext.stopMusic(true);//停止播放
-        },this,3000);
-        console.info("music is playing",soundContext instanceof egret.HTML5SoundContext);
+
+    /**加载所需资源*/
+    public loadResource():void {
+        //使用资源管理器加载资源
+        RES.addEventListener(RES.ResourceEvent.GROUP_COMPLETE, this.onResourceLoadComplete, this);
+        RES.loadConfig("resources/resource.json", "resources/");
+        RES.loadGroup("demo6");
     }
-    /**判断格式是否支持,format可以传递：ogg,mp3,wav*/
-    private checkSoundCanPlay(format:String):boolean {
-        var au = document.createElement('audio');
-        var _check = function (typeStr) {
-            var result = au.canPlayType(typeStr);
-            return result != "no" && result != "";
-        };
-        if (au.canPlayType) {
-            if(format=="mp3") {
-                return _check("audio/mpeg");
-            } else if(format=="ogg") {
-                return _check('audio/ogg; codecs="vorbis"');
-            } else if(format=="wav") {
-                return _check('audio/wav; codecs="1"');
-            } else {
-                return false;
-            }
-        }
-        return false;
+
+    /**播放声音*/
+    private onResourceLoadComplete():void {
+        //获取音乐文件
+        var sound:egret.Sound = RES.getRes("sfx_die");
+        //播放音乐文件
+        sound.play();
+        //3秒后音乐播放结束
+        egret.Ticker.getInstance().setTimeout(function () {
+            //音乐播放结束
+            sound.stop();
+        }, this, 3000);
     }
 }