游戏叙事与剧情 / 系统课时
从 Story 读取一行台词
从 Story 读取一行台词
这一节只解决一个最小问题:Unity 已拿到 Ink 编译后的 TextAsset 后,怎样创建 Story,判断是否还有内容,并读取第一行台词。完成后,你会得到一个可直接挂到 GameObject 上验证的最小运行时入口。
学习目标
- 用
Ink.Runtime.Story加载编译后的 Ink JSON。 - 正确使用
canContinue与Continue()读取一行内容。 - 理解“读取”同时会推进故事状态,避免重复或越界调用。
准备最小 Ink 内容
在 Unity 项目中准备一个 Ink 文件,例如 Assets/Ink/dialogue.ink。安装并启用 Ink Unity Integration 后,编辑器会把 Ink 源文件编译为运行时可读取的 JSON 资源。
阿岚:你终于来了。
守门人:前面就是旧城。
-> END这里有两行普通文本。第一节只读取第一行,因此不会一次把整段故事都取出来。
创建 Story 并读取第一行
新建 InkLineReader.cs,挂到场景中的任意 GameObject,然后把编译得到的 Ink JSON TextAsset 拖到 Inspector 的 Ink JSON Asset 字段。
using Ink.Runtime;
using UnityEngine;
public class InkLineReader : MonoBehaviour
{
[SerializeField] private TextAsset inkJsonAsset;
private Story story;
private void Start()
{
if (inkJsonAsset == null)
{
Debug.LogError("Ink JSON Asset 未绑定。");
return;
}
story = new Story(inkJsonAsset.text);
// canContinue 为 true,表示当前路径上还有可读取的文本。
if (story.canContinue)
{
string line = story.Continue();
Debug.Log(line.TrimEnd());
}
}
}预期输出
阿岚:你终于来了。new Story(inkJsonAsset.text) 会从编译后的 Ink JSON 创建一个运行时故事实例。真正推进故事的是 Continue():每调用一次,Story 都会沿当前路径继续执行,直到产出下一段可返回的文本。
为什么先检查 canContinue
canContinue 表示当前故事状态是否还能继续产生普通文本。最小读取流程因此是“先判断,再推进”:
if (story.canContinue)
{
string line = story.Continue();
}这段是片段示例,依赖前文已经创建好的 story。它不会产生独立控制台输出,但生效行为很明确:只有存在下一段文本时才调用 Continue()。
不要把 currentText 当成“下一行”的读取 API。currentText 反映的是 Story 最近一次继续执行后得到的当前文本;如果还没有调用 Continue(),它并不会替你向前推进剧情。
把最小读取接到真实对话按钮
当你从控制台验证迁移到 UI 时,建议把“推进一次”封装成独立方法。每次按钮点击只调用一次,便于后续插入打字机效果、标签解析和选项处理。
public string ReadNextLine()
{
if (story == null || !story.canContinue)
{
return null;
}
return story.Continue().TrimEnd();
}这也是片段示例,依赖类中的 story 字段。调用成功时返回下一行文本;没有可继续内容时返回 null,调用方据此决定隐藏“继续”按钮或转入结束处理。
最小 Story 驱动链路并不复杂:用编译后的 JSON 创建 Story,读取前检查 canContinue,再用 Continue() 取得文本并推进状态。把这三个动作分清楚,后续连续台词、选项和分支都可以在同一个运行时循环上扩展。