游戏叙事与剧情 / 系统课时
对话开始时如何通知其他系统
对话开始时如何通知其他系统
剧情系统一旦开始播放对话,任务、UI、音频、角色控制等模块往往都要做出响应。本节用一个与引擎无关的 C# 事件入口,把“剧情开始、节点进入、对话结束”变成稳定的跨系统通知,避免模块之间互相直接调用。
学习目标
- 定义能长期演进的剧情生命周期事件,并明确每个事件携带的最小数据。
- 用发布订阅方式让剧情系统通知任务、UI 等模块,而不依赖具体接收方。
- 处理订阅释放、异常隔离和事件粒度,避免跨系统事件变成新的耦合点。
先把跨系统通知变成事件契约
最容易失控的写法,是让对话播放器直接调用 QuestSystem、Hud、AudioManager。这样看似省事,但每增加一个接收方,对话系统都要修改一次,最后会变成“剧情模块知道所有系统”。
更稳定的做法是让剧情系统只描述已经发生的事实。例如:某段剧情开始了、进入了哪个节点、整段对话以什么原因结束。其他系统只订阅自己关心的事件。
事件数据要遵守“够用但不过量”的原则。开始事件通常需要剧情 ID 和会话 ID;节点进入事件再增加节点 ID;结束事件需要结束原因。不要把整个对话运行时对象直接塞进事件,否则接收方会开始依赖剧情系统内部结构。

用最小事件总线跑通通知
下面示例使用普通 .NET C#,没有依赖 Unity 或其他游戏引擎。EventBus 按事件类型保存处理器,DialogueRunner 只负责发布事件,两个监听器分别模拟任务系统和 HUD。
using System;
using System.Collections.Generic;
public interface IGameEvent { }
public sealed record NarrativeStarted(string NarrativeId, string SessionId) : IGameEvent;
public sealed record NarrativeNodeEntered(string NarrativeId, string NodeId) : IGameEvent;
public sealed record NarrativeEnded(string NarrativeId, string SessionId, string Reason) : IGameEvent;
public sealed class EventBus
{
private readonly Dictionary<Type, List<Delegate>> _handlers = new();
public IDisposable Subscribe<T>(Action<T> handler) where T : IGameEvent
{
var type = typeof(T);
if (!_handlers.TryGetValue(type, out var list))
{
list = new List<Delegate>();
_handlers[type] = list;
}
list.Add(handler);
return new Subscription(() => list.Remove(handler));
}
public void Publish<T>(T message) where T : IGameEvent
{
if (!_handlers.TryGetValue(typeof(T), out var list))
{
return;
}
// 复制快照,避免处理器在回调中退订时破坏当前遍历。
foreach (var handler in list.ToArray())
{
((Action<T>)handler)(message);
}
}
private sealed class Subscription : IDisposable
{
private readonly Action _dispose;
private bool _disposed;
public Subscription(Action dispose) => _dispose = dispose;
public void Dispose()
{
if (_disposed) return;
_disposed = true;
_dispose();
}
}
}
public sealed class DialogueRunner
{
private readonly EventBus _bus;
public DialogueRunner(EventBus bus) => _bus = bus;
public void Play(string narrativeId, string sessionId)
{
_bus.Publish(new NarrativeStarted(narrativeId, sessionId));
_bus.Publish(new NarrativeNodeEntered(narrativeId, "node-greeting"));
_bus.Publish(new NarrativeNodeEntered(narrativeId, "node-accept"));
_bus.Publish(new NarrativeEnded(narrativeId, sessionId, "Completed"));
}
}
public static class Program
{
public static void Main()
{
var bus = new EventBus();
using var questSub = bus.Subscribe<NarrativeNodeEntered>(e =>
Console.WriteLine($"[Quest] entered={e.NodeId}"));
using var hudSub = bus.Subscribe<NarrativeStarted>(e =>
Console.WriteLine($"[HUD] open dialogue session={e.SessionId}"));
using var hudEndSub = bus.Subscribe<NarrativeEnded>(e =>
Console.WriteLine($"[HUD] close dialogue reason={e.Reason}"));
new DialogueRunner(bus).Play("npc-blacksmith-intro", "session-001");
}
}预期输出:
[HUD] open dialogue session=session-001
[Quest] entered=node-greeting
[Quest] entered=node-accept
[HUD] close dialogue reason=Completed这个例子有两个关键点。第一,DialogueRunner 不知道任务系统和 HUD 的存在;第二,订阅关系由组合层建立,因此接收方可以替换、增加或移除,而不需要改剧情运行器。
事件边界要比方法名更稳定
事件最好描述“已经发生的事实”,而不是命令式意图。NarrativeNodeEntered 比 AdvanceQuestNow 更适合作为剧情系统事件,因为同一个节点可能同时驱动任务、埋点和角色表现,而是否推进任务应由任务侧规则决定。
事件也不要过细。如果一句文本显示、每个字的打字机动画、每帧播放进度都发布全局事件,跨系统总线会充满高频噪声。通常只把对其他系统有业务意义的生命周期节点放到全局事件中,局部 UI 动画继续留在对话模块内部。
订阅方必须能安全退出
游戏对象、关卡和 UI 面板都有生命周期。如果订阅后不释放,旧对象可能继续收到通知,造成重复推进、空引用或内存泄漏。因此订阅 API 最好返回可释放句柄,并在对象销毁或场景退出时统一释放。
还要决定一个处理器抛异常时是否影响其他订阅者。简单单机项目可以让异常直接冒泡,尽早暴露问题;大型项目则常在事件总线边界记录异常并继续分发。无论采用哪种策略,都应保持一致,避免有些事件“失败即中断”、有些事件却悄悄吞错。
当剧情模块只发布稳定的生命周期事实,并且订阅关系由外部组合层维护时,任务、UI、音频等系统就能围绕同一入口协作,而不需要彼此知道实现细节。