J2ME 低階 UI 事件處理三種模式深度比較：keyPressed、gameAction、keyStates

前言：按鍵處理是遊戲開發的核心

J2ME 低階 UI（Canvas/GameCanvas）中，鍵盤事件處理直接決定遊戲手感。本文以手機鍵盤為核心，系統比較三種處理模式的機制、適用場景與優劣。

鍵盤佈局與鍵值基礎知識

• 功能鍵區：左右軟鍵、導航鍵（上下左右確認）、通話/掛斷鍵。鍵值跨裝置差異極大。
• 數字鍵區：0-9、*、#。鍵值標準化，Canvas.KEY_NUM0 ~ KEY_NUM9、KEY_STAR、KEY_POUND 跨裝置一致。

模式一：覆寫 keyPressed(int keyCode) —— MIDP 1.0 基礎模式

機制

Canvas 子類別覆寫 keyPressed(int keyCode)，系統事件執行緒於按鍵按下時回呼，傳入鍵值。

鍵值判斷兩種寫法

// 寫法 A：硬編碼數值（不可讀、不可維護）
if (keyCode == 52) { ... }

// 寫法 B：使用 Canvas 常數（推薦）
if (keyCode == Canvas.KEY_NUM4) { ... }

進階：gameAction 映射機制

將物理鍵映射為邏輯遊戲動作，由裝置製造商實作映射表：

int action = getGameAction(keyCode);
switch (action) {
    case Canvas.LEFT:  // 數字鍵 4 + 向左導航鍵
    case Canvas.RIGHT: // 數字鍵 6 + 向右導航鍵
    case Canvas.UP:    // 數字鍵 2 + 向上導航鍵
    case Canvas.DOWN:  // 數字鍵 8 + 向下導航鍵
    case Canvas.FIRE:  // 數字鍵 5 + 確認鍵
    case Canvas.GAME_A: case Canvas.GAME_B: case Canvas.GAME_C: case Canvas.GAME_D:
        // 對應 1/3/7/9 或 7/9/*/#，視裝置而定
}

優點：跨裝置相容性佳、邏輯清晰。缺點：仍綁定於 keyPressed 回呼，三大遊戲邏輯（延遲、輸入響應、重繪）混雜於系統事件執行緒，難以精確控制幀率。

模式二：keyStates 位元狀態輪詢 —— MIDP 2.0 GameCanvas 專屬

啟用條件

public class MyGameCanvas extends GameCanvas {
    public MyGameCanvas() {
        super(true); // true = 啟用按鍵狀態追蹤
    }
}

注意：啟用後，遊戲相關按鍵不再觸發 keyPressed，其他鍵（如軟鍵）仍正常回呼。

// 於遊戲主迴圈（獨立執行緒）呼叫
int states = getKeyStates(); // 取得並清除當前狀態位元遮罩

// 位元運算判斷
if ((states & GameCanvas.LEFT_PRESSED) != 0) { /* 向左 */ }
if ((states & GameCanvas.RIGHT_PRESSED) != 0) { /* 向右 */ }
if ((states & GameCanvas.UP_PRESSED) != 0) { /* 向上 */ }
if ((states & GameCanvas.DOWN_PRESSED) != 0) { /* 向下 */ }
if ((states & GameCanvas.FIRE_PRESSED) != 0) { /* 確認/開火 */ }