Egret入门了解

0.前言

　　这个星期没有什么事做，就想找点技术了解一下。前段时间看过Egret，用来开发HTML5小游戏。一开始以为很麻烦的，但是经过这两天了解了一下，如果用这个游戏引擎来开发一些简单的游戏，还是蛮方便的。为什么会了解这个，是因为有个同事是开发Android的，是开发那种普通APP，就是一些简单的界面，跟硬件收发一下数据，然后展现出来。总体开发没有难点的，就是用Android开发那种界面交互效果很差，好看一点的呢，开发效率又很低。我就跟他提出，可以用html5画一些界面和一些动画效果。经过这两天了解，发现基本的交互是可以的。就是不知道放到APP里面会不会效果不好。

　　基本原理是，用Egret开发一个小动画，带互动功能。Android端APP在里面使用WEB进行显示，类似于在APP中启动一个小型的HTTP服务器。具体我也不是很懂。然后APP和我用Egret开发的网页两者的通信就使用WebSocket进行通信，这一步都只是初步想法。具体没有进行实现，只是觉得利用WEB的开发效率来降低APP开发的复杂度还是不错的。

　　这一篇博客，不会讲很多知识，就是了解一下白鹭引擎Egret而已。

1.下载开发软件

　　直接在这里进行下载，https://www.egret.com/products/engine.html 在这里下载最新版。

　　下载最新版后，在这个类似引擎商店进行下载，对与写个HelloWorld就使用EgretWing这个IDE就可以了，其他的暂时用不到，具体可以在官网进行了解。

2.新建工程

　　打开Egret Wing IDE，新建工程，文件->新建工程->新建EUI工程

　　创建完后，直接按F5运行，就可以看到效果了。其他的不用管，看src目录下Main.ts文件，这个就是源代码了。至于其他目录和其他配置文件这个就看官网介绍就可以了，这多说也没有什么意义的。

3.了解基本代码

　　具体的代码就下面这些了。用的是TypeScript语法 。

 class Main extends egret.DisplayObjectContainer {
     //一些全局变量
     private loadingView: LoadingUI;
     private car1: egret.Bitmap;
     private car2: egret.Bitmap;
     private start: egret.Bitmap;
     private pause: egret.Bitmap;
     private pause_start: egret.Bitmap;
     private stop: egret.Bitmap;
     private topMask: egret.Shape;
     private line: egret.Shape;
     private icon: egret.Bitmap;
     private colorLabel: egret.TextField;
     private textfield: egret.TextField;
     private left_mm: number;
     private right_mm: number;
     private run_left_1: egret.Bitmap;
     private run_left_2: egret.Bitmap;
     private run_right_1: egret.Bitmap;
     private run_right_2: egret.Bitmap;
     private speed: number;
     private isPause: boolean;

     public constructor() {
         super();
         this.addEventListener(egret.Event.ADDED_TO_STAGE, this.onAddToStage, this);
     }

     private onAddToStage(event: egret.Event) {
         //设置加载进度界面
         //Config to load process interface
         this.loadingView = new LoadingUI();
         this.stage.addChild(this.loadingView);

         //初始化Resource资源加载库
         //initiate Resource loading library
         RES.addEventListener(RES.ResourceEvent.CONFIG_COMPLETE, this.onConfigComplete, this);
         RES.loadConfig("resource/default.res.json", "resource/");
     }

     /**
      * 配置文件加载完成,开始预加载preload资源组。
      * configuration file loading is completed, start to pre-load the preload resource group
      */
     private onConfigComplete(event: RES.ResourceEvent): void {
         RES.removeEventListener(RES.ResourceEvent.CONFIG_COMPLETE, this.onConfigComplete, this);
         RES.addEventListener(RES.ResourceEvent.GROUP_COMPLETE, this.onResourceLoadComplete, this);
         RES.addEventListener(RES.ResourceEvent.GROUP_LOAD_ERROR, this.onResourceLoadError, this);
         RES.addEventListener(RES.ResourceEvent.GROUP_PROGRESS, this.onResourceProgress, this);
         RES.addEventListener(RES.ResourceEvent.ITEM_LOAD_ERROR, this.onItemLoadError, this);
         RES.loadGroup("preload");
     }

     /**
      * preload资源组加载完成
      * Preload resource group is loaded
      */
     private onResourceLoadComplete(event: RES.ResourceEvent) {
         if (event.groupName == "preload") {
             this.stage.removeChild(this.loadingView);
             RES.removeEventListener(RES.ResourceEvent.GROUP_COMPLETE, this.onResourceLoadComplete, this);
             RES.removeEventListener(RES.ResourceEvent.GROUP_LOAD_ERROR, this.onResourceLoadError, this);
             RES.removeEventListener(RES.ResourceEvent.GROUP_PROGRESS, this.onResourceProgress, this);
             RES.removeEventListener(RES.ResourceEvent.ITEM_LOAD_ERROR, this.onItemLoadError, this);
             this.createGameScene();
         }
     }

     /**
      * 资源组加载出错
      *  The resource group loading failed
      */
     private onItemLoadError(event: RES.ResourceEvent) {
         console.warn("Url:" + event.resItem.url + " has failed to load");
     }

     /**
      * 资源组加载出错
      *  The resource group loading failed
      */
     private onResourceLoadError(event: RES.ResourceEvent) {
         //TODO
         console.warn("Group:" + event.groupName + " has failed to load");
         //忽略加载失败的项目
         //Ignore the loading failed projects
         this.onResourceLoadComplete(event);
     }

     /**
      * preload资源组加载进度
      * Loading process of preload resource group
      */
     private onResourceProgress(event: RES.ResourceEvent) {
         if (event.groupName == "preload") {
             this.loadingView.setProgress(event.itemsLoaded, event.itemsTotal);
         }
     }

     /**
      * 创建游戏场景
      * Create a game scene
      */
     private createGameScene() {
         let sky = this.createBitmapByName("bg_png");
         this.addChild(sky);
         let stageW = this.stage.stageWidth;
         let stageH = this.stage.stageHeight;
         sky.width = stageW;
         sky.height = stageH;

         this.showMessage();

         //增加两辆车
         let car1 = this.createBitmapByName("car0_png");
         this.addChild(car1);
         car1.width = 40;
         car1.height = 80;
         car1.x = 90;
         car1.y = 400;
         this.car1 = car1;
         let car2 = this.createBitmapByName("car2_png");
         this.addChild(car2);
         car2.width = 40;
         car2.height = 80;
         car2.x = 240;
         car2.y = 400;
         this.car2 = car2;

         //增加开始按钮
         let start = this.createBitmapByName("startGameBtn_png");
         start.width = 160;
         start.height = 50;
         start.x = 100;
         start.y = 350;
         start.touchEnabled = true; //设置可以进行触摸
         this.start = start;
         this.addChild(start);

         let run_left_1 = this.createBitmapByName("runleft_png");
         let run_left_2 = this.createBitmapByName("runleft_png");
         let run_right_1 = this.createBitmapByName("runright_png");
         let run_right_2 = this.createBitmapByName("runright_png");
         this.run_left_1 = run_left_1;
         this.run_left_2 = run_left_2;
         this.run_right_1 = run_right_1;
         this.run_right_2 = run_right_2;
         run_left_1.width = 80;
         run_left_1.height = 480;
         run_left_2.width = 80;
         run_left_2.height = 480;
         run_left_1.x = 0;
         run_left_1.y = 0;
         run_left_2.x = 0;
         run_left_2.y = 480;
         run_right_1.width = 80;
         run_right_1.height = 480;
         run_right_2.width = 80;
         run_right_2.height = 480;
         run_right_1.x = 280;
         run_right_1.y = 0;
         run_right_2.x = 280;
         run_right_2.y = 480;
         this.addChild(this.run_left_1);
         this.addChild(this.run_left_2);
         this.addChild(this.run_right_1);
         this.addChild(this.run_right_2);
         this.run_left_1.visible = false;
         this.run_left_2.visible = false;
         this.run_right_1.visible = false;
         this.run_right_2.visible = false;

         //增加停止 暂停按钮
         //放在跑道上面
         let pause = this.createBitmapByName("pause_png");
         pause.width = 50;
         pause.height = 50;
         pause.x = 250;
         pause.y = 10;
         pause.touchEnabled = true; //设置可以进行触摸
         pause.visible = false;
         this.pause = pause;
         this.addChild(pause);
         let pause_start = this.createBitmapByName("start_png");
         pause_start.width = 50;
         pause_start.height = 50;
         pause_start.x = 250;
         pause_start.y = 10;
         pause_start.touchEnabled = true; //设置可以进行触摸
         pause_start.visible = false;
         this.pause_start = pause_start;
         this.addChild(pause_start);
         let stop = this.createBitmapByName("stop_png");
         stop.width = 50;
         stop.height = 50;
         stop.x = 300;
         stop.y = 10;
         stop.touchEnabled = true; //设置可以进行触摸
         stop.visible = false;
         this.stop = stop;
         this.addChild(stop);

         this.isPause = true;

         //初始化两个小车移动路程为0
         this.left_mm = 0;
         this.right_mm = 0;

         this.addEventListener(egret.TouchEvent.TOUCH_TAP, this.onClickStart, this);
         RES.getResAsync("description_json", this.startAnimation, this);
     }

     /**
      * 根据name关键字创建一个Bitmap对象。name属性请参考resources/resource.json配置文件的内容。
      * Create a Bitmap object according to name keyword.As for the property of name please refer to the configuration file of resources/resource.json.
      */
     private createBitmapByName(name: string) {
         let result = new egret.Bitmap();
         let texture: egret.Texture = RES.getRes(name);
         result.texture = texture;
         return result;
     }

     /**
      * 描述文件加载成功，开始播放动画
      * Description file loading is successful, start to play the animation
      */
     private startAnimation(result: string[]) {
         let parser = new egret.HtmlTextParser();

         let textflowArr = result.map(text => parser.parse(text));
         let textfield = this.textfield;
         let count = -1;
         let change = () => {
             count++;
             if (count >= textflowArr.length) {
                 count = 0;
             }
             let textFlow = textflowArr[count];

             // 切换描述内容
             // Switch to described content
             textfield.textFlow = textFlow;
             let tw = egret.Tween.get(textfield);
             tw.to({ "alpha": 1 }, 200);
             tw.wait(2000);
             tw.to({ "alpha": 0 }, 200);
             tw.call(change, this);
         };

         change();
     }

     /**
      * 定义公司产品信息
      */
     private showMessage(){
         let topMask = new egret.Shape();
         topMask.graphics.beginFill(0xFF0000, 0.5);
         topMask.graphics.drawRect(0, 0, this.stage.stageWidth, 172);
         topMask.graphics.endFill();
         topMask.y = 33;
         this.addChild(topMask);
         this.topMask = topMask;

         let icon = this.createBitmapByName("egret_icon_png");
         this.addChild(icon);
         icon.x = 26;
         icon.y = 33;
         this.icon = icon;

         let line = new egret.Shape();
         line.graphics.lineStyle(2, 0xffffff);
         line.graphics.moveTo(0, 0);
         line.graphics.lineTo(0, 117);
         line.graphics.endFill();
         line.x = 172;
         line.y = 61;
         this.addChild(line);
         this.line = line;

         let colorLabel = new egret.TextField();
         colorLabel.textColor = 0xffffff;
         colorLabel.width = this.stage.stageWidth - 172;
         colorLabel.textAlign = "center";
         colorLabel.text = "JL 蓝牙运动XXX";
         colorLabel.size = 24;
         colorLabel.x = 172;
         colorLabel.y = 80;
         this.addChild(colorLabel);
         this.colorLabel = colorLabel;

         let textfield = new egret.TextField();
         this.addChild(textfield);
         textfield.alpha = 0;
         textfield.width = this.stage.stageWidth - 172;
         textfield.textAlign = egret.HorizontalAlign.CENTER;
         textfield.size = 24;
         textfield.textColor = 0xffffff;
         textfield.x = 172;
         textfield.y = 135;
         this.textfield = textfield;
     }
     /**
      * 自定义一些事件 // 所有的触摸事件都会在这里进行捕获
      */
     private onClickStart(event: egret.Event) {
         //debugger;
         //console.log("click start" + event);
         if(event.target == this.start){
             //删除提示信息
             this.removeChild(this.topMask);
             this.removeChild(this.icon);
             this.removeChild(this.line);
             this.removeChild(this.colorLabel);
             this.removeChild(this.textfield);
             this.removeChild(this.start);

             this.run_left_1.visible = true;
             this.run_left_2.visible = true;
             this.run_right_1.visible = true;
             this.run_right_2.visible = true;
             this.pause.visible = true;
             this.stop.visible = true;
             this.speed = 5;
             this.isPause = false;

             this.removeEventListener(egret.Event.ENTER_FRAME, this.enterFrameHandler, this);
             this.addEventListener(egret.Event.ENTER_FRAME, this.enterFrameHandler, this);
         }else if(event.target == this.stop){
             console.log("stop");
             this.onClickStop();
         }else if(event.target == this.pause ||event.target == this.pause_start){
             console.log("pause");
             this.onClickPause();
         }
         //this.backGroud.start();
         //正中间显示时间
         //左右两边显示距离

         //left 接受事件，并处理小车运动
         //right 接受事件，并处理小车运动

         //通过websocket发送接收数据，然后画动画
         //http://www.cnblogs.com/yangxiao/p/4686729.html
     }

     /**
      * 逐帧运动
      */
     public enterFrameHandler(event: egret.Event) : void{
         var y = this.run_left_1.y;
         if(y >= 480){
             y = -460;
         }else{
             y = y + this.speed;
         }
         this.run_left_1.y = y;
         this.run_right_1.y = y;
         y = this.run_left_2.y;
         if(y >= 480){
             y = -460;
         }else{
             y = y + this.speed;
         }
         this.run_left_2.y = y;
         this.run_right_2.y = y;

     }
     /**
      * 停止
      */
     public onClickStop(): void{
         this.removeEventListener(egret.Event.ENTER_FRAME, this.enterFrameHandler, this);
         this.isPause = true;
         //this.speed = 0;
     }
     /**
      * 暂停
      */
     public onClickPause(): void{
         if(this.isPause == true){
             this.isPause = false;
             this.pause.visible = true;
             this.pause_start.visible = false;
             this.addEventListener(egret.Event.ENTER_FRAME, this.enterFrameHandler, this);
         }else{
             this.isPause = true;
             this.pause.visible = false;
             this.pause_start.visible = true;
             this.removeEventListener(egret.Event.ENTER_FRAME, this.enterFrameHandler, this);
         }
     }
 }

4. 代码解释

　　第3-22行 是一些简单的全局变量定义
　　loadingView 是默认的加载动画
　　car1 car2 是两辆小车
　　start pause pause_start stop 是一些按钮
　　topMask line icon colorLabel textfield 是开始前的一些提示信息
　　run_left_1 run_left_2 run_right_1 run_right_2 是背景中左右两边绿色道路的移动
　　speed 是速度
　　isPause 表示是否暂停
　　第24-27行 就是一个构造函数，并注册一个事件监听器，表示舞台开始的时候就调用onAddToStage函数
　　第29-98行 这些是默认提供的
　　第103-211行 是创建场景 依次 背景图片、两辆小车、开始按钮等图片信息
　　里面还有一些设置坐标信息， 舞台大小 480X360 然后各个坐标都是绝对坐标，具体项目可以设置为按比例设置坐标。
　　最后的 this.addEventListener(egret.TouchEvent.TOUCH_TAP, this.onClickStart, this); 这句就是加上触摸事件监听器，
　　该工程中所有的事件都在这里进行处理。
　　第307-346行 就是一些事件的处理
　　当按下开始按钮时，就启动egret.Event.ENTER_FRAME帧运动监听器事件，按下暂停就取消该事件。
　　小车的移动就是左右两边的绿色树木的相对后移而已。具体可以看第351行的enterFrameHandler函数。

5.运行界面

　　这是一个会动的界面。可以通过点击右上角切换是否运动。

6.多说两句

　　其实啊，用这个开发效率还是很高的，运行效率的话就一般的，用Web的效率也就那样了，不过随着手机性能的提高，用这个开发一些中小型游戏还是没有问题的。egret的官方资料还是比较全面的，入门也简单，对于我有js基础，看了一下Demo和API基本一两天就可以进行实际开发了。

参考资料:

http://www.cnblogs.com/yangxiao/p/4686729.html
http://developer.egret.com/cn/github/egret-docs/Engine2D/getStarted/helloWorld/index.html

工程下载: http://files.cnblogs.com/files/wunaozai/EgretHelloWorld.zip

本文地址: http://www.cnblogs.com/wunaozai/p/6540474.html