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

检查存档与分支回放结果

检查存档与分支回放结果

互动剧情最危险的问题往往不是第一次运行失败,而是读取存档、重复进入节点或从同一存档回放不同选择后状态悄悄漂移。本节用可重复的测试方法检查分支隔离、变量恢复和重复进入结果是否一致。

学习目标

  • 使用 Ink Story 状态序列化保存并恢复完整运行时进度
  • 从同一选择点快照回放不同分支,确认结果互不污染
  • 检查重复进入剧情节点时计数和持久变量是否符合预期

先定义需要保持一致的状态

测试不能只比较最终显示的文字,因为两个错误状态也可能恰好输出相同文本。更可靠的检查对象至少包括当前剧情位置、关键 Ink 变量以及当前选择集合。

下面的最小故事使用 has_key 表示是否拿到钥匙,用 visit_count 记录进入门厅的次数。它同时覆盖分支状态和重复进入两个容易出错的场景。

text
VAR has_key = false
VAR visit_count = 0

=== hub ===
~ visit_count = visit_count + 1
{ visit_count == 1:
    第一次来到门厅。
- else:
    再次来到门厅。
}

+ [拿钥匙]
    ~ has_key = true
    你拿起了钥匙。
    -> END
+ [离开]
    你离开了门厅。
    -> END

这段脚本编译后,第一次进入 hub 时 visit_count 应为 1。选择“拿钥匙”后 has_key 应变成 true;选择“离开”则仍为 false。

用快照隔离不同分支

Ink 运行时可以通过 story.state.ToJson() 把当前 Story 状态序列化为字符串,并通过 story.state.LoadJson() 恢复。为了验证分支隔离,可以在出现选择时只保存一次快照,然后分别加载到两个新的 Story 实例,再选择不同分支。

同一 Ink 存档快照回放为两个独立分支并再次恢复的状态关系

关键原则是每次分支回放都从同一个未被修改的快照创建独立 Story。如果先在一个实例中跑完 A 分支,再试图把变量手工改回去测试 B 分支,很容易漏掉调用栈、访问计数或其他内部状态。

编写一组可重复的运行时检查

下面的 Unity 组件在启动时执行四项检查:保存选择点、回放“拿钥匙”、从相同快照回放“离开”、恢复拿钥匙后的存档并重新进入 hub。它依赖已编译的 Ink JSON,并需要在 Inspector 中赋给 storyJson。

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

public sealed class InkReplayCheck : MonoBehaviour
{
    [SerializeField] private TextAsset storyJson;

    private void Start()
    {
        Story initial = NewStory();
        ContinueToChoice(initial);
        AssertEqual(1, ReadInt(initial, "visit_count"), "首次进入次数");

        // 在任何选择发生前保存统一基线,后面的分支都从这里恢复。
        string choiceSnapshot = initial.state.ToJson();

        Story takeKey = NewStory();
        takeKey.state.LoadJson(choiceSnapshot);
        takeKey.ChooseChoiceIndex(0);
        ContinueToEnd(takeKey);
        AssertEqual(true, ReadBool(takeKey, "has_key"), "拿钥匙分支");

        Story leave = NewStory();
        leave.state.LoadJson(choiceSnapshot);
        leave.ChooseChoiceIndex(1);
        ContinueToEnd(leave);
        AssertEqual(false, ReadBool(leave, "has_key"), "离开分支");

        // 保存已经拿到钥匙的结果,再恢复并重复进入 hub。
        string savedAfterKey = takeKey.state.ToJson();
        Story restored = NewStory();
        restored.state.LoadJson(savedAfterKey);
        AssertEqual(true, ReadBool(restored, "has_key"), "恢复后钥匙状态");

        restored.ChoosePathString("hub");
        ContinueToChoice(restored);
        AssertEqual(2, ReadInt(restored, "visit_count"), "重复进入次数");
        AssertEqual(true, ReadBool(restored, "has_key"), "重复进入后的钥匙状态");

        Debug.Log("Ink replay checks passed");
    }

    private Story NewStory()
    {
        return new Story(storyJson.text);
    }

    private static void ContinueToChoice(Story story)
    {
        while (story.canContinue)
            story.Continue();

        if (story.currentChoices.Count == 0)
            throw new InvalidOperationException("预期出现选择,但当前没有可选项");
    }

    private static void ContinueToEnd(Story story)
    {
        while (story.canContinue)
            story.Continue();
    }

    private static bool ReadBool(Story story, string name)
    {
        return (bool)story.variablesState[name];
    }

    private static int ReadInt(Story story, string name)
    {
        return (int)story.variablesState[name];
    }

    private static void AssertEqual<T>(T expected, T actual, string label)
    {
        if (!Equals(expected, actual))
            throw new Exception($"{label}: expected={expected}, actual={actual}");
    }
}

预期输出:

text
Ink replay checks passed

只要任意状态不符合预期,组件会在到达最终日志前抛出异常,并指出失败的检查项。Unity 可能在日志中附加时间、调用栈等环境信息,实际格式可以不同。

为什么不能只保存几个剧情变量

手工保存 has_key、visit_count 之类的变量看起来简单,但 Story 的完整运行状态不只有全局变量,还包含当前位置、调用栈、选择状态等信息。要恢复“玩家当时正走到哪里”,应保存 story.state.ToJson() 的完整结果,而不是自行拼一个变量字典冒充 Ink 存档。

把边界场景加入验收

正式验收时,至少保留三类回放用例:关键选择点分别走每个重要分支;在分支结束后保存并重新加载,核对关键变量;对允许重复进入的 knot 再次调用路径跳转,确认计数、一次性奖励和已获得物品不会被意外重置。

分支测试的重点不是证明某一次剧情能跑完,而是证明相同快照能稳定复现相同状态,不同分支不会互相污染,恢复后继续推进仍与保存前的逻辑一致。做到这一点,剧情才真正具备接入游戏存档系统的条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查存档与分支回放结果

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

登录哪都通