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

让 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。

在场景里完成绑定

  1. 在场景中新建一个空 GameObject,并挂载 FirstInkDialogue。
  2. 把项目中的 first-dialogue.ink 资源拖到组件的 Ink File 字段。
  3. 进入 Play 模式,观察 Console 是否出现两句对白和 [END]。
  4. 如果字段为空,先解决资源绑定;如果创建 Story 时就报错,先回到 Ink 的编译错误,而不是继续排查 UI。

Ink 剧情从资源到运行时输出的最小链路

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

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

目录与阅读设置

记录一个想法

让 Unity 运行第一段对话

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

登录哪都通