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

输入事件和业务事件怎么分层

输入事件和业务事件怎么分层

在游戏客户端中,键盘空格键和手柄按钮可能都表示跳跃,但角色状态、音效和界面不应该依赖具体按键。本课将设备输入、玩家意图和业务结果分成三个层次,通过可运行的 C# 示例建立单向通信链路,让输入设备可以替换,业务规则也能独立测试。

学习目标

  • 区分设备输入、玩家意图和业务结果事件的职责。
  • 实现不同设备输入映射到同一业务操作的通信链路。
  • 判断事件应该在业务执行前还是执行后发布。

三层消息分别表达什么

游戏输入系统最容易出现的问题,是把设备行为直接当作业务事实。例如,角色按下跳跃键后,输入系统立即发布 PlayerJumped,音效系统开始播放跳跃声音,但角色实际上可能因为体力不足而无法跳跃。

问题不在事件派发机制,而在于消息没有区分请求与结果。合理的设计需要三个层次。

层次 消息示例 核心职责
设备输入 KeyboardSpaceDown 描述硬件或输入设备发生了什么
玩家意图 JumpIntent 描述玩家希望角色执行什么操作
业务结果 Jumped 描述业务规则确认发生了什么

设备输入只负责采集,不应该知道角色体力、背包状态或战斗规则。玩家意图是等待业务处理的请求,不代表操作已经成功。业务结果则应当在状态变更完成之后产生,供 HUD、音效和其他模块订阅。

用单向链路隔开输入与状态

输入适配器负责把不同设备信号转换为统一意图。例如,键盘 Space 和手柄南侧按钮都映射为 Jump,后续业务系统不需要关心输入来源。

业务系统收到意图后先执行规则检查。体力充足时扣除体力并发布 Jumped;体力不足时拒绝操作,不发布成功事件。监听者只根据确定的结果更新界面或播放音效。

设备输入、玩家意图与业务结果事件的分层数据流

这条链路还有一个重要约束:状态的写入者应当是业务系统,而不是输入适配器或 HUD 订阅者。否则多个监听者可能重复修改同一状态,导致执行顺序难以追踪。

当玩家切换设备、修改按键配置,或者由 AI 控制角色时,只需要更换意图生成方式。业务规则和结果事件不必随之改变。

用 C# 实现最小通信链路

下面使用 .NET 8 控制台程序模拟跳跃系统。程序不依赖游戏引擎,便于观察每层的职责。在实际 Unity 项目中,可以由 Input System 产生设备信号,再将统一意图交给角色控制系统。

创建一个 .NET 8 控制台项目,将以下代码保存为 Program.cs。其中 LocalEvents 是一个只支持跳跃结果的简化本地事件总线。

csharp
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 后,前两个设备信号都成功触发跳跃,第三次因体力耗尽被拒绝。

text
HUD: stamina=1
HUD: stamina=0
Business: jump rejected

这里的关键不是 LocalEvents 的实现复杂度,而是调用方向。InputMapper 不依赖业务状态,PlayerController 不依赖设备类型,而 HUD 只消费业务已经确认的 Jumped 事件。

如果直接把设备输入发布到全局事件总线,再让 HUD、音效和业务模块分别监听按键,就会重新引入设备耦合。即使使用了事件总线,也不能认为系统已经完成解耦。

实际客户端如何划定边界

正式项目还需要根据游戏状态决定意图是否有效。角色在菜单、战斗、载具和对话模式下,同一个按钮可能表示不同操作,因此输入映射通常需要结合当前输入上下文。

业务结果事件建议携带订阅者真正需要的稳定数据,例如角色标识、当前体力和动作结果,而不要直接暴露键盘扫描码或手柄按钮名称。多人游戏中还需要区分本地意图与服务器确认结果,不能把客户端按键行为直接当作权威业务事实。

验证分层是否合理,可以尝试三个改动:替换输入设备而不修改角色规则;拒绝跳跃时确认没有成功事件;增加新的 HUD 订阅者而不修改输入映射。三者都成立,说明设备、意图和业务结果之间已经形成了清晰的依赖边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

输入事件和业务事件怎么分层

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

登录哪都通