安卓遊戲框架~~

想作個啥遊戲玩玩能夠看看，先記下來。

 

其主要「實用」之處在於：
1.框架總體很小，上手快，作大遊戲的公司沒多少，作小遊戲的我的開發者鋪天蓋地，相比動則上升到引擎級的龐然大物，小型的框架更加實用，更加考慮大多數開發者的利益。
2.小不等於不完善，之因此剝SDK的遊戲示例代碼的框架出來，就是學習後發現它對於系統事件的處理比較完善，另外我我的還修正了它對於來電處理等異常事件不完美之處，使其更加完善。
R.layout.main 佈局文件

1.     <?xml version="1.0" encoding="utf-8"?>
2.     <FrameLayout
3.         xmlns:android="http://schemas.android.com/apk/res/android"
4.         android:orientation="vertical"
5.         android:layout_width="match_parent"
6.         android:layout_height="match_parent">
7.         <com.mstanford.gameframework.GameSurfaceView
8.             android:id="@+id/gameview"
9.             android:layout_width="match_parent"
10.             android:layout_height="match_parent" />
11.         <RelativeLayout
12.             android:layout_width="match_parent"
13.             android:layout_height="match_parent">
14.             <TextView
15.                 android:id="@+id/textview"
16.                 android:layout_width="wrap_content"
17.                 android:layout_height="wrap_content"
18.                 android:layout_centerInParent="true"
19.                 android:gravity="center_horizontal"
20.                 android:textColor="#88ffffff"
21.                 android:textSize="24sp" />
22.         </RelativeLayout>
23.     </FrameLayout>

複製代碼

Activity類

1.     package com.mstanford.gameframework;
3.     import com.mstanford.gameframe.R;
4.     import android.app.Activity;
5.     import android.os.Bundle;
6.     import android.util.Log;
7.     import android.view.Menu;
8.     import android.view.MenuItem;
9.     import android.widget.TextView;
11.     public class GameActivity extends Activity {
13.     private GameSurfaceView gameSurfaceView;
15.     private GameThread gameThread;
17.     @Override
18.     public void onCreate(Bundle savedInstanceState) {
19.       super.onCreate(savedInstanceState);
20.       setContentView(R.layout.main);
22.       gameSurfaceView = (GameSurfaceView) this.findViewById(R.id.gameview);
23.       gameThread = gameSurfaceView.getThread();
24.       gameSurfaceView.setTextView((TextView) findViewById(R.id.textview));
26.       if (savedInstanceState == null) {
27.        // 遊戲第一次啓動時,初始化遊戲狀態
28.        gameThread.doStart();
29.        Log.w(this.getClass().getName(), "SIS is null");
30.       }
31.       else {
32.        // 從其餘應用界面切迴游戲時,若是Activity從新建立,則恢復上次切出遊戲時的各項數據
33.        gameThread.restoreState(savedInstanceState);
34.        Log.w(this.getClass().getName(), "SIS is nonnull");
35.       }
36.     }
38.     /**
39.       * 當Activity被切換到後臺時調用,存儲Activity從新建立時須要恢復的遊戲數據
40.       */
41.     @Override
42.     protected void onSaveInstanceState(Bundle outState) {
43.       super.onSaveInstanceState(outState);
44.       gameThread.saveState(outState);
45.       Log.w(this.getClass().getName(), "SIS called");
46.     }
48.     /**
49.       * 當Activity被切換到後臺時調用,在這裏對遊戲作"暫停"的處理
50.       */
51.     @Override
52.     protected void onPause() {
53.       super.onPause();
54.       // 暫停遊戲
55.       gameSurfaceView.getThread().pause();
56.     }
58.     /**
59.       * 當Activity切換到前臺時調用
60.       */
61.     @Override
62.     protected void onResume() {
63.       super.onResume();
64.       // 遊戲結束暫停狀態,遊戲正常進行
65.       gameSurfaceView.getThread().unpause();
66.     }
68.     /**
69.       * 建立遊戲菜單
70.       */
71.     @Override
72.     public boolean onCreateOptionsMenu(Menu menu) {
73.       // TODO Auto-generated method stub
74.       return super.onCreateOptionsMenu(menu);
75.     }
77.     /**
78.       * 定義遊戲菜單的點擊事件處理
79.       */
80.     @Override
81.     public boolean onOptionsItemSelected(MenuItem item) {
82.       // TODO Auto-generated method stub
83.       return super.onOptionsItemSelected(item);
84.     }
86.     @Override
87.     protected void onDestroy() {
88.       super.onDestroy();
89.       Log.v(this.getClass().getName(), "onDestroy");
90.       
91.       //中止遊戲
92.       gameThread.setRunning(false);
93.       boolean retry = true;
94.       while (retry) {
95.        try {
96.         //阻塞Activity的主線程直到遊戲線程執行完
97.         gameThread.join();
98.         retry = false;
99.        } catch (InterruptedException e) {
100.        }
101.       }
102.     }
103.     }

複製代碼

SurfaceView類

1.     package com.mstanford.gameframework;
3.     import android.content.Context;
4.     import android.os.Handler;
5.     import android.os.Message;
6.     import android.util.AttributeSet;
7.     import android.util.Log;
8.     import android.view.KeyEvent;
9.     import android.view.SurfaceHolder;
10.     import android.view.SurfaceView;
11.     import android.view.SurfaceHolder.Callback;
12.     import android.widget.TextView;
14.     public class GameSurfaceView extends SurfaceView implements Callback {
16.     private GameThread gameThread;
18.     private TextView textview;
20.     public GameSurfaceView(Context context, AttributeSet attrs) {
21.       super(context, attrs);
22.       SurfaceHolder holder = getHolder();
23.       holder.addCallback(this);
25.       gameThread = new GameThread(holder, context, new Handler() {
26.        @Override
27.        public void handleMessage(Message m) {
28.         textview.setText(m.getData().getString("text"));
29.        }
30.       });
32.       // 設置可得到焦點,確保能捕獲到KeyEvent
33.       setFocusable(true);
34.     }
36.     /**
37.       * 獲取一個Activity傳來的View協助SurfaceView顯示遊戲視圖,View的具體類型能夠根據遊戲須要來定
38.       */
39.     public void setTextView(TextView view) {
40.       this.textview = view;
41.     }
43.     public GameThread getThread() {
44.       return gameThread;
45.     }
47.     @Override
48.     public boolean onKeyDown(int keyCode, KeyEvent event) {
49.       return gameThread.doKeyDown(keyCode, event);
50.     }
52.     @Override
53.     public boolean onKeyUp(int keyCode, KeyEvent event) {
54.       return gameThread.doKeyUp(keyCode, event);
55.     }
57.     /**
58.       * 當SurfaceView獲得或失去焦點時調用,使遊戲暫停/恢復運行,
59.       */
60.     @Override
61.     public void onWindowFocusChanged(boolean hasWindowFocus) {
62.       if (!hasWindowFocus) {
63.        gameThread.pause();
64.       }
65.       else {
66.        gameThread.unpause();
67.       }
68.     }
70.     @Override
71.     public void surfaceChanged(SurfaceHolder holder, int format, int width,
72.        int height) {
73.       Log.v(this.getClass().getName(), "surfaceChanged()");
74.       gameThread.setSurfaceSize(width, height);
76.       gameThread.setRunning(true);
78.       if (gameThread.isAlive()) {
79.        Log.v(this.getClass().getName(), "unpause gameThread");
80.        gameThread.unpause();
81.       }
82.       else {
83.        Log.v(this.getClass().getName(), "start gameThread");
84.        gameThread.start();
85.       }
87.     }
89.     @Override
90.     public void surfaceCreated(SurfaceHolder holder) {
91.       Log.v(this.getClass().getName(), "surfaceCreated()");
92.       }
94.     /**
95.       * 爲防止surface還會被建立(好比來電)致使gameThread再次啓動出現錯誤,且Activity的onPause方法中已作暫停處理,
96.       * 這邊不對gameThread作處理
97.       * @param holder
98.       */
99.     @Override
100.     public void surfaceDestroyed(SurfaceHolder holder) {
101.       Log.v(this.getClass().getName(), "surfaceDestroyed");
102.     }

複製代碼

遊戲線程類

1.     package com.mstanford.gameframework;
3.     import android.content.Context;
4.     import android.graphics.Canvas;
5.     import android.os.Bundle;
6.     import android.os.Handler;
7.     import android.util.Log;
8.     import android.view.KeyEvent;
9.     import android.view.SurfaceHolder;
11.     public class GameThread extends Thread {
13.     // 遊戲狀態值:ready
14.     public final static int GS_READY = 0;
16.     //遊戲線程每執行一次須要睡眠的時間
17.     private final static int DELAY_TIME = 100;
19.     //上下文,方便獲取到應用的各項資源,如圖片、音樂、字符串等
20.     private Context context;
22.     //與Activity其餘View交互用的handler
23.     private Handler handler;
25.     //由SurfaceView提供的SurfaceHolder
26.     private SurfaceHolder surfaceHolder;
28.     //遊戲線程運行開關
29.     private boolean running = false;
31.     //遊戲狀態
32.     private int gameState;
34.     //當前surface/canvas的高度,在surfaceChanged方法中被設置
35.         private int mCanvasHeight = 1;
37.       //當前surface/canvas的寬度,在surfaceChanged方法中被設置
38.         private int mCanvasWidth = 1;
39.       
40.         /**
41.          * 遊戲是否暫停
42.          */
43.         private boolean isPaused = false;
45.     public GameThread(SurfaceHolder holder, Context context, Handler handler) {
46.       this.surfaceHolder = holder;
47.       this.context = context;
48.       this.handler = handler;
49.     }
51.     /**
52.       * 設置遊戲狀態
53.       * @param mode 遊戲狀態
54.       */
55.     public void setState(int mode) {
56.       synchronized (surfaceHolder) {
57.        setState(mode, null);
58.       }
59.     }
61.     /**
62.       * 設置遊戲狀態
63.       * @param mode 遊戲狀態
64.       * @param message 設置遊戲狀態時的附加文字信息
65.       */
66.     public void setState(int mode, CharSequence message) {
67.       synchronized (surfaceHolder) {
68.        // TODO
69.       }
70.     }
72.     /**
73.       * 暫停遊戲
74.       */
75.     public void pause() {
76.       synchronized (surfaceHolder) {
77.        isPaused = true;
78.       }
79.     }
81.     /**
82.       * 恢復運行遊戲
83.       */
84.     public void unpause() {
85.       //若是遊戲中有時間,別忘記應將其在這裏調整到正常
86.       synchronized (surfaceHolder) {
87.        isPaused = false;
88.       }
89.     }
91.     /**
92.       * 當Activity因銷燬而被從新建立時,在這裏恢復遊戲上次運行的數據
93.       * @param saveState Activity傳來的保存遊戲數據的容器
94.       */
95.     public void restoreState(Bundle saveState) {
96.       //TODO
97.     }
99.     /**
100.       * 在Activity切到後臺時保存遊戲的數據
101.       * @param outState 保存遊戲數據的容器
102.       */
103.     public void saveState(Bundle outState)
104.     {
105.       //TODO
106.     }
108.     /**
109.       * 設置遊戲線程運行開關
110.       * @param b 開/關
111.       */
112.     public void setRunning(boolean b) {
113.       running = b;
114.     }
116.     /**
117.       * 處理按下按鍵的事件
118.       * @param keyCode 按鍵事件動做值
119.       * @param msg 按鍵事件對象
120.       * @return 是否處理完
121.       */
122.     public boolean doKeyDown(int keyCode, KeyEvent msg) {
123.       synchronized (surfaceHolder) {
124.        // TODO
125.        return false;
126.       }
127.     }
129.     /**
130.       * 處理彈起按鍵的事件
131.       * @param keyCode 按鍵事件動做值
132.       * @param msg 按鍵事件對象
133.       * @return 是否處理完
134.       */
135.     public boolean doKeyUp(int keyCode, KeyEvent msg) {
136.       synchronized (surfaceHolder) {
137.        // TODO
138.       }
139.       return false;
140.     }
142.     /**
143.       * 設置surface/canvas的寬度和高度
144.       * @param width 由SurfaceHolder傳來的寬度
145.       * @param height 由SurfaceHolder傳來的高度
146.       */
147.     public void setSurfaceSize(int width, int height) {
148.       // synchronized to make sure these all change atomically
149.       synchronized (surfaceHolder) {
150.        mCanvasWidth = width;
151.        mCanvasHeight = height;
152.        //不要忘記每次畫布的寬度和高度改變時, 在這裏對圖片等資源作縮放等相關適配屏幕的處理
153.        //TODO
154.       }
155.     }
157.     public void run() {
158.       while (running) {
159.        if (!isPaused) {
160.         Canvas c = null;
161.         try {
162.          c = surfaceHolder.lockCanvas(null);
163.          synchronized (surfaceHolder) {
164.           doDraw(c);
165.          }
166.          logic();
167.         } finally {
168.          if (c != null) {
169.           surfaceHolder.unlockCanvasAndPost(c);
170.          }
171.         }
172.         try {
173.          Thread.sleep(DELAY_TIME);
174.         } catch (InterruptedException e) {
175.          e.printStackTrace();
176.         }
177.        }
178.       }
179.     }
181.     /**
182.       * 遊戲邏輯處理
183.       */
184.     public void logic()
185.     {
186.       Log.v(this.getClass().getName(), "logic");
187.       //TODO
188.     }
190.     /**
191.       * 遊戲繪畫
192.       */
193.     private void doDraw(Canvas canvas) {
194.       Log.v(this.getClass().getName(), "doDraw");
195.       //TODO
196.     }
198.     /**
199.       * 初始化遊戲開始時的參數
200.       */
201.     private void doStart() {
202.       //TODO
203.     }
204.     }