游戏客户端架构 / 系统课时
采集鼠标输入
采集鼠标输入
鼠标输入不只是“有没有点击”,还要在同一帧内同时保存绝对位置、移动增量、按键状态和滚轮变化。本课将实现一个平台无关的采集器,并明确每帧重置与事件累积的正确顺序。
学习目标
- 区分鼠标位置、移动量、按键和滚轮四类状态
- 实现可在每帧更新的鼠标输入采集器
- 识别移动量与滚轮状态最常见的重置错误
建立鼠标状态模型
鼠标位置是窗口客户区中的绝对坐标,通常以左上角为原点;移动量表示本帧所有移动事件的累计变化。按键状态属于持续状态,而滚轮属于瞬时变化,只在发生滚动的那一帧有效。

这四类数据的生命周期不同:位置和按键要跨帧保留,移动量和滚轮量要在新帧开始时清零。把它们混在一起统一重置,会导致按住鼠标后下一帧立刻变成“未按下”。
实现帧内采集器
下面的示例使用标准 C++17 定义事件结构,并模拟窗口层向采集器投递鼠标事件。真实项目只需把窗口库产生的事件转换为 MouseEvent,采集器本身不依赖具体平台。
cpp
#include <array>
#include <cstddef>
#include <iostream>
#include <vector>
enum class MouseButton {
Left = 0,
Right,
Middle,
X1,
X2
};
struct MouseEvent {
enum class Type {
Move,
ButtonDown,
ButtonUp,
Wheel
};
Type type;
int x = 0;
int y = 0;
int dx = 0;
int dy = 0;
MouseButton button = MouseButton::Left;
float wheelX = 0.0f;
float wheelY = 0.0f;
};
struct MouseState {
int x = 0;
int y = 0;
int deltaX = 0;
int deltaY = 0;
std::array<bool, 5> buttons{};
float wheelX = 0.0f;
float wheelY = 0.0f;
};
class MouseInput {
public:
void beginFrame() {
// 瞬时量只描述当前帧,因此必须在采集新事件前清零。
state_.deltaX = 0;
state_.deltaY = 0;
state_.wheelX = 0.0f;
state_.wheelY = 0.0f;
}
void handleEvent(const MouseEvent& event) {
switch (event.type) {
case MouseEvent::Type::Move:
state_.x = event.x;
state_.y = event.y;
// 一帧可能收到多次移动事件,必须累加而不是覆盖。
state_.deltaX += event.dx;
state_.deltaY += event.dy;
break;
case MouseEvent::Type::ButtonDown:
state_.buttons[indexOf(event.button)] = true;
break;
case MouseEvent::Type::ButtonUp:
state_.buttons[indexOf(event.button)] = false;
break;
case MouseEvent::Type::Wheel:
state_.wheelX += event.wheelX;
state_.wheelY += event.wheelY;
break;
}
}
const MouseState& state() const {
return state_;
}
private:
static std::size_t indexOf(MouseButton button) {
return static_cast<std::size_t>(button);
}
MouseState state_;
};
int main() {
MouseInput mouse;
mouse.beginFrame();
const std::vector<MouseEvent> events = {
{MouseEvent::Type::Move, 420, 260, 20, 10},
{MouseEvent::Type::ButtonDown, 0, 0, 0, 0, MouseButton::Left},
{MouseEvent::Type::Wheel, 0, 0, 0, 0, MouseButton::Left, 0.0f, 1.0f}
};
for (const MouseEvent& event : events) {
mouse.handleEvent(event);
}
const MouseState& state = mouse.state();
std::cout << "position=(" << state.x << "," << state.y << ")\n";
std::cout << "delta=(" << state.deltaX << "," << state.deltaY << ")\n";
std::cout << "left=" << (state.buttons[0] ? "down" : "up") << "\n";
std::cout << "wheel=(" << state.wheelX << "," << state.wheelY << ")\n";
}预期输出:
text
position=(420,260)
delta=(20,10)
left=down
wheel=(0,1)示例中的坐标来自模拟事件;接入真实窗口后,数值会随窗口大小、指针位置和操作速度变化。
按正确顺序更新每一帧
主循环应先调用 beginFrame(),再轮询窗口事件,最后让游戏逻辑读取状态。这样游戏逻辑看到的是“本帧已经收集完毕”的统一快照,而不是采集到一半的数据。
移动量和滚轮量必须累加,因为操作系统可能在一帧内发送多条事件。按键状态则直接记录最终结果,使持续按住左键时后续帧仍然保持 down。
检查边界与常见错误
窗口失去焦点时,平台可能无法继续收到释放事件。引擎通常应在失焦事件发生时清空全部按键状态,避免鼠标键永久卡在按下状态。
高 DPI 或多显示器环境下,窗口库可能同时提供逻辑坐标与像素坐标。采集器必须只选择一种坐标体系,并让渲染、UI 命中测试和鼠标输入保持一致。
本课总结
- 位置和按键是跨帧持续状态,移动量和滚轮是单帧瞬时状态
- 帧开始时只清零瞬时量,随后累加本帧收到的全部移动与滚轮事件
- 窗口失焦和坐标体系不一致是鼠标输入最常见的边界问题
下一课预告
下一课将保存当前帧与上一帧的输入快照,用它们判断“刚刚按下”“持续按住”和“刚刚释放”等边沿变化。
按自己的节奏,确认真正理解。