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

采集鼠标输入

采集鼠标输入

鼠标输入不只是“有没有点击”,还要在同一帧内同时保存绝对位置、移动增量、按键状态和滚轮变化。本课将实现一个平台无关的采集器,并明确每帧重置与事件累积的正确顺序。

学习目标

  • 区分鼠标位置、移动量、按键和滚轮四类状态
  • 实现可在每帧更新的鼠标输入采集器
  • 识别移动量与滚轮状态最常见的重置错误

建立鼠标状态模型

鼠标位置是窗口客户区中的绝对坐标,通常以左上角为原点;移动量表示本帧所有移动事件的累计变化。按键状态属于持续状态,而滚轮属于瞬时变化,只在发生滚动的那一帧有效。

鼠标事件采集链路

这四类数据的生命周期不同:位置和按键要跨帧保留,移动量和滚轮量要在新帧开始时清零。把它们混在一起统一重置,会导致按住鼠标后下一帧立刻变成“未按下”。

实现帧内采集器

下面的示例使用标准 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 命中测试和鼠标输入保持一致。

本课总结

  • 位置和按键是跨帧持续状态,移动量和滚轮是单帧瞬时状态
  • 帧开始时只清零瞬时量,随后累加本帧收到的全部移动与滚轮事件
  • 窗口失焦和坐标体系不一致是鼠标输入最常见的边界问题

下一课预告

下一课将保存当前帧与上一帧的输入快照,用它们判断“刚刚按下”“持续按住”和“刚刚释放”等边沿变化。

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

目录与阅读设置

阅读设置

17

记录一个想法

采集鼠标输入

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

登录哪都通