Win32 API读取键盘状态时O键重复触发切换问题排查

我正在用DirectX11开发一款简易3D游戏引擎，目前用Win32 API的GetKeyboardState读取用户输入（后续计划切换到DirectInput）。移动类按键通过检测0x80位判断按住状态能正常工作，但按O键切换渲染器时，会持续触发切换操作，没法实现“按一次切一次”的预期效果。

我的相关代码 #

首先是调用GetKeyboardState的处理函数：

void Game::ProcessInput() { 
    unsigned char keys[256]; 
    GetKeyboardState(keys); 
    Input::GetInstance()->ProcessKeyboardInput(keys, mCamera, *mEntity, *mRenderer); 
}

然后是Input类中处理输入的核心逻辑：

void Input::ProcessKeyboardInput(unsigned char *keys, Camera &camera, Entity &player, Renderer &renderer) { 
    static bool pressed = false; 

    /* update camera position - translate camera */ 
    if (keys['A'] & 0x80) camera.MoveRight(-speed); 
    if (keys['D'] & 0x80) camera.MoveRight(speed); 
    if (keys['W'] & 0x80) camera.MoveForward(speed); 
    if (keys['S'] & 0x80) camera.MoveForward(-speed); 
    if (keys['Q'] & 0x80) camera.MoveUp(speed); 
    if (keys['E'] & 0x80) camera.MoveUp(-speed); 
    if (keys['P'] & 0x80) speed == SLOW ? speed = FAST : speed = SLOW; 

    /* move player */ 
    if (keys[VK_LEFT] & 0x80) player.Rotate(-playerSpeed * 10.0); 
    if (keys[VK_RIGHT] & 0x80) player.Rotate(playerSpeed * 10.0); 
    if (keys[VK_UP] & 0x80) player.MoveForward(playerSpeed); 
    if (keys[VK_DOWN] & 0x80) player.MoveForward(-playerSpeed); 
    if (keys[VK_SPACE] & 0x80) player.Jump(); 

    /* control rendering */ 
    if (keys['O'] & 0x80 && !pressed) { 
        renderer.TogglePostProcessing(); 
        pressed = true; 
    } else pressed = false; 
}

问题根源 #

问题出在O键切换的逻辑里，静态变量pressed的重置时机完全错了：

• 当你按住O键时，第一帧满足keys['O'] & 0x80 && !pressed，触发切换并把pressed设为true；
• 第二帧时，O键还按住，条件不满足（因为pressed是true），于是走else分支直接把pressed设为false；
• 第三帧时，pressed又变回false，再次满足条件触发切换……
• 就这样循环往复，只要按住O键，每两帧就会切换一次，看起来就像持续触发。

修复方案 #

这里提供两种可靠的修复思路，都是基于只在按键按下的瞬间触发一次的“边缘检测”逻辑：

方案一：跟踪上一帧按键状态（推荐）

用静态变量记录上一帧O键的状态，只在“从释放变为按下”的瞬间触发切换：

void Input::ProcessKeyboardInput(unsigned char *keys, Camera &camera, Entity &player, Renderer &renderer) { 
    static bool oKeyWasPressedLastFrame = false; // 保存上一帧O键状态

    // ... 其他输入处理代码保持不变 ...

    /* control rendering */ 
    bool oKeyIsPressedNow = (keys['O'] & 0x80) != 0;
    // 只有当这一帧刚按下O键（上一帧没按，这一帧按了）时才触发
    if (oKeyIsPressedNow && !oKeyWasPressedLastFrame) {
        renderer.TogglePostProcessing();
    }
    // 更新上一帧状态，供下一帧判断
    oKeyWasPressedLastFrame = oKeyIsPressedNow;
}

方案二：修正原变量的重置逻辑

只在O键释放时才重置pressed，按住时保持pressed为true，避免反复触发：

void Input::ProcessKeyboardInput(unsigned char *keys, Camera &camera, Entity &player, Renderer &renderer) { 
    static bool pressed = false; 

    // ... 其他输入处理代码保持不变 ...

    /* control rendering */ 
    bool oKeyDown = (keys['O'] & 0x80) != 0;
    if (oKeyDown) {
        if (!pressed) {
            renderer.TogglePostProcessing();
            pressed = true;
        }
    } else {
        // 只有当O键松开时，才把pressed重置为false
        pressed = false;
    }
}

额外说明 #

这两种方案都能完美解决当前问题，后续切换到DirectInput时，它本身提供了更直接的按键按下/释放事件检测，处理这类单次触发操作会更顺手，但现在用Win32 API的话，上面的方法完全够用。

内容的提问来源于stack exchange，提问作者Luca