萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 俄羅斯方塊遊戲完整實現:狀態機、雙緩衝繪製、音效、觸控操作

架構設計

  • 狀態數據層:statefang.java 定義 7 種方塊 (I, O, L, J, T, S, Z) 各 4 種旋轉狀態,共 28 個 4x4 矩陣
  • 資源管理層:GameResources 集中加載 Bitmap、九宮圖、分數數字圖、背景、開始界面
  • 音頻層:MusicPlay 封裝 MediaPlayer (背景音樂) + SoundPool (音效:消行、旋轉、落地)
  • 遊戲邏輯層:主遊戲 View 繼承 SurfaceView + Runnable,獨立繪製線程,固定幀率 (如 30 FPS) 更新狀態
  • 輸入層:觸摸區域劃分 (左移、右移、旋轉、加速下落、暫停)

核心類代碼要點

1. 方塊狀態定義 (statefang.java)

public class statefang {
    public static final int[][][] STATE = new int[][][] {
        // I 型 4 旋轉
        {{0,0,1,0},{0,0,1,0},{0,0,1,0},{0,0,1,0}},
        {{0,0,0,0},{0,0,0,0},{0,0,0,0},{1,1,1,1}},
        // ... 共 28 個 4x4 矩陣 (7種×4旋轉)
    };
}

2. 資源加載與雙緩衝 (GameResources)

public class GameResources {
    private Bitmap bufferBitmap; // 雙緩衝位圖
    private Canvas bufferCanvas;
    private Bitmap[] blockBitmaps = new Bitmap[7]; // 7 種方塊小圖
    private Bitmap bgBitmap, startBitmap, scoreBitmap, levelBitmap;

    public GameResources(Context ctx) {
        Resources res = ctx.getResources();
        // 加載方塊圖 (18x18)
        for (int i = 0; i < 7; i++) {
            blockBitmaps[i] = createBitmap(res.getDrawable(R.drawable.cube_01 + i), 18, 18);
        }
        bgBitmap = createBitmap(res.getDrawable(R.drawable.bg), 320, 480);
        startBitmap = createBitmap(res.getDrawable(R.drawable.start_bg), 320, 480);
        scoreBitmap = createBitmap(res.getDrawable(R.drawable.score), 87, 150);
        levelBitmap = createBitmap(res.getDrawable(R.drawable.levelup), 139, 88);
        
        bufferBitmap = Bitmap.createBitmap(320, 480, Bitmap.Config.ARGB_8888);
        bufferCanvas = new Canvas(bufferBitmap);
        drawBackground(); // 預繪背景到緩衝
    }

    private Bitmap createBitmap(Drawable d, int w, int h) {
        Bitmap b = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
        new Canvas(b).drawBitmap(((BitmapDrawable)d).getBitmap(), null, new Rect(0,0,w,h), null);
        return b;
    }
}

3. 音效管理 (MusicPlay)

public class MusicPlay {
    private static MediaPlayer bgMusic, menuMusic;
    private static SoundPool soundPool;
    private static Map soundMap = new HashMap<>();
    private static boolean musicOn = true, soundOn = true;

    public static void init(Context ctx) {
        bgMusic = MediaPlayer.create(ctx, R.raw.bg_music);
        bgMusic.setLooping(true);
        menuMusic = MediaPlayer.create(ctx, R.raw.menu_music);
        menuMusic.setLooping(true);

        soundPool = new SoundPool.Builder().setMaxStreams(5).build();
        soundMap.put(R.raw.move, soundPool.load(ctx, R.raw.move, 1));
        soundMap.put(R.raw.rotate, soundPool.load(ctx, R.raw.rotate, 1));
        soundMap.put(R.raw.clear, soundPool.load(ctx, R.raw.clear, 1));
        soundMap.put(R.raw.drop, soundPool.load(ctx, R.raw.drop, 1));
    }

    public static void playSound(int resId) {
        if (soundOn) soundPool.play(soundMap.get(resId), 1, 1, 1, 0, 1f);
    }
    // playBg, pauseBg, playMenu 等...
}

4. 遊戲主邏輯 (GameView extends SurfaceView implements Runnable)

public class GameView extends SurfaceView implements Runnable, View.OnTouchListener {
    private Thread gameThread;
    private volatile boolean running = false;
    private SurfaceHolder holder;
    private GameResources res;
    private int[][] grid = new int[20][10]; // 遊戲網格
    private Piece currentPiece, nextPiece;
    private long lastFallTime = 0;
    private int fallInterval = 800; // ms
    private int score = 0, level = 1, lines = 0;

    public GameView(Context ctx) {
        super(ctx);
        holder = getHolder();
        holder.addCallback(new SurfaceHolder.Callback() {
            public void surfaceCreated(SurfaceHolder h) { startGame(); }
            public void surfaceDestroyed(SurfaceHolder h) { stopGame(); }
            public void surfaceChanged(SurfaceHolder h, int f, int w, int h) {}
        });
        setOnTouchListener(this);
        res = new GameResources(ctx);
        MusicPlay.init(ctx);
        spawnPiece();
    }

    private void startGame() {
        running = true;
        gameThread = new Thread(this);
        gameThread.start();
    }

    private void stopGame() {
        running = false;
        while (true) {
            try { gameThread.join(); break; } catch (InterruptedException ignored) {}
        }
    }

    @Override
    public void run() {
        while (running) {
            long now = System.currentTimeMillis();
            if (!holder.getSurface().isValid()) continue;
            
            // 更新邏輯 (固定時間步)
            if (now - lastFallTime > fallInterval) {
                if (!moveDown()) lockPiece();
                lastFallTime = now;
            }
            
            // 繪製
            draw();
        }
    }

    private boolean moveDown() { /* 碰撞檢測、移動 currentPiece.y++ */ }
    private void lockPiece() { /* 寫入 grid、檢測消行、生成新塊、判斷 Game Over */ }
    private void clearLines() { /* 消行動畫、加分、升級、加速 fallInterval */ }
    private void spawnPiece() { currentPiece = nextPiece; nextPiece = randomPiece(); }

    private void draw() {
        Canvas c = holder.lockCanvas();
        if (c != null) {
            // 雙緩衝:先畫到 bufferBitmap
            res.bufferCanvas.drawBitmap(res.bgBitmap, 0, 0, null);
            drawGrid(res.bufferCanvas);
            drawCurrentPiece(res.bufferCanvas);
            drawNextPiece(res.bufferCanvas);
            drawScore(res.bufferCanvas);
            // 一次性提交到螢幕
            c.drawBitmap(res.bufferBitmap, 0, 0, null);
            holder.unlockCanvasAndPost(c);
        }
    }

    // 觸摸區域判斷 (左/右/旋轉/下落/暫停)
    @Override public boolean onTouch(View v, MotionEvent e) {
        if (e.getAction() != MotionEvent.ACTION_DOWN) return true;
        float x = e.getX(), y = e.getY();
        if (x < width/3) moveLeft();
        else if (x > 2*width/3) moveRight();
        else if (y < height/2) rotate();
        else softDrop();
        return true;
    }
}

關鍵算法細節

  • 碰撞檢測:遍歷方塊 4x4 矩陣中非零格子,映射到網格坐標,檢查邊界、已佔用格
  • 旋轉:切換 stateIndex = (stateIndex + 1) % 4,若碰撞嘗試牆踢
  • 消行:從底部向上掃描滿行,移除並下移上方所有行,分數 100 * 2^(lines-1)
  • 等級加速:每 10 行升級,fallInterval = max(100, 800 - level*50)
  • 雙緩衝:離屏 Canvas 繪製完整幀,一次 drawBitmap 提交,消除閃爍

現代化重構建議

  • 使用 GameLoop 模式 (固定時間步 + 插值渲染) 替代簡單睡眠
  • 改用 Canvas + Paint 程序化繪製方塊,無需 Bitmap 資源,包體積更小
  • 邏輯與渲染分離:GameEngine (純 Kotlin, 可單測) + GameRenderer (Android 相關)
  • 輸入改用 GameController 抽象,支持鍵盤/手柄/觸控統一映射
  • 狀態持久化:DataStore 保存最高分、設置
  • 音效遷移至 MediaPlayer + SoundPool 封裝的 AudioManager

總結

這是一個經典的「單 SurfaceView 線程 + 雙緩衝 + 狀態機」遊戲架構。雖代碼風格較舊 (Java、手動線程、資源硬編碼),但完整展示了遊戲核心循環:輸入 → 更新狀態 → 碰撞檢測 → 消行計分 → 雙緩衝繪製 → 音效反饋。理解此架構有助於掌握 Android 遊戲開發基礎,現代開發可引入 KorLibs/LibGDX/Unity 等引擎提效,但核心邏輯原理不變。

copyright © 萬盛學電腦網 all rights reserved