游戏客户端架构 / 系统课时
采集键盘输入
采集键盘输入
本课会建立一套按帧更新的键盘输入模块,把原始按键事件转换为按下、持续按住和释放三种查询状态。完成后,游戏逻辑可以准确区分一次性触发与连续控制。
学习目标
- 区分按下、按住和释放三种输入语义
- 使用事件回调在一帧内累计状态变化
- 在更新阶段通过统一接口读取键盘状态
三种状态为什么要分开
“按下”只在按键从未按住变为按住的那一帧成立,适合跳跃、确认和打开菜单;“持续按住”在键保持按下期间每帧成立,适合移动和蓄力;“释放”只在松开的那一帧成立,适合结束拖拽或提交蓄力结果。
如果只读取当前是否按住,就无法可靠实现一次性触发。事件系统还可能在同一帧内收到按下和释放,因此输入模块应分别记录边沿事件,而不是只比较最终布尔值。

实现按帧输入模块
下面示例使用 GLFW 的键盘回调。每帧先清空一次性状态,再轮询系统事件,随后游戏更新即可查询三个接口。GLFW_REPEAT 不会重复触发“按下”,因此长按不会让一次性操作连续执行。
#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 后窗口关闭。
Space pressed
Space held
Space held
Space released帧内调用顺序
beginFrame 必须位于事件轮询之前,否则刚采集到的 pressed 和 released 会被立即清空。状态读取应放在 glfwPollEvents 之后,确保本帧操作使用的是最新事件。
事件回调只负责记录输入,不应直接执行跳跃或移动逻辑。这样可以保持输入层与游戏逻辑解耦,也能在未来接入手柄、录制回放或自动化测试。
窗口失去焦点时,操作系统不一定为所有已按键发送释放事件。正式引擎应监听焦点丢失事件,并清空 held_,避免角色在切回窗口后仍持续移动。
验收输入行为
快速点按空格时,应在同一轮或相邻轮更新中分别观察到按下与释放;长按时,pressed 只出现一次,held 可连续成立,released 只在松开时出现一次。
再把查询键改为方向键,确认多个键可以同时保持。数组按键码存储状态,因此不会像单个“当前按键”变量那样覆盖组合输入。
本课总结
- 按下与释放是单帧边沿,按住是跨帧持续状态
- 每帧应先清空边沿标记,再采集事件,最后由游戏逻辑读取
- 输入回调只记录状态,不直接执行业务动作
下一课预告
下一课将处理鼠标位置、按钮和滚轮输入,并统一键盘与鼠标的帧更新接口。