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

从故事脚本取出当前内容

从故事脚本取出当前内容

游戏端接入 Ink 时,第一步不是解析 .ink 源文件,而是让 Ink Runtime 持有编译后的故事状态,并按运行进度取出文本、标签和选项。本节用 Unity/C# 的最小读取循环说明一次“继续故事—显示内容—等待选择—继续”的完整往返。

学习目标

  • 理解 Story、Continue()、canContinue 与 currentChoices 的职责
  • 从运行时读取当前文本、标签和玩家可选项
  • 在玩家选择后把索引交回 Ink,并继续读取后续内容

运行时到底要取什么

典型界面至少需要三类数据:当前要显示的文本、附着在当前内容上的标签,以及到达选择点后可展示的选项。游戏端不应该根据 knot 名或源文件行号猜剧情进度,而应该消费 Ink Runtime 当前暴露的数据。

Ink Runtime 到游戏界面的读取循环

读取循环的核心规则很简单:只要 story.canContinue 为真,就调用 Continue() 取下一段可输出内容;当它变为假时,再读取 story.currentChoices。玩家选中某项后调用 ChooseChoiceIndex,故事状态会移动到对应分支,随后重新进入读取循环。

准备一个最小 Ink 故事

下面是可用于验证读取流程的最小故事。把它编译成 Ink JSON 后作为 Unity 的 TextAsset 提供给运行时代码。

text
# speaker:guide
欢迎来到营地。
* [询问任务]
    # action:open_quest
    任务目标是找到钥匙。
    -> END
* [离开]
    再见。
    -> END

这个脚本的预期行为是:第一次读取到“欢迎来到营地。”和标签 speaker:guide,随后停止在两个选项前;如果选择索引 0,下一轮读取会得到“任务目标是找到钥匙。”以及标签 action:open_quest。

在 Unity 中读取当前内容

下面的组件使用官方 Ink C# Runtime 的常用接口。将编译后的 Ink JSON 资源拖到 inkJson 字段即可运行。示例把文本、标签和选项写到 Unity Console,实际项目可以在相同位置改成更新 UI。

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

public class InkReaderExample : MonoBehaviour
{
    [SerializeField] private TextAsset inkJson;

    private Story story;

    private void Start()
    {
        if (inkJson == null)
        {
            throw new InvalidOperationException("请先绑定编译后的 Ink JSON 资源。");
        }

        story = new Story(inkJson.text);
        ReadUntilChoiceOrEnd();
    }

    private void ReadUntilChoiceOrEnd()
    {
        // 一次取完当前可连续输出的内容,直到遇到选择点或故事结束。
        while (story.canContinue)
        {
            string text = story.Continue().Trim();

            if (!string.IsNullOrEmpty(text))
            {
                Debug.Log($"TEXT: {text}");
            }

            foreach (string tag in story.currentTags)
            {
                Debug.Log($"TAG: {tag}");
            }
        }

        // currentChoices 只描述此刻可供玩家选择的分支。
        for (int i = 0; i < story.currentChoices.Count; i++)
        {
            Choice choice = story.currentChoices[i];
            Debug.Log($"CHOICE {i}: {choice.text}");
        }
    }

    public void SelectChoice(int index)
    {
        if (index < 0 || index >= story.currentChoices.Count)
        {
            throw new ArgumentOutOfRangeException(nameof(index));
        }

        story.ChooseChoiceIndex(index);
        ReadUntilChoiceOrEnd();
    }
}

首次启动时,核心预期输出如下;Unity Console 还会显示脚本名和调用栈,这些附加信息因项目而异。

text
TEXT: 欢迎来到营地。
TAG: speaker:guide
CHOICE 0: 询问任务
CHOICE 1: 离开

调用 SelectChoice(0) 后,预期继续输出:

text
TEXT: 任务目标是找到钥匙。
TAG: action:open_quest

这里最容易写错的是只调用一次 Continue()。一个剧情节点可能连续产出多段文本,因此通常要在 canContinue 为真时持续读取;反过来,也不要在仍可继续时提前把 currentChoices 当成最终选项列表。

明确脚本与游戏代码的边界

Ink Runtime 负责“当前故事走到哪里、接下来能读什么、有哪些选择”,游戏端负责“这些内容如何显示,以及标签如何映射成游戏行为”。例如 speaker:guide 可以决定头像或名字,action:open_quest 可以通知任务系统,但脚本不应该直接操作 Unity 场景对象。

最稳妥的接入方式是把读取层做成一个窄接口:输入只有“继续”或“选择某个索引”,输出只有“文本、标签、选项”。这样 UI、任务系统和 Ink 剧情可以各自演进,而不会互相依赖内部实现。

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

目录与阅读设置

阅读设置

17

记录一个想法

从故事脚本取出当前内容

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

登录哪都通