An easy open source Android game engine.

引擎核心类流程图

使用方法

引入Engine作为Library进行使用。

快速入门

• 1.基础功能
  • 1.1继承引擎核心类
  • 1.2绘制文字
  • 1.3绘制图片
  • 1.4使用精灵
  • 1.5使用按钮
• 2.动画系统
  • 2.1绑定在BaseSub物品及精灵基类上的动画类
  • 2.2绑定在Button上的动画类
• 3.碰撞检测和死亡判定
• 4.屏幕扫描模式
• 5.工具类

1.基础功能

1.1继承引擎核心类：

由于框架全部使用SurfaceView进行绘制，不使用诸如Button、Layout等原生控件，所以应该首先新建类继承引擎核心类Engine，负责游戏的流程，注释中已有明确的标明功能。

    public class Game extends Engine {      // 一般在构造函数完成变量的初始化      public Game() {          // 控制debug模式是否开始，debug模式打印日志、帧数、pause次数等信息          super(true);        }        // 载入一些UI参数和设置屏幕放向，默认背景色，设定屏幕的扫描方式等      @Override      public void init() {          // 初始化UI默认参数，必须调用该方法，其中有一些用于多机型适配的参数需要初始化          UIdefaultData.init(this);      }        // 通常用于精灵，背景，图片等物体的设置和载入      @Override      public void load() {        }        // draw 和 update 在线程中进行不断的循环刷新      // draw 负责绘制 update 负责更新数据和对象信息      @Override      public void draw() {        }        @Override      public void update() {        }        // 将touch 事件传回 功能和所设定的屏幕扫描方式有关      @Override      public void touch(MotionEvent event) {        }        // 将碰撞事件传回 传回精灵和物品的基类       // 用于处理碰撞事件 默认使用矩形碰撞      @Override      public void collision(BaseSub baseSub) {        }      }

1.2绘制文字：

使用GamePrinter进行文字绘制,除此以外还有多种方法绘制:

    @Override      public void draw() {          Canvas canvas = getCanvas();          GameTextPrinter printer = new GameTextPrinter(canvas);          printer.drawText("哈哈哈", 100, 100);      }

效果图：

1.3绘制图片：

建议图片存放在Asset中：

 GameTexture texture = new GameTexture(this);      texture.loadFromAsset("pic/logo.jpg")      texture.draw(canvas, 100, 100);

   /**       * get bitmap from a big bitmap       *       * @param filename       * @param x       * @param y       * @param width       * @param height       * @return       */      public boolean loadFromAssetStripFrame(String filename,                                             int x, int y,                                             int width, int height)

比如可以通过这四个参数把这个小飞机取出来：

PicUtils中提供了在Bitmap处理中很有用的各种特效和压缩方法，大家可以一试。

1.4使用精灵：

使用精灵可以使用BaseSprite也可以继承该类使用，BaseSprite封装了很多方法供各种动画使用，这些功能很多都是需要结合动画系统来使用的，动画系统会在后面介绍。

新建精灵：

1.简单初始化:

          sprite = new BaseSprite(this);

2.初始化连续帧动画：
连续帧的初始化需要这样的连续帧图片:

        GameTexture texture = new GameTexture(this);          texture.loadFromAsset("pic/zombie.png");          // 长宽以及列数          sprite = new BaseSprite(this, 96, 96, 8);          sprite.setTexture(texture);          sprite.setPosition(100, 100);          sprite.setDipScale(100, 100);          // 帧切换动画是关键          sprite.addAnimation(new FrameAnimation(0, 63, 1));          addToSpriteGroup(sprite);

        // 新建图片资源（此图为上图的大图）          GameTexture texture = new GameTexture(this);          texture.loadFromAsset("pic/shoot.png");          // 初始化设定模式和长宽          ship = new BaseSprite(this, 100, 124, FrameType.COMMON);          // 设定资源          ship.setTexture(texture);          // 从大图中取出两帧          ship.addRectFrame(0, 100, 100, 124);          ship.addRectFrame(167, 361, 100, 124);          ship.addAnimation(new FrameAnimation(0, 1, 1));

        ship.addAnimation(new FrameAnimation(0, 1, 1));

效果图(两帧图片不断切换):

4.一些重要的其他设定：

    // 图片资源        ship.setTexture(texture);        // 大图取帧模式        ship.addRectFrame(0, 100, 100, 124);        // 设定位置        ship.setPosition(x, y);        // 设置dp大小        ship.setDipScale(96, 96);        // 设定dp位置        ship.setDipPosition(x, y);        // 设定透明度        ship.setAlpha(...);        // 只有将精灵添加到SpriteGroup中框架才会自行绘制，否则需要手动调用        addToSpriteGroup(ship);        ...

1.5使用按钮：

使用的按钮可以继承BaseButton进行拓展，也可以直接使用TextureButton和TextButton进行使用。
Button设定功能的方式和原生一样，通过设定接口回调的方式进行：

       button.setOnClickListener(new OnClickListener() {            @Override            public void onClick() {                Log.e("button", "onClick");            }          });

     TextureButton button;        // 初始化并设定名字        button = new TextureButton(this, "logo");        texture = new GameTexture(this);        texture.loadFromAsset("pic/logo.jpg");        // 添加图片资源        button.setTexture(texture);        // button的接口回调，不是View的那个接口        button.setOnClickListener(new OnClickListener() {            @Override            public void onClick() {                Log.e("button", "onClick");            }          });        button.setPosition(200, 300);        button.setDipScale(100, 150);        // 添加到ButtonGroup进行绘制和处理        addToButtonGroup(button);

效果图:

结合PicUtil中的各种Bitmap处理方法可以很容易的做出各种样式的Button：

2.TextButton:

      TextButton button;          button = new TextButton(this, "logo");        button.setText("刘丰恺");        addToButtonGroup(button);        // 余略见源码        ...

效果图：

2.动画系统

目前的动画系统可以使用已经封装好的继承了BaseAnimation的动画，也可以继承BaseAnim进行自我定义动画类进行使用。

2.1绑定在BaseSub物品及精灵基类上的动画类

AnimType中保存了Animation的应用类型。

绑定动画分为两类，ListAnimation和FixedAnimation,ListAnimation将动画存储到固定的一个List中，用于重复更新的动画，而FixedAnimation存储在Map中，使用名字进行调用，用于点击或者非自动更新的动画。比如前面精灵类动画的就是添加到ListAnimation。下面的这种写法就是FixedAnimation，这个动画是小飞机入场，因为只使用了一次，所以使用了FixedAnimation。

    ship.addfixedAnimation("start",                  new MoveAnimation(UIdefaultData.centerInHorizontalX -   ship.getWidthWithScale() / 2,                          UIdefaultData.screenHeight - 2 * ship.getHeightWidthScale(), new Float2(10, 10)));

效果图:

2.2绑定在Button上的动画类

BaseButtonAnimation是BaseButton的动画类继承了BaseAnim的动画基类，通过提供Button的状态，设定Button的动画。

为Button设定放缩动画:

    // 设定中心放缩      button.setZoomCenter(true);      // 三个参数 初始值／放大值／帧数      button.setAnimation(new ZoomCenterButtonAnim(10, 30, 3));

效果图:

为Button设定颜色动画:

    // 初始颜色 ／ 按下颜色      button.setAnimation(         new ColorAnimation(UIdefaultData.colorAccent,         UIdefaultData.colorPressed));

效果图:

3.碰撞检测和死亡判定

只要使用了addToSpriteGroup(sprite)的精灵对象就会自动进行碰撞检测，而对碰撞检测的结果会从collision中进行发回。

    @Override      public void collision(BaseSub baseSub) {          // 获取与之碰撞的对象          BaseSprite other = (BaseSprite) baseSub.getOffender();          // 获取ID分组处理          if (baseSub.getIdentifier() == BULLET &&                  other.getIdentifier() == ENEMY) {              // 设定死亡              other.setAlive(false);              // 回收              removeFromSpriteGroup(other);              addToRecycleGroup(other);          }      }

其中getOffender()获得与之碰撞的对象，通过getIdentifier()获取设定的对象分组，实行逻辑判断。开启Debug模式会看见碰撞线。
效果图:

4.屏幕扫描模式

屏幕扫描模式是用来优先响应屏幕点击、Button点击、和多点触控而设的，放置在不同情况下都能优化屏幕的刷新。

    // 检测单一移动      SINGLE,      // 检测Button      BUTTON,      // 多点检测      FULL,      // 单击＋Button      SINGLE_BUTTON

5.工具类

• NetUtils网络状态工具类
• PicUtils图片处理工具类
• ServiceUtils服务工具类
• ImageHelper图型处理类
  
• DisplayUtils数据转换类
• SpUtilsSp简化工具类（可存储list和map）
• ValidatorsUtils正则表达式处理类
  

引擎初步封装完毕

以之开发的微信打飞机游戏Demo：Demo地址

项目主页：http://www.open-open.com/lib/view/home/1450070801657