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

跨系统事件怎么避免互相绑死

跨系统事件怎么避免互相绑死

剧情系统一旦同时驱动任务、UI、音频和埋点,最容易出现“改一句对白要改四个系统”的连锁反应。本篇用直接调用、事件总线和接口适配三种方式划清边界,并给出一套可运行示例,最终让剧情只依赖稳定契约,而不是依赖其他系统的内部实现。

学习目标

  • 判断直接调用、事件总线和接口适配分别适合什么交互。
  • 用“命令走接口、通知走事件”的方式降低跨系统耦合。
  • 为跨系统事件设计稳定载荷、幂等边界和可验证契约。

先区分命令和通知

跨系统通信先不要问“用不用事件总线”,而要问这次交互有没有明确的目标系统和返回语义。剧情要求任务系统“把 quest-rescue 推进 1 步”属于命令,调用方知道谁负责执行,也通常希望立刻知道是否成功。剧情结束后告诉 UI、埋点和成就系统“对话已完成”则属于通知,发布者不应该知道有多少订阅者。

如果把所有事情都做成直接调用,剧情层会逐渐持有 QuestSystem、HudController、AudioManager、AnalyticsClient 等具体对象。反过来,把所有事情都塞进全局事件总线,又会失去清晰的依赖关系,调用链只能靠日志猜。

直接调用、接口适配与事件总线的职责边界

三种连接方式怎么选

方式 适合场景 主要优点 主要风险
直接调用 同一模块内部、生命周期一致、变化很少 最直观,调用链清楚 容易把上层绑到具体实现
接口适配 有明确执行方的跨系统命令 依赖可替换、可测试、失败语义清楚 接口设计过细会产生大量胶水代码
事件总线 一对多通知、订阅者可增减 发布者无需认识订阅者 过度使用会让链路隐蔽、顺序不确定

一个实用规则是:要某个系统做事,用接口;只是宣布某件事发生了,用事件。 只有在上下层本来就属于同一模块时,才优先直接调用具体对象。

用接口和事件实现边界

下面示例把“推进任务”建模为接口命令,把“对白完成”建模为事件。剧情系统不知道任务实现细节,也不知道 UI 和埋点订阅者是否存在。

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

预期输出:

text
任务推进: quest-rescue +1
UI 收到: dialogue-forest-01
埋点收到: dialogue-forest-01

示例中的 EventBus 只是教学用同步实现。真实游戏若允许订阅者抛异常、异步执行或跨线程派发,需要额外定义异常隔离、线程模型和执行顺序,不能默认所有处理器都安全地在同一帧执行。

事件载荷不要泄漏内部对象

事件应携带稳定标识和必要快照,例如 dialogueId、questId、结果枚举、发生时间或版本号,而不是把 DialogueNode、QuestRuntime 这类可变对象直接传出去。后者会让订阅者读取甚至修改发布者内部状态,表面上用了事件,实际仍然耦合。

跨系统事件还要提前约定两个边界。第一是重复派发是否允许;如果事件可能因存档恢复或重试再次出现,订阅者最好用事件 ID 或业务键做幂等。第二是顺序是否重要;若“任务完成”必须先于“章节解锁”,就不要依赖两个无序订阅者碰巧按注册顺序执行,应把强顺序动作收回同一个命令编排中。

用替换测试检查是否真的解耦

最简单的验收方式,是把目标系统换成假的实现。若 NarrativeSystem 在不启动任务模块、UI 或埋点模块的情况下仍能独立测试,说明边界基本合理。反之,如果测试仍要构造半个游戏世界,通常意味着接口里泄漏了具体类型,或事件消费者反过来调用了发布者。

工程上不追求“零耦合”,而是让耦合集中在稳定契约上:明确目标和失败语义的动作走接口,一对多事实通知走事件,总线只负责派发而不承载业务决策。这样增加新订阅者时不必改剧情代码,替换任务实现时也不用改剧情流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

跨系统事件怎么避免互相绑死

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

登录哪都通