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

避免变量同步覆盖错误状态

避免变量同步覆盖错误状态

Ink 与 Unity 同时保存同一份“剧情状态”时,最常见的问题不是读不到变量,而是后写入的一方把正确值覆盖掉。本课把变量分成剧情拥有、游戏拥有两类,并用明确的初始化与加载顺序避免重复初始化和错误回写。

学习目标

  • 区分 Ink Story 内状态与 Unity 游戏全局状态的所有权
  • 设计新游戏、读档两条不会互相覆盖的初始化路径
  • 用白名单同步代替“把所有变量双向复制”的做法

先决定谁拥有变量

同步前先回答一个问题:这个值最终由谁说了算? 例如 quest_stage 表示剧情推进位置,通常应由 Ink 拥有;reputation 如果来自战斗、任务和开放世界系统,则应由 Unity 的 GameState 拥有,Ink 只读取它的镜像。

变量 权威来源 允许的同步方向
quest_stage Ink Story Ink → Unity 展示或触发
reputation Unity GameState Unity → Ink
player_name Unity 玩家资料 Unity → Ink

不要把同一个字段长期设计成“双向都能改”。如果两边都能写,加载、切场景、重新创建 Story 或恢复存档时就很难判断哪个值更新、更可信。

状态所有权与同步方向

重复初始化为什么会覆盖正确状态

创建新的 Story 时,Ink 会先得到脚本中声明的全局变量初值。新游戏可以在这之后把 Unity 拥有的玩家资料写入 Story;读档则应先恢复 story.state,再只补写 Unity 拥有的变量。

危险做法是每次创建 Story 后都执行同一套“初始化全部变量”。假设存档里的 quest_stage 已经是 2,读档后又把它写回默认值 0,存档本身没有坏,但恢复流程把正确状态覆盖掉了。

用两条入口分开新游戏与读档

下面示例依赖一个已经编译为 JSON 的 Ink 故事,其中声明了 quest_stage、reputation 和 player_name 三个全局变量。Ink 源文件可保持最小定义:

text
VAR quest_stage = 0
VAR reputation = 0
VAR player_name = ""

Unity 侧只允许 reputation 和 player_name 从游戏状态写入 Ink;quest_stage 只随 Ink 自己的状态保存和恢复。

csharp
using Ink.Runtime;
using UnityEngine;

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

    private Story story;

    private sealed class GameState
    {
        public string PlayerName;
        public int Reputation;
    }

    private void Start()
    {
        var game = new GameState
        {
            PlayerName = "Mira",
            Reputation = 3
        };

        StartNewGame(game);

        // 模拟剧情已经推进到阶段 2,并把完整 Ink 状态保存下来。
        story.variablesState["quest_stage"] = 2;
        string savedInkState = story.state.ToJson();

        // 模拟游戏全局状态在别处更新,读档后它仍是权威来源。
        game.Reputation = 8;
        LoadGame(savedInkState, game);

        int questStage = (int)story.variablesState["quest_stage"];
        int reputation = (int)story.variablesState["reputation"];

        Debug.Log($"quest_stage={questStage}, reputation={reputation}");
    }

    private void StartNewGame(GameState game)
    {
        story = new Story(compiledInkJson.text);
        PushGameOwnedVariables(game);
    }

    private void LoadGame(string inkStateJson, GameState game)
    {
        story = new Story(compiledInkJson.text);

        // 先恢复 Ink 自己的完整状态,再同步 Unity 拥有的少量变量。
        story.state.LoadJson(inkStateJson);
        PushGameOwnedVariables(game);
    }

    private void PushGameOwnedVariables(GameState game)
    {
        story.variablesState["player_name"] = game.PlayerName;
        story.variablesState["reputation"] = game.Reputation;

        // quest_stage 不在这里写入,因为它属于 Ink。
    }
}

预期输出:

text
quest_stage=2, reputation=8

quest_stage 保留存档中的 2,说明读档流程没有重新初始化剧情变量;reputation 变为 8,说明 Unity 只覆盖了自己拥有的状态。

给同步边界加上白名单

工程里最稳妥的做法是把同步变量显式列出,而不是遍历 variablesState 后全部复制。新增变量时,开发者必须明确选择“由 Ink 拥有”还是“由 Unity 拥有”,同步方向也随之确定。

保存时应保存完整的 story.state.ToJson(),因为 Story 状态不只有全局变量,还包含当前位置、访问计数、调用栈等运行信息。游戏自己的存档则单独保存 GameState。恢复时先恢复各自状态,再通过白名单桥接必要字段,就能避免重复初始化和错误回写互相污染。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免变量同步覆盖错误状态

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

登录哪都通