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

点击选项后继续剧情

点击选项后继续剧情

显示选项只是交互链路的一半。玩家点击按钮后,需要把对应索引交给 Ink,再持续调用 Continue() 读取新文本,最后重新刷新下一批选项。本节把选择、推进和 UI 刷新串成一次完整且可重复执行的对话循环。

学习目标

  • 使用 ChooseChoiceIndex 提交玩家选择
  • 在选择后通过 canContinue 与 Continue() 推进剧情
  • 按正确顺序刷新正文和下一轮选择,避免重复点击或旧按钮残留

一次点击包含四个动作

按钮点击后不能只调用 ChooseChoiceIndex。这个方法负责告诉 Ink “玩家选择了哪一项”,但新的剧情内容仍需要继续读取。典型顺序是:禁用旧选项、提交选择、读取后续正文、重新读取 currentChoices 并渲染。

Unity 点击 Ink 选项后的完整交互链路

把选择和推进封装在控制器中

下面示例使用 UGUI,将 Story、正文文本和选项按钮统一放在一个控制器里。场景中需要把编译后的 Ink JSON 作为 TextAsset 赋给 inkJsonAsset,并准备按钮预制体和选项容器。

csharp
using Ink.Runtime;
using UnityEngine;
using UnityEngine.UI;

public sealed class DialogueController : MonoBehaviour
{
    [SerializeField] private TextAsset inkJsonAsset;
    [SerializeField] private Text dialogueText;
    [SerializeField] private Transform choiceRoot;
    [SerializeField] private Button choiceButtonPrefab;

    private Story story;

    private void Start()
    {
        story = new Story(inkJsonAsset.text);
        ContinueStory();
    }

    private void ContinueStory()
    {
        ClearChoices();

        // 一次推进可能连续产生多行正文,因此读取到下一个选择点或故事结束。
        while (story.canContinue)
        {
            string line = story.Continue().Trim();
            if (!string.IsNullOrEmpty(line))
            {
                dialogueText.text = line;
            }
        }

        RenderChoices();
    }

    private void RenderChoices()
    {
        foreach (Choice choice in story.currentChoices)
        {
            Button button = Instantiate(choiceButtonPrefab, choiceRoot);
            button.GetComponentInChildren<Text>().text = choice.text.Trim();

            int choiceIndex = choice.index;
            button.onClick.AddListener(() => SelectChoice(choiceIndex));
        }
    }

    private void SelectChoice(int choiceIndex)
    {
        SetChoicesInteractable(false);
        story.ChooseChoiceIndex(choiceIndex);
        ContinueStory();
    }

    private void SetChoicesInteractable(bool interactable)
    {
        foreach (Button button in choiceRoot.GetComponentsInChildren<Button>())
        {
            button.interactable = interactable;
        }
    }

    private void ClearChoices()
    {
        for (int i = choiceRoot.childCount - 1; i >= 0; i--)
        {
            Destroy(choiceRoot.GetChild(i).gameObject);
        }
    }
}

预期结果:进入选择点后显示对应按钮;点击其中一个按钮时,旧按钮立即不可交互,Ink 接收该选项并继续执行,正文更新到选择后的内容,随后界面显示新的选择项。具体文本取决于当前 Ink 剧情。

text
进入选择点 -> 显示当前选项
点击某个选项 -> ChooseChoiceIndex(index)
读取后续剧情 -> Continue()
到达下一个选择点 -> 刷新按钮

为什么要循环调用 Continue

Continue() 每次读取 Story 当前可继续的一段内容,而 canContinue 表示当前是否仍有可读取内容。一次选择后可能连续产生多段 Ink 文本,因此只调用一次 Continue() 很容易漏掉后续内容。

示例为了突出交互链路,只把最后一个非空文本写入 dialogueText。真实对话系统通常会把每次 Continue() 得到的文本追加到消息列表,或者逐条交给打字机动画播放。无论采用哪种展示方式,都应在需要玩家再次选择时停止自动推进。

防止重复点击和索引捕获错误

按钮点击后立即禁用当前选项,可以避免同一帧或动画期间重复提交选择。即使下一步很快就会销毁旧按钮,这层保护仍然值得保留,尤其是在移动端连续点击或界面存在过渡动画时。

创建监听器时还要把 choice.index 复制到局部变量 choiceIndex,再让回调捕获这个值。这样每个按钮都明确绑定自己的 Ink 索引,代码意图也比在回调执行时重新查找列表位置更清楚。

如果 UI 会重新排序选项,不要把 Transform 的 sibling index 当成 Ink 选择索引。最终传给 ChooseChoiceIndex 的值应该来自创建按钮时对应的 Choice.index。

判断故事结束

当 story.canContinue 为 false 且 story.currentChoices.Count 为 0 时,当前 Story 已没有可继续文本和可选分支。此时可以关闭对话框、显示结束状态,或把控制权交还游戏流程。

可以在 ContinueStory 末尾加入一个明确检查;下面是片段示例,可直接放在 RenderChoices() 之后。

csharp
if (!story.canContinue && story.currentChoices.Count == 0)
{
    Debug.Log("Story finished.");
}

预期输出:当 Story 真正执行到末尾且没有任何选项时,Unity Console 出现一次结束提示。

text
Story finished.

完整交互链路的关键不是某一个 API,而是调用顺序:提交当前选择后推进 Story,推进结束后再根据 Story 的最新状态刷新界面。只要 UI 始终从当前 Story 状态重新构建,就不会把已经失效的选择带到下一轮对话中。

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

目录与阅读设置

阅读设置

17

记录一个想法

点击选项后继续剧情

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

登录哪都通