Java究竟怎么玩？

較早前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