游戏叙事与剧情 / 系统课时

对话开始时如何通知其他系统

对话开始时如何通知其他系统

剧情系统一旦开始播放对话,任务、UI、音频、角色控制等模块往往都要做出响应。本节用一个与引擎无关的 C# 事件入口,把“剧情开始、节点进入、对话结束”变成稳定的跨系统通知,避免模块之间互相直接调用。

学习目标

  • 定义能长期演进的剧情生命周期事件,并明确每个事件携带的最小数据。
  • 用发布订阅方式让剧情系统通知任务、UI 等模块,而不依赖具体接收方。
  • 处理订阅释放、异常隔离和事件粒度,避免跨系统事件变成新的耦合点。

先把跨系统通知变成事件契约

最容易失控的写法,是让对话播放器直接调用 QuestSystem、Hud、AudioManager。这样看似省事,但每增加一个接收方,对话系统都要修改一次,最后会变成“剧情模块知道所有系统”。

更稳定的做法是让剧情系统只描述已经发生的事实。例如:某段剧情开始了、进入了哪个节点、整段对话以什么原因结束。其他系统只订阅自己关心的事件。

事件数据要遵守“够用但不过量”的原则。开始事件通常需要剧情 ID 和会话 ID;节点进入事件再增加节点 ID;结束事件需要结束原因。不要把整个对话运行时对象直接塞进事件,否则接收方会开始依赖剧情系统内部结构。

剧情生命周期事件驱动跨系统通知

用最小事件总线跑通通知

下面示例使用普通 .NET C#,没有依赖 Unity 或其他游戏引擎。EventBus 按事件类型保存处理器,DialogueRunner 只负责发布事件,两个监听器分别模拟任务系统和 HUD。

csharp
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");
    }
}

预期输出:

text
[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、音频等系统就能围绕同一入口协作,而不需要彼此知道实现细节。

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

目录与阅读设置

阅读设置

17

记录一个想法

对话开始时如何通知其他系统

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

登录哪都通