游戏叙事与剧情 / 系统课时
让 Unity 运行第一段对话
让 Unity 运行第一段对话
这一节只完成一件事:把一个已经能被 Unity 导入的 Ink 剧情资源交给运行时 Story,在进入 Play 模式后把对白输出到 Console。完成后,你会拥有一条最小但真实可验证的 Ink → Unity 运行链路。
学习目标
- 理解
InkFile、Story与Continue()各自负责什么 - 在 Unity 场景中绑定剧情资源并运行第一段对白
- 能根据 Console 输出判断“已编译”和“已运行”是否都成功
准备一段最小剧情
先准备一个独立的 .ink 文件,例如 first-dialogue.ink。内容保持简单,先不要加入变量和分支,目的是缩短第一次联调的排错范围。
text
守卫:站住,你是谁?
旅人:只是路过。
-> END这段内容本身不是 C# 程序;保存后由 Ink 的 Unity 集成导入并编译。下面按 Ink for Unity 2.x 的 InkFile 资源写法接入,运行时读取的是该资源中的已编译 Story JSON,而不是直接解释 .ink 源文本。
把剧情资源交给 Story
新建 FirstInkDialogue.cs,挂到场景中的一个 GameObject 上。脚本只做三件事:检查资源、创建 Story、持续读取到剧情暂停或结束。
csharp
using Ink.Runtime;
using Ink.UnityIntegration;
using UnityEngine;
public sealed class FirstInkDialogue : MonoBehaviour
{
[SerializeField] private InkFile inkFile;
private Story story;
private void Start()
{
if (inkFile == null)
{
Debug.LogError("InkFile 未绑定。");
return;
}
// Story 持有本次运行的剧情状态;不要每读一行就重新创建。
story = new Story(inkFile.storyJson);
RunUntilStop();
}
private void RunUntilStop()
{
while (story.canContinue)
{
string line = story.Continue().Trim();
if (!string.IsNullOrEmpty(line))
{
Debug.Log($"Ink> {line}");
}
}
if (story.currentChoices.Count == 0)
{
Debug.Log("Ink> [END]");
}
}
}预期输出
text
Ink> 守卫:站住,你是谁?
Ink> 旅人:只是路过。
Ink> [END]如果 Console 中出现这三行,说明资源已经成功导入,Story 也成功读取了编译结果。这里只验证最短链路,因此暂时不处理选项;当 currentChoices 非空时,后续再把选择交给 UI。
在场景里完成绑定
- 在场景中新建一个空 GameObject,并挂载
FirstInkDialogue。 - 把项目中的
first-dialogue.ink资源拖到组件的Ink File字段。 - 进入 Play 模式,观察 Console 是否出现两句对白和
[END]。 - 如果字段为空,先解决资源绑定;如果创建
Story时就报错,先回到 Ink 的编译错误,而不是继续排查 UI。

这里最容易混淆的是“资源”和“运行状态”。InkFile 保存可供运行时读取的编译结果,而 Story 是本次游戏运行中的状态机实例;同一个剧情资源可以创建新的 Story,但已经创建的实例不会因为你重新拖拽资源而自动重置。第一次联调只要把这条边界看清,后面的选项、变量和存档都能建立在同一条链路上。
按自己的节奏,确认真正理解。