游戏叙事与剧情 / 系统课时
跨系统事件怎么避免互相绑死
跨系统事件怎么避免互相绑死
剧情系统一旦同时驱动任务、UI、音频和埋点,最容易出现“改一句对白要改四个系统”的连锁反应。本篇用直接调用、事件总线和接口适配三种方式划清边界,并给出一套可运行示例,最终让剧情只依赖稳定契约,而不是依赖其他系统的内部实现。
学习目标
- 判断直接调用、事件总线和接口适配分别适合什么交互。
- 用“命令走接口、通知走事件”的方式降低跨系统耦合。
- 为跨系统事件设计稳定载荷、幂等边界和可验证契约。
先区分命令和通知
跨系统通信先不要问“用不用事件总线”,而要问这次交互有没有明确的目标系统和返回语义。剧情要求任务系统“把 quest-rescue 推进 1 步”属于命令,调用方知道谁负责执行,也通常希望立刻知道是否成功。剧情结束后告诉 UI、埋点和成就系统“对话已完成”则属于通知,发布者不应该知道有多少订阅者。
如果把所有事情都做成直接调用,剧情层会逐渐持有 QuestSystem、HudController、AudioManager、AnalyticsClient 等具体对象。反过来,把所有事情都塞进全局事件总线,又会失去清晰的依赖关系,调用链只能靠日志猜。

三种连接方式怎么选
| 方式 | 适合场景 | 主要优点 | 主要风险 |
|---|---|---|---|
| 直接调用 | 同一模块内部、生命周期一致、变化很少 | 最直观,调用链清楚 | 容易把上层绑到具体实现 |
| 接口适配 | 有明确执行方的跨系统命令 | 依赖可替换、可测试、失败语义清楚 | 接口设计过细会产生大量胶水代码 |
| 事件总线 | 一对多通知、订阅者可增减 | 发布者无需认识订阅者 | 过度使用会让链路隐蔽、顺序不确定 |
一个实用规则是:要某个系统做事,用接口;只是宣布某件事发生了,用事件。 只有在上下层本来就属于同一模块时,才优先直接调用具体对象。
用接口和事件实现边界
下面示例把“推进任务”建模为接口命令,把“对白完成”建模为事件。剧情系统不知道任务实现细节,也不知道 UI 和埋点订阅者是否存在。
using System;
using System.Collections.Generic;
public interface IQuestCommandPort
{
bool Advance(string questId, int step);
}
public sealed record DialogueCompleted(string DialogueId);
public sealed class EventBus
{
private readonly Dictionary<Type, List<Delegate>> handlers = new();
public void Subscribe<T>(Action<T> handler)
{
if (!handlers.TryGetValue(typeof(T), out var list))
{
list = new List<Delegate>();
handlers[typeof(T)] = list;
}
list.Add(handler);
}
public void Publish<T>(T message)
{
if (!handlers.TryGetValue(typeof(T), out var list))
return;
// 复制订阅列表,避免回调期间修改集合影响本轮派发。
foreach (var handler in list.ToArray())
((Action<T>)handler)(message);
}
}
public sealed class QuestSystemAdapter : IQuestCommandPort
{
public bool Advance(string questId, int step)
{
Console.WriteLine($"任务推进: {questId} +{step}");
return true;
}
}
public sealed class NarrativeSystem
{
private readonly IQuestCommandPort questPort;
private readonly EventBus eventBus;
public NarrativeSystem(IQuestCommandPort questPort, EventBus eventBus)
{
this.questPort = questPort;
this.eventBus = eventBus;
}
public void CompleteDialogue(string dialogueId)
{
if (!questPort.Advance("quest-rescue", 1))
throw new InvalidOperationException("任务推进失败");
// 通知只描述已经发生的事实,不暴露 NarrativeSystem 自身对象。
eventBus.Publish(new DialogueCompleted(dialogueId));
}
}
public static class Program
{
public static void Main()
{
var bus = new EventBus();
bus.Subscribe<DialogueCompleted>(e =>
Console.WriteLine($"UI 收到: {e.DialogueId}"));
bus.Subscribe<DialogueCompleted>(e =>
Console.WriteLine($"埋点收到: {e.DialogueId}"));
var narrative = new NarrativeSystem(new QuestSystemAdapter(), bus);
narrative.CompleteDialogue("dialogue-forest-01");
}
}预期输出:
任务推进: quest-rescue +1
UI 收到: dialogue-forest-01
埋点收到: dialogue-forest-01示例中的 EventBus 只是教学用同步实现。真实游戏若允许订阅者抛异常、异步执行或跨线程派发,需要额外定义异常隔离、线程模型和执行顺序,不能默认所有处理器都安全地在同一帧执行。
事件载荷不要泄漏内部对象
事件应携带稳定标识和必要快照,例如 dialogueId、questId、结果枚举、发生时间或版本号,而不是把 DialogueNode、QuestRuntime 这类可变对象直接传出去。后者会让订阅者读取甚至修改发布者内部状态,表面上用了事件,实际仍然耦合。
跨系统事件还要提前约定两个边界。第一是重复派发是否允许;如果事件可能因存档恢复或重试再次出现,订阅者最好用事件 ID 或业务键做幂等。第二是顺序是否重要;若“任务完成”必须先于“章节解锁”,就不要依赖两个无序订阅者碰巧按注册顺序执行,应把强顺序动作收回同一个命令编排中。
用替换测试检查是否真的解耦
最简单的验收方式,是把目标系统换成假的实现。若 NarrativeSystem 在不启动任务模块、UI 或埋点模块的情况下仍能独立测试,说明边界基本合理。反之,如果测试仍要构造半个游戏世界,通常意味着接口里泄漏了具体类型,或事件消费者反过来调用了发布者。
工程上不追求“零耦合”,而是让耦合集中在稳定契约上:明确目标和失败语义的动作走接口,一对多事实通知走事件,总线只负责派发而不承载业务决策。这样增加新订阅者时不必改剧情代码,替换任务实现时也不用改剧情流程。