游戏客户端架构 / 系统课时

采集键盘输入

采集键盘输入

本课会建立一套按帧更新的键盘输入模块,把原始按键事件转换为按下、持续按住和释放三种查询状态。完成后,游戏逻辑可以准确区分一次性触发与连续控制。

学习目标

  • 区分按下、按住和释放三种输入语义
  • 使用事件回调在一帧内累计状态变化
  • 在更新阶段通过统一接口读取键盘状态

三种状态为什么要分开

“按下”只在按键从未按住变为按住的那一帧成立,适合跳跃、确认和打开菜单;“持续按住”在键保持按下期间每帧成立,适合移动和蓄力;“释放”只在松开的那一帧成立,适合结束拖拽或提交蓄力结果。

如果只读取当前是否按住,就无法可靠实现一次性触发。事件系统还可能在同一帧内收到按下和释放,因此输入模块应分别记录边沿事件,而不是只比较最终布尔值。

按键输入在帧内形成三种状态

实现按帧输入模块

下面示例使用 GLFW 的键盘回调。每帧先清空一次性状态,再轮询系统事件,随后游戏更新即可查询三个接口。GLFW_REPEAT 不会重复触发“按下”,因此长按不会让一次性操作连续执行。

cpp
#include <GLFW/glfw3.h>
#include <array>
#include <iostream>

class Keyboard {
public:
    void beginFrame() {
        pressed_.fill(false);
        released_.fill(false);
    }

    void onKey(int key, int action) {
        if (!isValid(key)) {
            return;
        }

        if (action == GLFW_PRESS) {
            // 只在物理按键首次按下时记录边沿。
            if (!held_[key]) {
                pressed_[key] = true;
            }
            held_[key] = true;
        } else if (action == GLFW_RELEASE) {
            held_[key] = false;
            released_[key] = true;
        }
    }

    bool pressed(int key) const {
        return isValid(key) && pressed_[key];
    }

    bool held(int key) const {
        return isValid(key) && held_[key];
    }

    bool released(int key) const {
        return isValid(key) && released_[key];
    }

private:
    static bool isValid(int key) {
        return key >= 0 && key <= GLFW_KEY_LAST;
    }

    std::array<bool, GLFW_KEY_LAST + 1> pressed_{};
    std::array<bool, GLFW_KEY_LAST + 1> held_{};
    std::array<bool, GLFW_KEY_LAST + 1> released_{};
};

Keyboard* gKeyboard = nullptr;

void keyCallback(GLFWwindow*, int key, int, int action, int) {
    if (gKeyboard != nullptr) {
        gKeyboard->onKey(key, action);
    }
}

int main() {
    if (glfwInit() != GLFW_TRUE) {
        std::cerr << "GLFW initialization failed\n";
        return 1;
    }

    GLFWwindow* window =
        glfwCreateWindow(800, 450, "Keyboard Input", nullptr, nullptr);
    if (window == nullptr) {
        glfwTerminate();
        return 1;
    }

    glfwMakeContextCurrent(window);
    glfwSwapInterval(1);

    Keyboard keyboard;
    gKeyboard = &keyboard;
    glfwSetKeyCallback(window, keyCallback);

    int heldFrameCounter = 0;
    while (glfwWindowShouldClose(window) == GLFW_FALSE) {
        // 顺序必须是:清空边沿状态、采集事件、读取状态。
        keyboard.beginFrame();
        glfwPollEvents();

        if (keyboard.pressed(GLFW_KEY_SPACE)) {
            std::cout << "Space pressed\n";
        }
        if (keyboard.held(GLFW_KEY_SPACE) && ++heldFrameCounter % 30 == 0) {
            std::cout << "Space held\n";
        }
        if (keyboard.released(GLFW_KEY_SPACE)) {
            std::cout << "Space released\n";
            heldFrameCounter = 0;
        }
        if (keyboard.pressed(GLFW_KEY_ESCAPE)) {
            glfwSetWindowShouldClose(window, GLFW_TRUE);
        }

        glfwSwapBuffers(window);
    }

    gKeyboard = nullptr;
    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

预期结果是出现一个 800×450 的窗口。按下、持续按住并释放空格键时,控制台会按实际持续时间输出类似内容;按 Esc 后窗口关闭。

text
Space pressed
Space held
Space held
Space released

帧内调用顺序

beginFrame 必须位于事件轮询之前,否则刚采集到的 pressed 和 released 会被立即清空。状态读取应放在 glfwPollEvents 之后,确保本帧操作使用的是最新事件。

事件回调只负责记录输入,不应直接执行跳跃或移动逻辑。这样可以保持输入层与游戏逻辑解耦,也能在未来接入手柄、录制回放或自动化测试。

窗口失去焦点时,操作系统不一定为所有已按键发送释放事件。正式引擎应监听焦点丢失事件,并清空 held_,避免角色在切回窗口后仍持续移动。

验收输入行为

快速点按空格时,应在同一轮或相邻轮更新中分别观察到按下与释放;长按时,pressed 只出现一次,held 可连续成立,released 只在松开时出现一次。

再把查询键改为方向键,确认多个键可以同时保持。数组按键码存储状态,因此不会像单个“当前按键”变量那样覆盖组合输入。

本课总结

  • 按下与释放是单帧边沿,按住是跨帧持续状态
  • 每帧应先清空边沿标记,再采集事件,最后由游戏逻辑读取
  • 输入回调只记录状态,不直接执行业务动作

下一课预告

下一课将处理鼠标位置、按钮和滚轮输入,并统一键盘与鼠标的帧更新接口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

采集键盘输入

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通