游戏客户端架构 / 系统课时
输入事件和业务事件怎么分层
输入事件和业务事件怎么分层
在游戏客户端中,键盘空格键和手柄按钮可能都表示跳跃,但角色状态、音效和界面不应该依赖具体按键。本课将设备输入、玩家意图和业务结果分成三个层次,通过可运行的 C# 示例建立单向通信链路,让输入设备可以替换,业务规则也能独立测试。
学习目标
- 区分设备输入、玩家意图和业务结果事件的职责。
- 实现不同设备输入映射到同一业务操作的通信链路。
- 判断事件应该在业务执行前还是执行后发布。
三层消息分别表达什么
游戏输入系统最容易出现的问题,是把设备行为直接当作业务事实。例如,角色按下跳跃键后,输入系统立即发布 PlayerJumped,音效系统开始播放跳跃声音,但角色实际上可能因为体力不足而无法跳跃。
问题不在事件派发机制,而在于消息没有区分请求与结果。合理的设计需要三个层次。
| 层次 | 消息示例 | 核心职责 |
|---|---|---|
| 设备输入 | KeyboardSpaceDown |
描述硬件或输入设备发生了什么 |
| 玩家意图 | JumpIntent |
描述玩家希望角色执行什么操作 |
| 业务结果 | Jumped |
描述业务规则确认发生了什么 |
设备输入只负责采集,不应该知道角色体力、背包状态或战斗规则。玩家意图是等待业务处理的请求,不代表操作已经成功。业务结果则应当在状态变更完成之后产生,供 HUD、音效和其他模块订阅。
用单向链路隔开输入与状态
输入适配器负责把不同设备信号转换为统一意图。例如,键盘 Space 和手柄南侧按钮都映射为 Jump,后续业务系统不需要关心输入来源。
业务系统收到意图后先执行规则检查。体力充足时扣除体力并发布 Jumped;体力不足时拒绝操作,不发布成功事件。监听者只根据确定的结果更新界面或播放音效。

这条链路还有一个重要约束:状态的写入者应当是业务系统,而不是输入适配器或 HUD 订阅者。否则多个监听者可能重复修改同一状态,导致执行顺序难以追踪。
当玩家切换设备、修改按键配置,或者由 AI 控制角色时,只需要更换意图生成方式。业务规则和结果事件不必随之改变。
用 C# 实现最小通信链路
下面使用 .NET 8 控制台程序模拟跳跃系统。程序不依赖游戏引擎,便于观察每层的职责。在实际 Unity 项目中,可以由 Input System 产生设备信号,再将统一意图交给角色控制系统。
创建一个 .NET 8 控制台项目,将以下代码保存为 Program.cs。其中 LocalEvents 是一个只支持跳跃结果的简化本地事件总线。
using System;
var events = new LocalEvents();
// HUD 只订阅成功的业务结果,不监听按键。
events.Jumped += e =>
Console.WriteLine($"HUD: stamina={e.RemainingStamina}");
var player = new PlayerController(events);
foreach (var signal in new[]
{
DeviceSignal.Space,
DeviceSignal.GamepadSouth,
DeviceSignal.Space
})
{
player.Execute(InputMapper.Map(signal));
}
enum DeviceSignal { Space, GamepadSouth }
enum PlayerIntent { Jump }
static class InputMapper
{
public static PlayerIntent Map(DeviceSignal signal) => signal switch
{
DeviceSignal.Space or DeviceSignal.GamepadSouth => PlayerIntent.Jump,
_ => throw new ArgumentOutOfRangeException(nameof(signal))
};
}
record Jumped(int RemainingStamina);
sealed class LocalEvents
{
public event Action<Jumped>? Jumped;
public void Publish(Jumped e) => Jumped?.Invoke(e);
}
sealed class PlayerController
{
private int _stamina = 2;
private readonly LocalEvents _events;
public PlayerController(LocalEvents events) => _events = events;
public void Execute(PlayerIntent intent)
{
if (intent != PlayerIntent.Jump) return;
// 业务规则先决定操作是否成功。
if (_stamina == 0)
{
Console.WriteLine("Business: jump rejected");
return;
}
_stamina--;
// 状态提交之后才发布成功事件。
_events.Publish(new Jumped(_stamina));
}
}预期输出:执行 dotnet run 后,前两个设备信号都成功触发跳跃,第三次因体力耗尽被拒绝。
HUD: stamina=1
HUD: stamina=0
Business: jump rejected这里的关键不是 LocalEvents 的实现复杂度,而是调用方向。InputMapper 不依赖业务状态,PlayerController 不依赖设备类型,而 HUD 只消费业务已经确认的 Jumped 事件。
如果直接把设备输入发布到全局事件总线,再让 HUD、音效和业务模块分别监听按键,就会重新引入设备耦合。即使使用了事件总线,也不能认为系统已经完成解耦。
实际客户端如何划定边界
正式项目还需要根据游戏状态决定意图是否有效。角色在菜单、战斗、载具和对话模式下,同一个按钮可能表示不同操作,因此输入映射通常需要结合当前输入上下文。
业务结果事件建议携带订阅者真正需要的稳定数据,例如角色标识、当前体力和动作结果,而不要直接暴露键盘扫描码或手柄按钮名称。多人游戏中还需要区分本地意图与服务器确认结果,不能把客户端按键行为直接当作权威业务事实。
验证分层是否合理,可以尝试三个改动:替换输入设备而不修改角色规则;拒绝跳跃时确认没有成功事件;增加新的 HUD 订阅者而不修改输入映射。三者都成立,说明设备、意图和业务结果之间已经形成了清晰的依赖边界。