游戏叙事与剧情 / 系统课时
用观察者响应剧情变量变化
用观察者响应剧情变量变化
当 UI、任务系统或玩法逻辑需要跟随 Ink 变量变化时,最容易写成“每次推进剧情后把所有变量读一遍”。这种轮询会让剧情控制器越来越臃肿。更合适的做法是观察关键变量,让 Ink 变化成为事件,再由 Unity 各系统只处理自己关心的更新。
学习目标
- 使用
ObserveVariable或ObserveVariables订阅 Ink 全局变量变化 - 把观察回调路由到 UI、任务或玩法系统,而不是集中写死在剧情推进代码里
- 正确解绑观察者,避免重复订阅和对象销毁后的回调
让变量变化主动通知 Unity
轮询方案通常把 Continue()、变量读取、UI 刷新、任务推进和场景逻辑绑在同一个方法里。变量一多,每次剧情推进都要重复读取;而观察者只在指定变量发生变化时收到通知,更适合做状态驱动的更新。

观察的对象必须是 Ink 中已经声明的全局变量。下面的最小故事在 advance_quest 中一次改变任务阶段和门的状态:
VAR quest_stage = 0
VAR gate_open = false
=== advance_quest ===
~ quest_stage = 2
~ gate_open = true
-> DONE注册并路由观察回调
Unity 侧可以让多个变量共用一个回调,再按变量名分发。这样新增 UI 或玩法响应时,不需要改 Continue() 的主流程。
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);
}
}
}预期输出会包含以下两条日志;如果运行时回调顺序不同,不影响结果:
Task UI updated: quest_stage=2
Gate gameplay updated: gate_open=True这里的关键点不是 switch,而是职责边界:Ink 只修改剧情变量,观察者负责把“发生了什么变化”交给 Unity,具体怎样刷新界面或打开场景对象由下游系统决定。
处理生命周期与重复订阅
观察者最常见的错误是重复注册。比如场景重载后又执行一次 ObserveVariable,但旧对象仍然存活,同一个变量变化就可能触发两次回调。注册与解绑应放在同一组件的生命周期内,并确保一个 Story 实例只建立一组预期订阅。
回调里也不要立即反向修改同一个被观察变量,否则容易形成难以追踪的状态回路。更稳妥的规则是:观察者负责响应,不负责把响应结果再写回同一变量。确实需要反馈给 Ink 时,使用另一个含义明确的输入变量或显式游戏事件。
什么时候用观察者
适合观察的变量通常具有“变化后需要立即产生外部副作用”的特点,例如任务阶段、HUD 模式、场景门锁状态或角色关系等级。纯粹只在下一句剧情判断中使用的变量没有必要同步到 Unity。
当变量属于持续状态时,观察者负责增量更新;当场景刚加载或 UI 刚创建时,还应主动读取一次当前值完成初始渲染。这样“初始快照”和“后续变化事件”各司其职,不会因为观察者只处理变化而漏掉当前状态。