游戏叙事与剧情 / 系统课时
从故事脚本取出当前内容
从故事脚本取出当前内容
游戏端接入 Ink 时,第一步不是解析 .ink 源文件,而是让 Ink Runtime 持有编译后的故事状态,并按运行进度取出文本、标签和选项。本节用 Unity/C# 的最小读取循环说明一次“继续故事—显示内容—等待选择—继续”的完整往返。
学习目标
- 理解
Story、Continue()、canContinue与currentChoices的职责 - 从运行时读取当前文本、标签和玩家可选项
- 在玩家选择后把索引交回 Ink,并继续读取后续内容
运行时到底要取什么
典型界面至少需要三类数据:当前要显示的文本、附着在当前内容上的标签,以及到达选择点后可展示的选项。游戏端不应该根据 knot 名或源文件行号猜剧情进度,而应该消费 Ink Runtime 当前暴露的数据。

读取循环的核心规则很简单:只要 story.canContinue 为真,就调用 Continue() 取下一段可输出内容;当它变为假时,再读取 story.currentChoices。玩家选中某项后调用 ChooseChoiceIndex,故事状态会移动到对应分支,随后重新进入读取循环。
准备一个最小 Ink 故事
下面是可用于验证读取流程的最小故事。把它编译成 Ink JSON 后作为 Unity 的 TextAsset 提供给运行时代码。
# speaker:guide
欢迎来到营地。
* [询问任务]
# action:open_quest
任务目标是找到钥匙。
-> END
* [离开]
再见。
-> END这个脚本的预期行为是:第一次读取到“欢迎来到营地。”和标签 speaker:guide,随后停止在两个选项前;如果选择索引 0,下一轮读取会得到“任务目标是找到钥匙。”以及标签 action:open_quest。
在 Unity 中读取当前内容
下面的组件使用官方 Ink C# Runtime 的常用接口。将编译后的 Ink JSON 资源拖到 inkJson 字段即可运行。示例把文本、标签和选项写到 Unity Console,实际项目可以在相同位置改成更新 UI。
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: 欢迎来到营地。
TAG: speaker:guide
CHOICE 0: 询问任务
CHOICE 1: 离开调用 SelectChoice(0) 后,预期继续输出:
TEXT: 任务目标是找到钥匙。
TAG: action:open_quest这里最容易写错的是只调用一次 Continue()。一个剧情节点可能连续产出多段文本,因此通常要在 canContinue 为真时持续读取;反过来,也不要在仍可继续时提前把 currentChoices 当成最终选项列表。
明确脚本与游戏代码的边界
Ink Runtime 负责“当前故事走到哪里、接下来能读什么、有哪些选择”,游戏端负责“这些内容如何显示,以及标签如何映射成游戏行为”。例如 speaker:guide 可以决定头像或名字,action:open_quest 可以通知任务系统,但脚本不应该直接操作 Unity 场景对象。
最稳妥的接入方式是把读取层做成一个窄接口:输入只有“继续”或“选择某个索引”,输出只有“文本、标签、选项”。这样 UI、任务系统和 Ink 剧情可以各自演进,而不会互相依赖内部实现。