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

用观察者响应剧情变量变化

用观察者响应剧情变量变化

当 UI、任务系统或玩法逻辑需要跟随 Ink 变量变化时,最容易写成“每次推进剧情后把所有变量读一遍”。这种轮询会让剧情控制器越来越臃肿。更合适的做法是观察关键变量,让 Ink 变化成为事件,再由 Unity 各系统只处理自己关心的更新。

学习目标

  • 使用 ObserveVariable 或 ObserveVariables 订阅 Ink 全局变量变化
  • 把观察回调路由到 UI、任务或玩法系统,而不是集中写死在剧情推进代码里
  • 正确解绑观察者,避免重复订阅和对象销毁后的回调

让变量变化主动通知 Unity

轮询方案通常把 Continue()、变量读取、UI 刷新、任务推进和场景逻辑绑在同一个方法里。变量一多,每次剧情推进都要重复读取;而观察者只在指定变量发生变化时收到通知,更适合做状态驱动的更新。

Ink 变量观察者事件链

观察的对象必须是 Ink 中已经声明的全局变量。下面的最小故事在 advance_quest 中一次改变任务阶段和门的状态:

text
VAR quest_stage = 0
VAR gate_open = false

=== advance_quest ===
~ quest_stage = 2
~ gate_open = true
-> DONE

注册并路由观察回调

Unity 侧可以让多个变量共用一个回调,再按变量名分发。这样新增 UI 或玩法响应时,不需要改 Continue() 的主流程。

csharp
using System.Collections.Generic;
using Ink.Runtime;
using UnityEngine;

public sealed class InkVariableObserverExample : MonoBehaviour
{
    [SerializeField] private TextAsset compiledInkJson;

    private Story story;

    private void Start()
    {
        story = new Story(compiledInkJson.text);

        story.ObserveVariables(
            new List<string> { "quest_stage", "gate_open" },
            OnInkVariableChanged
        );

        story.ChoosePathString("advance_quest");

        while (story.canContinue)
        {
            story.Continue();
        }
    }

    private void OnInkVariableChanged(string variableName, object newValue)
    {
        switch (variableName)
        {
            case "quest_stage":
                ApplyQuestStage((int)newValue);
                break;

            case "gate_open":
                ApplyGateState((bool)newValue);
                break;
        }
    }

    private void ApplyQuestStage(int stage)
    {
        Debug.Log($"Task UI updated: quest_stage={stage}");
    }

    private void ApplyGateState(bool isOpen)
    {
        Debug.Log($"Gate gameplay updated: gate_open={isOpen}");
    }

    private void OnDestroy()
    {
        if (story != null)
        {
            // 传入同一个方法委托,可一次移除它订阅的所有变量。
            story.RemoveVariableObserver(OnInkVariableChanged);
        }
    }
}

预期输出会包含以下两条日志;如果运行时回调顺序不同,不影响结果:

text
Task UI updated: quest_stage=2
Gate gameplay updated: gate_open=True

这里的关键点不是 switch,而是职责边界:Ink 只修改剧情变量,观察者负责把“发生了什么变化”交给 Unity,具体怎样刷新界面或打开场景对象由下游系统决定。

处理生命周期与重复订阅

观察者最常见的错误是重复注册。比如场景重载后又执行一次 ObserveVariable,但旧对象仍然存活,同一个变量变化就可能触发两次回调。注册与解绑应放在同一组件的生命周期内,并确保一个 Story 实例只建立一组预期订阅。

回调里也不要立即反向修改同一个被观察变量,否则容易形成难以追踪的状态回路。更稳妥的规则是:观察者负责响应,不负责把响应结果再写回同一变量。确实需要反馈给 Ink 时,使用另一个含义明确的输入变量或显式游戏事件。

什么时候用观察者

适合观察的变量通常具有“变化后需要立即产生外部副作用”的特点,例如任务阶段、HUD 模式、场景门锁状态或角色关系等级。纯粹只在下一句剧情判断中使用的变量没有必要同步到 Unity。

当变量属于持续状态时,观察者负责增量更新;当场景刚加载或 UI 刚创建时,还应主动读取一次当前值完成初始渲染。这样“初始快照”和“后续变化事件”各司其职,不会因为观察者只处理变化而漏掉当前状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

用观察者响应剧情变量变化

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

登录哪都通