LGame(Android及J2SE游戏引擎)入门示例——如何构建一个游戏

较早前LGame示例下载地址：http://loon-simple.googlecode.com/files/LGame-Simple-0.2.5.7z

最新版LGame(0.2.6)下载地址：http://loon-simple.googlecode.com/files/LGame-0.2.6.rar

1、如何启动LGame

目前的LGame提供有J2SE以及Android两个开发版本，两版的主要类及函数虽然相同，但由于Android版对应于手机环境，而J2SE版对应于PC环境，所以依旧有少许的差别。

J2SE版：

在J2SE环境下，只需要在Main函数中构造如下内容即可。

public static void main(String[] args) { // 获得一个游戏窗体 GameScene frame = new GameScene("窗体名", 480, 320); // 得到此窗体所对应的游戏部署器 Deploy deploy = frame.getDeploy(); // 设定此游戏屏幕（在任何时候都可以通过Screen中的setScreen函数切换游戏屏幕） deploy.setScreen(new Game()); // 是否显示FPS deploy.setShowFPS(true); // 是否显示框架logo deploy.setLogo(false); // 允许的最大刷新率 deploy.setFPS(100); // 开始游戏主循环 deploy.mainLoop(); // 显示游戏画面 frame.showFrame(); }

Android版：

而在Android版中，我们则需要分两步走，一是需要配置相关的AndroidManifest.xml 文档。

如下所示：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="org.loon.test" android:versionCode="1" android:versionName="1.0"> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".Main" android:configChanges="orientation|keyboardHidden" <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> <uses-sdk android:minSdkVersion="3" /> <uses-permission android:name="android.permission.INTERNET"/> </manifest>

而调用的方法如下：

package org.loon.test; import org.loon.framework.android.game.LAD; import org.loon.framework.android.game.LGameAndroid2DActivity; import org.loon.framework.android.game.core.LSystem; import android.os.Bundle; public class Main extends LGameAndroid2DActivity { public void onCreate(Bundle icicle) { // 有Admob广告，纵屏显示，广告居于屏幕下方，广告ID为“XXXXXXXX”，广告刷新速度为60秒 this.initialization(icicle,false,LAD.BOTTOM, "XXXXXXXX",60); // 无Admob广告，纵屏显示 // this.initialization(icicle,false); // 使用游戏窗体Game this.setScreen(new Game()); // 设定FPS为60 this.setFPS(60); // 不显示游戏Logo（设定Logo为setLogo） this.setShowLogo(false); // 显示FPS this.setShowFPS(true); // 显示游戏画面 this.showScreen(); } }

这时LGame框架就会根据我们所实现的不同Screen，来展示我们的游戏了(很简单吧)。

2、如何构建Screen类

Screen是一个抽象类，也是LGame框架所提供的游戏界面展示器，其中封装了基本的图形接口与相关的操作设备交互函数，在LGame框架中，可以直接作为游戏界面进行展示的Screen共有三种。

一、Screen

即最基本的Screen，包含了最基本的Screen函数，默认自动刷新游戏画面(根据FPS所设定的速度)，不提供repaint以及getLGraphics方法，是提供LGame框架调用的最基本Screen形态。

J2SE版使用方式如下：

import java.awt.event.KeyEvent; import java.awt.event.MouseEvent; import org.loon.framework.game.simple.core.graphics.Screen; import org.loon.framework.game.simple.core.graphics.device.LGraphics; public class ScreenExample extends Screen { // draw中LGraphics会根据设定的FPS自动刷新，使用上与标准的J2SE Graphics以及J2ME Graphics接口没有区别（API为二者的综合） public void draw(LGraphics g) { } // 鼠标左键 public void leftClick(MouseEvent e) { } // 鼠标中间键 public void middleClick(MouseEvent e) { } // 鼠标右键 public void rightClick(MouseEvent e) { } // 键盘按下 public void onKey(KeyEvent e) { } // 键盘放开 public void onKeyUp(KeyEvent e) { } }

另外，在 Screen 中还有一个重要的 alter 函数，我们可以通过重载 alter 函数实现最简单的定时操作，譬如 :

// 设定计时器，每隔 1 秒允许执行一次

LTimer timer = new LTimer(LSystem. SECOND );

// 重载 alter 函数

public void alter(LTimerContext context){

if ( timer .action(context.getTimeSinceLastUpdate())){

}

}

Android版使用方式如下：

Android 版 Screen API 与使用方法基本等价于 J2SE 版，但由于手机与 PC 间功能有所差别，所以具体的 API 名及函数有所不同。

import org.loon.framework.android.game.core.graphics.Screen; import android.view.KeyEvent; import android.view.MotionEvent; public class ScreenExample extends Screen{ // 与J2SE版相同，draw中LGraphics会根据设定的FPS自动刷新，使用上与标准的J2SE Graphics以及J2MEGraphics接口没有区别（API为二者的综合） public void draw(LGraphics g) { } //键盘按下 public boolean onKeyDown(int keyCode, KeyEvent e) { return true; } //键盘放开 public boolean onKeyUp(int keyCode, KeyEvent e) { return true; } //触摸屏按下 public boolean onTouchDown(MotionEvent e) { return true; } //手指在触摸屏上移动 public boolean onTouchMove(MotionEvent e) { return true; } //触摸屏放开 public boolean onTouchUp(MotionEvent e) { return true; } }

关于 alter 函数部分完全一致。

二、ThreadScreen

J2SE版：

ThreadScreen 是一个实现了 Runnable 接口的 Screen ，它采用 double buffer 方式将绘图与业务线程分离， gameLoop 函数中即是一个独立的线程。

import java.awt.event.KeyEvent; import java.awt.event.MouseEvent; import org.loon.framework.game.simple.core.graphics.ThreadScreen; import org.loon.framework.game.simple.core.graphics.device.LGraphics; public class ThreadScreenExample extends ThreadScreen { public ThreadScreenExample () { // ThreadScreen及CanvasScreen都允许变更游戏图形界面大小，下例重载参数为最初（实际）的界面大小。 super(300, 450); // 设定显示时图像大小，此时游戏将以320x480的大小运行（视原有界面不同，会有不同程度的失真） resizeScreen(320, 480); } // ThreadScreen绘图器，为标准Screen中draw函数的封装，区别在于ThreadScreen的修改仅在repaint时生效，而且ThreadScreen不会自动清除原有的图像内容。 public void drawScreen(LGraphics g) { } // gameLoop的刷新速度可以通过setSynchroFPS函数调整。 public void gameLoop() { } // 鼠标左键 public void leftClick(MouseEvent e) { } // 鼠标中间键 public void middleClick(MouseEvent e) { } // 鼠标右键 public void rightClick(MouseEvent e) { } // 键盘按下 public void onKey(KeyEvent e) { } // 键盘放开 public void onKeyUp(KeyEvent e) { } }

与标准 Screen 的其它区别在于， ThreadScreen 可以通过 getLGraphics 或 getDraw （ Draw 类为 LGraphics 的简化封装）函数直接获得对 LGraphics 的操作权，并非一定要通过 drawScreen 函数绘图。

Android版：

J2SE 与 Android 版的差别仅仅在于鼠标、键盘等设备函数上，其它细节相同。

import org.loon.framework.android.game.core.graphics.ThreadScreen; import android.view.KeyEvent; import android.view.MotionEvent; public class ThreadScreenExample extends ThreadScreen { public ThreadScreenExample () { // ThreadScreen及CanvasScreen都允许变更游戏图形界面大小，下例重载参数为最初（实际）的界面大小。 super(300, 450); // 设定显示时图像大小，此时游戏将以320x480的大小运行（视原有界面不同，会有不同程度的失真） resizeScreen(320, 480); } // ThreadScreen绘图器，为标准Screen中draw函数的封装，区别在于drawScreen的修改仅在repaint时生效，而且drawScreen不会自动清除原有的图像内容。 public void drawScreen(LGraphics g) { } // gameLoop的刷新速度可以通过setSynchroFPS函数调整。 public void gameLoop() { } //键盘按下 public boolean onKeyDown(int keyCode, KeyEvent e) { return true; } //键盘放开 public boolean onKeyUp(int keyCode, KeyEvent e) { return true; } //触摸屏按下 public boolean onTouchDown(MotionEvent e) { return true; } //手指在触摸屏上移动 public boolean onTouchMove(MotionEvent e) { return true; } //触摸屏放开 public boolean onTouchUp(MotionEvent e) { return true; } }

三、CanvasScreen

CanvasScreen 是 0.2.6 版中最新提供的 Screen 实现，模拟 J2ME 中 Canvas 而成（也混合了 GameCanvas 的 API ），相关函数在 J2SE 及 Android 版中完全一致。

import org.loon.framework.game.simple.core.graphics.CanvasScreen; import org.loon.framework.game.simple.core.graphics.device.LGraphics; public class CanvasScreenExample extends CanvasScreen { public CanvasScreenExample(){ //与ThreadScreen相同，CanvaScreen允许改变游戏图像大小。 //以下参数分为别原始的图像宽与高（300x450），要求显示的宽与高(320x480) super(300,450,320,480); } // CanvasScreen绘图器，与标准Screen中draw函数的区别在于paint的修改仅在repaint时生效，而且paint不会自动清除原有的图像内容。 public void paint(LGraphics g) { } // 键盘按下 public void keyPressed(int keyCode) { } // 键盘放开 public void keyReleased(int keyCode) { } // 触摸屏或鼠标移动 public void pointerMove(double x, double y) { } // 触摸屏或鼠标按下 public void pointerPressed(double x, double y) { } // 触摸屏或鼠标放开 public void pointerReleased(double x, double y) { } }

与标准 Screen 的其它区别在于， CanvasScreen 可以通过 getLGraphics 函数直接获得对 LGraphics 的操作权，并非一定要通过 paint 函数绘图。另外，由于 CanvasScreen 的 Paint 函数并不直接关联父类的 draw 函数，所以 LGame 中提供的精灵或组件无法直接通过 add 函数加载显示，而是只能在 paint 中手动调用相应组件的绘图器进行绘制（关于这点，用惯 J2ME 的朋友应该没什么不习惯的。另外 LGame 提供有配套的 j2me 精灵类包可供使用，为 1 ： 1 仿 J2ME 原有 API 实现）。

以下是一个CanvasScreen的使用示例：

//初始化时的精灵动画

//移动时的精灵动画

//背景图片

请注意，为了演示图像扩大机制，示例所用的精灵以及游戏背景图像都非常之小，而实际开发中并非一定要使用图像扩充，更不是只能使用此比例的图像。

下面我制作一个 Sword.java ，这是一个自定义的精灵类，用以显示上图所示的“骷髅剑士”。（在不重新实现 ISprite 的基础上，我们也可以直接使用现成的 Sprite 类来完成此例。但是，关于动作细节部分就只能在精类外部设定或者重载 Sprite 的 update 函数来实现（和实现 ISprite 没什么区别了 ||| ））。

import org.loon.framework.game.simple.action.map.RectBox; import org.loon.framework.game.simple.action.sprite.Animation; import org.loon.framework.game.simple.action.sprite.ISprite; import org.loon.framework.game.simple.action.sprite.SpriteImage; import org.loon.framework.game.simple.core.LObject; import org.loon.framework.game.simple.core.LSystem; import org.loon.framework.game.simple.core.graphics.device.LGraphics; import org.loon.framework.game.simple.core.timer.LTimer; public class Sword extends LObject implements ISprite { /** * */ private static final long serialVersionUID = 1L; // 精灵移动范围的最大宽度（即背景图实际宽，为240） private static final int WIDTH = 240; private boolean init, right, flag, visible; private int randX; private Animation animation; private LTimer time; private static final String kName1 = "res/s1.png", kName2 = "res/s2.png"; public Sword() { // 加载怪物剑士的“出土”动画（以下参数为图像所在地址、图像宽、图像高、播放间隔） this.animation = Animation.getDefaultAnimation(kName1, 18, 18, 150); // 设定计时器间隔为10豪秒 this.time = new LTimer(10); // 设定精灵初始位置（x轴随机，y轴48（立于相对于背景视觉的“地面”上）） this.setLocation(LSystem.random.nextInt(WIDTH), 48); // 随机决定精灵剑士向左或向右冲锋 this.right = LSystem.random.nextInt(2) == 0 ? true : false; // 随机决定精灵剑士以匀速或两倍速前进 this.flag = LSystem.random.nextInt(2) == 0 ? true : false; // 随机决定精灵剑士的“冲锋”停止点 this.randX = LSystem.random.nextInt(70); // 当前精灵可见 this.visible = true; } // 设定精灵绘图器内容 public void createUI(LGraphics g) { if (animation != null) { // PS:Android版中没有提供序列化保存SpriteImage的方法，直接getImage即可，而没有serializablelImage。 // 反转图像 if (right) { g.drawMirrorImage(animation.getSpriteImage().serializablelImage .getImage(), x(), y()); // 正向 } else { g.drawImage(animation.getSpriteImage().serializablelImage .getImage(), x(), y()); } } } // 当前精灵宽 public int getWidth() { SpriteImage si = animation.getSpriteImage(); if (si == null) { return -1; } return si.getWidth(); } // 当前精灵高 public int getHeight() { SpriteImage si = animation.getSpriteImage(); if (si == null) { return -1; } return si.getHeight(); } // 精灵计时器，用以在timer满足条件时变更精灵样式 public void update(long timer) { if (time.action(timer)) { animation.update(timer); // 当动画没有播放时 if (!animation.isRunning()) { // 初始化动画精灵（以下参数为图像所在地址、图像宽、图像高、播放间隔） animation = Animation.getDefaultAnimation(kName2, 26, 18, 50); } else if (animation.isRunning() && init) { // 向左 if (!right && (x() + randX) > 0) { if (flag) { // 精灵向左移动 move_left(); } else { // 精灵向左移动（速度x2） move_left(2); } if ((x() - randX) <= 0) { right = true; } // 向右 } else if (right && (x() + animation.getSpriteImage().getWidth() - randX) <= WIDTH) { if (flag) { // 精灵向右移动（速度x2） move_right(2); } else { // 精灵向右移动 move_right(); } // 当达到屏幕边缘时，改变移动方向 if ((x() + animation.getSpriteImage().getWidth() + randX) >= WIDTH) { right = false; } } } // 当精灵动画结束时，设定init=true(精灵动画播放完毕) if (!init && animation.getTotalFrames() - 1 == animation .getCurrentFrameIndex()) { animation.setRunning(false); init = true; } } } // 透明度 public float getAlpha() { return 0; } // 碰撞盒 public RectBox getCollisionBox() { return new RectBox(Math.round(x()), Math.round(y()), getWidth(), getHeight()); } // 显示状态 public boolean isVisible() { return visible; } // 是否显示精灵 public void setVisible(boolean visible) { this.visible = visible; } }

设定一个 CanvasScreenExample.java ，用以继承 CanvasScreen 。

import org.loon.framework.game.simple.GameScene; import org.loon.framework.game.simple.action.sprite.Sprites; import org.loon.framework.game.simple.core.graphics.CanvasScreen; import org.loon.framework.game.simple.core.graphics.Deploy; import org.loon.framework.game.simple.core.graphics.LImage; import org.loon.framework.game.simple.core.graphics.device.LGraphics; public class CanvasScreenExample extends CanvasScreen implements Runnable { // 设定精灵组，显示范围为宽240，高80（此为实际背景图大小） private Sprites sprs = new Sprites(240, 80); // 设定背景图像 private LImage background = LImage.createImage("res/background.png"); // 是否允许线程运行 private boolean running; // 刷新间隔 private long speed = 30; public CanvasScreenExample() { // 重载游戏画面大小，将240x80的实际游戏图像大小，扩大为480x160的显示大小 super(240, 80, 480, 160); // 创建五个骷髅剑士的精灵 Sword[] sw = new Sword[5]; //循环载入 for (int i = 0; i < sw.length; i++) { // 将精灵载入精灵管理器 sprs.add(sw[i] = new Sword()); } // 允许线程运行 this.running = true; // 启动线程 this.callEvent(new Thread(this)); } // 当切换不同的Screen，或者游戏结束时，会触发此函数 public void dispose() { this.running = false; } // 在绘图器中绘制背景图以及相关精灵 public void paint(LGraphics g) { // 绘制背景图像到位置(0,0) g.drawImage(background, 0, 0); // 绘图精灵组中所有精灵(默认位置(0,0)，也允许通过setLocation或setViewWindow变更显示位置及显示范围) sprs.createUI(g); } public void run() { while (running) { // 刷新游戏画面 this.repaint(); // 间隔30豪秒 this.pause(speed); // 刷新精灵组 sprs.update(speed); } } public void keyPressed(int keyCode) { } public void keyReleased(int keyCode) { } public void pointerMove(double x, double y) { } public void pointerPressed(double x, double y) { } public void pointerReleased(double x, double y) { } }

此时，我们只需要根据需要实例化相关的Screen(也就是setScreen)，就会得到如下效果：

实际运行效果如下（ Android 版效果与此相同， PC 版中窗体实际大小被设定为 480x320 ）

PS: 在 CanvasScreen 中也允许完全照搬 J2ME 中 Canvas(GameCanvas) 与相关精灵（内置有 API 1:1 的精灵类相关实现）的构建方式，可以将任何 J2ME 游戏代码平移其中。简单的讲，您在只掌握 J2ME 技术的情况下也可以使用 LGame ，而无需单独学习任何 LGame 框架本身的构建方式。

较早前LGame示例(仅PC版)下载地址：http://loon-simple.googlecode.com/files/LGame-Simple-0.2.5.7z

最新版LGame(0.2.6)下载地址：http://loon-simple.googlecode.com/files/LGame-0.2.6.rar