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

台词正常但选项不出现

台词正常但选项不出现

台词能显示而按钮为空,通常说明 Ink 已经运行起来,但“推进故事、读取 currentChoices、创建按钮”之间有一步断开。排查重点不是重编剧情,而是确认选择生成时机和 UI 刷新顺序。

学习目标

  • 理解 canContinue、Continue() 与 currentChoices 的正确读取时机。
  • 能用运行时状态区分“Ink 没生成选项”和“Unity 没显示选项”。
  • 能实现一次完整的选项创建、点击、继续剧情闭环。

先确认选择是否已经生成

Ink 的典型循环分两段:先在 canContinue 为 true 时持续调用 Continue() 消费可输出文本;当不能继续自动推进时,再读取 currentChoices。如果只调用一次 Continue() 就立即查选项,故事可能还没走到 choice 边界。

Ink 台词与选项的运行时交互时序

因此最关键的诊断值只有两个:story.canContinue 和 story.currentChoices.Count。当 canContinue 仍为 true 时选项为空,先继续推进;当它为 false 且选项数量大于 0 时,Ink 已经完成自己的工作,问题应转向 Unity UI。

用一条最小剧情验证状态

先用最简单的 Ink 内容排除条件表达式、存档状态和复杂跳转。下面的内容是测试剧情源文件,在第一句台词之后会产生两个可见选项:

ink
你走到岔路口。
* [向左走]
    你走进树林。
    -> END
* [向右走]
    你看见河流。
    -> END

这段源文件由 Ink 编译后交给运行时执行。如果它在 Ink Player 中能看到两个选项,而游戏界面看不到,说明剧情定义本身不是首要嫌疑。此时应在 Unity 中直接观察运行时选择数量,不要继续盲改 Ink 文件。

把读取和 UI 刷新放在同一个闭环

下面以 Ink Unity Integration 2.x、TextMeshPro 和 Unity UI 为例。脚本会先消费当前段落,再根据 currentChoices 创建按钮;点击按钮后用对应索引调用 ChooseChoiceIndex,然后重新刷新。

csharp
using System.Text;
using Ink.Runtime;
using Ink.UnityIntegration;
using TMPro;
using UnityEngine;
using UnityEngine.UI;

public sealed class InkChoiceView : MonoBehaviour
{
    [SerializeField] private InkFile inkFile;
    [SerializeField] private TMP_Text dialogueText;
    [SerializeField] private Transform choicesRoot;
    [SerializeField] private Button choiceButtonPrefab;

    private Story story;

    private void Start()
    {
        if (inkFile == null || dialogueText == null ||
            choicesRoot == null || choiceButtonPrefab == null)
        {
            Debug.LogError("InkChoiceView references are incomplete.");
            enabled = false;
            return;
        }

        story = new Story(inkFile.storyJson);
        Refresh();
    }

    private void Refresh()
    {
        ClearChoices();

        var buffer = new StringBuilder();
        while (story.canContinue)
        {
            string line = story.Continue().Trim();
            if (line.Length > 0)
            {
                buffer.AppendLine(line);
            }
        }

        dialogueText.text = buffer.ToString().TrimEnd();

        for (int i = 0; i < story.currentChoices.Count; i++)
        {
            Choice choice = story.currentChoices[i];
            Button button = Instantiate(choiceButtonPrefab, choicesRoot);
            TMP_Text label = button.GetComponentInChildren<TMP_Text>();

            if (label == null)
            {
                Debug.LogError("Choice button prefab has no TMP_Text label.");
                Destroy(button.gameObject);
                continue;
            }

            label.text = choice.text;

            int choiceIndex = i;
            button.onClick.AddListener(() =>
            {
                story.ChooseChoiceIndex(choiceIndex);
                Refresh();
            });
        }

        Debug.Log(
            $"canContinue={story.canContinue}, choices={story.currentChoices.Count}"
        );
    }

    private void ClearChoices()
    {
        for (int i = choicesRoot.childCount - 1; i >= 0; i--)
        {
            GameObject child = choicesRoot.GetChild(i).gameObject;
            child.SetActive(false);
            Destroy(child);
        }
    }
}

预期结果:

text
台词:
你走到岔路口。

按钮:
向左走
向右走

Console:
canContinue=False, choices=2

点击“向左走”后,ChooseChoiceIndex(0) 会推进到对应分支,再次刷新时台词应变成“你走进树林。”,此时故事已经到达结尾,因此选择数量会变成 0。

按状态组合定位断链

如果 canContinue=true 且 choices=0,说明故事还存在未消费文本,继续调用 Continue(),直到自动推进停止。如果 canContinue=false 且 choices>0,Ink 已经生成选项,检查 Prefab、父容器、布局、Canvas 层级以及刷新函数是否真的创建了按钮。

如果 canContinue=false 且 choices=0,再回到剧情状态检查:当前路径可能本来就没有 choice,条件可能把所有 choice 过滤掉,或者加载的存档已经走过一次性选择。此时应先在 Ink Player 中用同一剧情状态复现,而不是把问题归咎于按钮代码。

点击后不推进时检查索引

按钮已经出现但点击后没反应,重点看监听器是否最终调用了 ChooseChoiceIndex,以及传入索引是否仍对应创建按钮时的 choice。示例中把循环变量复制到 choiceIndex,就是为了让每个按钮持有自己的索引。

同时确认按钮没有被透明的 UI 层遮挡、interactable 没被关闭,并且点击后确实重新执行了 Refresh()。只要形成“读文本 → 显示 choices → 选择索引 → 再读文本”的闭环,台词正常却没有选项的问题就能被明确定位在 Story 状态或 UI 刷新其中一侧。

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

目录与阅读设置

阅读设置

17

记录一个想法

台词正常但选项不出现

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

登录哪都通