C# 遊戲手柄程式開發 - API 篇 (3)：鍵盤模擬實作

C# 遊戲手柄開發系列 (3)：使用 keybd_event 實現鍵盤模擬

前兩篇完成手柄訊號擷取，本篇實作將手柄按鍵轉換為鍵盤事件，達成以手柄玩鍵盤遊戲的目標。核心 API 為 user32.dll 的 keybd_event。

一、keybd_event API 宣告

/// 
 模擬鍵盤事件 
/// 虛擬鍵碼
/// 掃描碼
/// 旗標
/// 額外資訊
[DllImport("user32.dll")]
public static extern void keybd_event(byte bVk, byte bScan, uint dwFlags, uint dwExtraInfo);

參數說明

• bVk：對應 System.Windows.Forms.Keys 列舉值。
• dwFlags 組合值：

  常數	說明
  KEYEVENTF_KEYDOWN	KeyDown 事件 (按下)
  KEYEVENTF_EXTENDEDKEY	擴展鍵碼
  KEYEVENTF_KEYUP	KeyUp 事件 (釋放)

二、封裝鍵盤事件列舉與發送方法

/// 
 鍵盤事件旗標列舉 
[Flags]
public enum KeyboardEvents
{
    None = 0x0,
    KeyDown = 0x1,
    KeyUp = 0x2
}

/// 
 發送鍵盤事件 
/// 虛擬鍵碼
/// 事件組合
public static void SendKeyEvent(Keys key, KeyboardEvents events)
{
    const uint KEYEVENTF_KEYDOWN = 0x0000;
    const uint KEYEVENTF_KEYUP = 0x0002;

    if ((events & KeyboardEvents.KeyDown) == KeyboardEvents.KeyDown)
        keybd_event((byte)key, 0, KEYEVENTF_KEYDOWN, 0);

    if ((events & KeyboardEvents.KeyUp) == KeyboardEvents.KeyUp)
        keybd_event((byte)key, 0, KEYEVENTF_KEYUP, 0);
}

三、使用範例

• 模擬按下 A 鍵：SendKeyEvent(Keys.A, KeyboardEvents.KeyDown)
• 模擬按下並釋放 A 鍵：SendKeyEvent(Keys.A, KeyboardEvents.KeyDown | KeyboardEvents.KeyUp)

四、整合手柄事件

配合第 2 篇的手柄 KeyDown、KeyUp 事件處理，即可完成「手柄按鍵 → 鍵盤模擬」完整鏈路。

五、成品介面展示

操作說明

1. 將游標移至對應手柄按鈕下方，直接按下鍵盤按鍵設定映射。
2. 點擊「啟動 1/2 號手柄模擬」按鈕。
3. 最小化程式，將滑鼠焦點移至目標遊戲視窗。
4. 即可使用手柄操作原本僅支援鍵盤的遊戲。

六、參考專案

完整原始碼請下載本文附件。類似成品工具網路上已有現成軟體（如日本開發的 JoyToKey）。