游戏客户端架构 / 系统课时
定义逻辑操作
定义逻辑操作
本课把键盘上的具体按键转换为“移动、跳跃、交互”等逻辑操作,让游戏规则不再直接依赖设备输入,并完成一个可运行的按键映射与状态查询示例。
学习目标
- 理解物理按键与逻辑操作分离的价值
- 实现按键绑定、按下、释放和操作状态查询
- 识别持续按住与单次触发的边界
从按键判断转向操作判断
直接在角色代码中判断 W、Space 或 E,会把玩法逻辑绑定到键盘。更稳妥的做法是先定义逻辑操作,再由输入层维护“按键到操作”的映射。角色只询问 MoveRight 或 Jump 是否生效,因此以后替换手柄、允许玩家改键时,不必修改角色代码。

逻辑操作通常使用枚举或稳定字符串表示。枚举便于编译期检查,适合操作集合较固定的引擎;字符串或资源 ID 更适合由配置文件动态扩展的项目。
实现最小输入映射器
下面的 C++17 示例维护三类数据:按键绑定表、当前按下的按键集合,以及面向玩法层的操作查询接口。示例允许多个按键映射为不同操作,玩法代码完全不知道具体键值。
#include <iostream>
#include <string>
#include <unordered_map>
#include <unordered_set>
enum class Key {
A,
D,
Space,
E
};
enum class Action {
MoveLeft,
MoveRight,
Jump,
Interact
};
struct EnumHash {
template <typename T>
std::size_t operator()(T value) const {
return static_cast<std::size_t>(value);
}
};
class InputMapper {
public:
void bind(Key key, Action action) {
bindings_[key] = action;
}
void press(Key key) {
pressedKeys_.insert(key);
}
void release(Key key) {
pressedKeys_.erase(key);
}
bool isActionDown(Action action) const {
for (const auto& [key, boundAction] : bindings_) {
if (boundAction == action && pressedKeys_.find(key) != pressedKeys_.end()) {
return true;
}
}
return false;
}
private:
std::unordered_map<Key, Action, EnumHash> bindings_;
std::unordered_set<Key, EnumHash> pressedKeys_;
};
std::string boolText(bool value) {
return value ? "true" : "false";
}
int main() {
InputMapper input;
input.bind(Key::A, Action::MoveLeft);
input.bind(Key::D, Action::MoveRight);
input.bind(Key::Space, Action::Jump);
input.bind(Key::E, Action::Interact);
input.press(Key::D);
input.press(Key::Space);
std::cout << "MoveLeft: " << boolText(input.isActionDown(Action::MoveLeft)) << '\n';
std::cout << "MoveRight: " << boolText(input.isActionDown(Action::MoveRight)) << '\n';
std::cout << "Jump: " << boolText(input.isActionDown(Action::Jump)) << '\n';
std::cout << "Interact: " << boolText(input.isActionDown(Action::Interact)) << '\n';
input.release(Key::Space);
std::cout << "After release Jump: "
<< boolText(input.isActionDown(Action::Jump)) << '\n';
}使用支持 C++17 的编译器执行:
g++ -std=c++17 main.cpp -o input_demo
./input_demo预期输出:
MoveLeft: false
MoveRight: true
Jump: true
Interact: false
After release Jump: false实际可执行文件名和路径可能因平台不同而变化,但操作状态应与输出一致。
处理持续状态与单次触发
isActionDown 表示操作当前是否持续生效,适合移动、瞄准和蓄力。跳跃、确认或打开菜单通常还需要“本帧刚按下”的查询,例如 wasActionPressed。实现时应保存上一帧状态,并用“当前为按下且上一帧未按下”判断边沿触发。
同一个逻辑操作可以绑定多个物理输入,例如 Space 和手柄 A 键都触发 Jump。查询操作状态时,只要任一绑定处于按下状态,就应返回 true。反向地,一个按键是否允许触发多个操作,要由项目规则决定,避免菜单与角色控制同时响应。
设计边界与验收
输入映射层只负责解释输入,不应直接移动角色或播放动画。角色控制器读取逻辑操作后再决定速度、状态机和动画参数,这样输入回放、AI 控制和网络同步都可以复用同一套玩法接口。
验收时至少检查三点:改绑后角色代码无需修改;释放按键后持续状态立即结束;多个设备绑定同一操作时任一输入都能生效。若后续加入配置文件,还要验证无效操作名和重复绑定的处理策略。
本课总结
- 逻辑操作把设备按键与玩法规则隔离,便于改键和扩展输入设备
- 输入映射器负责绑定与状态查询,不直接执行角色行为
- 持续按住和本帧触发是两种不同语义,应分别提供查询接口
下一课预告
下一课将构建事件分发器,让输入、角色、界面和音效模块通过发布订阅机制传递消息,而不形成直接依赖。