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

从 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 资源。

text
阿岚:你终于来了。
守门人:前面就是旧城。
-> END

这里有两行普通文本。第一节只读取第一行,因此不会一次把整段故事都取出来。

创建 Story 并读取第一行

新建 InkLineReader.cs,挂到场景中的任意 GameObject,然后把编译得到的 Ink JSON TextAsset 拖到 Inspector 的 Ink JSON Asset 字段。

csharp
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());
        }
    }
}

预期输出

text
阿岚:你终于来了。

new Story(inkJsonAsset.text) 会从编译后的 Ink JSON 创建一个运行时故事实例。真正推进故事的是 Continue():每调用一次,Story 都会沿当前路径继续执行,直到产出下一段可返回的文本。

为什么先检查 canContinue

canContinue 表示当前故事状态是否还能继续产生普通文本。最小读取流程因此是“先判断,再推进”:

csharp
if (story.canContinue)
{
    string line = story.Continue();
}

这段是片段示例,依赖前文已经创建好的 story。它不会产生独立控制台输出,但生效行为很明确:只有存在下一段文本时才调用 Continue()。

不要把 currentText 当成“下一行”的读取 API。currentText 反映的是 Story 最近一次继续执行后得到的当前文本;如果还没有调用 Continue(),它并不会替你向前推进剧情。

把最小读取接到真实对话按钮

当你从控制台验证迁移到 UI 时,建议把“推进一次”封装成独立方法。每次按钮点击只调用一次,便于后续插入打字机效果、标签解析和选项处理。

csharp
public string ReadNextLine()
{
    if (story == null || !story.canContinue)
    {
        return null;
    }

    return story.Continue().TrimEnd();
}

这也是片段示例,依赖类中的 story 字段。调用成功时返回下一行文本;没有可继续内容时返回 null,调用方据此决定隐藏“继续”按钮或转入结束处理。

最小 Story 驱动链路并不复杂:用编译后的 JSON 创建 Story,读取前检查 canContinue,再用 Continue() 取得文本并推进状态。把这三个动作分清楚,后续连续台词、选项和分支都可以在同一个运行时循环上扩展。

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

目录与阅读设置

阅读设置

17

记录一个想法

从 Story 读取一行台词

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

登录哪都通