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

处理多选项与动态刷新

处理多选项与动态刷新

这一节解决选项数量不固定时最容易出现的问题:旧按钮残留、监听器重复、索引错位和频繁创建对象。目标是让 UI 能根据 Story.currentChoices 动态显示 0~N 个按钮,并在玩家选择后安全回收旧状态,再刷新下一轮选项。

学习目标

  • 根据 Story.currentChoices 的实际数量动态生成选项
  • 复用按钮并重置监听器,避免重复点击和对象抖动
  • 在选择后按正确顺序更新 Story,再刷新下一轮 UI

多选项刷新真正难在哪里

Ink 的选项数会随剧情条件变化,同一个节点可能这次出现 3 个选项,下次只出现 1 个。UI 因此不能预设固定按钮数量,而应把每次刷新都当成一次完整状态替换:旧按钮先失活或回收,再用当前 Choice 列表重新绑定文本和点击事件。

动态选项刷新流程

如果每次刷新都 Instantiate 再 Destroy,逻辑上可以工作,但在高频对话、移动端或带动画的按钮上会产生不必要的分配和销毁。一个简单对象池就足够解决这类 UI 的复用问题。

用按钮池承载 0 到 N 个选项

下面的脚本把按钮实例保存在 buttonPool。当新一轮选项更多时才补建按钮;更少时把多余按钮设为不可见。每次复用按钮之前先清空旧监听器,避免一次点击触发多条历史回调。

csharp
using System.Collections.Generic;
using Ink.Runtime;
using TMPro;
using UnityEngine;
using UnityEngine.UI;

public sealed class ChoiceListView : MonoBehaviour
{
    [SerializeField] private Transform choiceRoot;
    [SerializeField] private Button choiceButtonPrefab;

    private readonly List<Button> buttonPool = new();

    public void Render(IReadOnlyList<Choice> choices, System.Action<int> onSelected)
    {
        EnsureCapacity(choices.Count);

        for (int i = 0; i < buttonPool.Count; i++)
        {
            Button button = buttonPool[i];

            if (i >= choices.Count)
            {
                button.gameObject.SetActive(false);
                continue;
            }

            int choiceIndex = i;
            button.gameObject.SetActive(true);
            button.GetComponentInChildren<TMP_Text>().text = choices[i].text.Trim();

            // 复用前先移除旧回调,防止重复选择同一分支。
            button.onClick.RemoveAllListeners();
            button.onClick.AddListener(() => onSelected(choiceIndex));
        }
    }

    private void EnsureCapacity(int required)
    {
        while (buttonPool.Count < required)
        {
            Button button = Instantiate(choiceButtonPrefab, choiceRoot);
            buttonPool.Add(button);
        }
    }
}

预期结果

text
传入 3 个选项:首次创建 3 个按钮并全部显示。
随后传入 1 个选项:复用第 1 个按钮,其余 2 个按钮隐藏,不再创建新对象。
再次传入 3 个选项:直接复用池中的 3 个按钮,并按当前选项重新绑定文本与点击事件。

这是一个可直接挂到 Unity 对象上的视图组件,但它本身不推进剧情。上面的预期结果描述的是池容量与可见状态,具体按钮文本仍由传入的 Choice 决定。

把选择动作接回 Story

剧情控制器只需要把当前选项交给 ChoiceListView,点击回调里调用 ChooseChoiceIndex,然后再推进下一段剧情。这里不缓存 Choice 对象本身,只缓存玩家点击时需要的索引,减少状态不同步的机会。

csharp
using Ink.Runtime;
using TMPro;
using UnityEngine;

public sealed class InkDialoguePresenter : MonoBehaviour
{
    [SerializeField] private TextAsset inkJsonAsset;
    [SerializeField] private TMP_Text bodyText;
    [SerializeField] private ChoiceListView choiceListView;

    private Story story;

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

    private void Advance()
    {
        if (story.canContinue)
        {
            bodyText.text = story.Continue().Trim();
        }

        choiceListView.Render(story.currentChoices, SelectChoice);
    }

    private void SelectChoice(int index)
    {
        story.ChooseChoiceIndex(index);
        Advance();
    }

    public void ContinueWithoutChoice()
    {
        if (story.currentChoices.Count == 0)
        {
            Advance();
        }
    }
}

预期结果

text
当前节点有 3 个选项时显示 3 个按钮。
进入下一节点只剩 1 个选项时,只保留 1 个可见按钮,其余池中按钮被隐藏。
重复刷新同一按钮不会累积旧监听器;每次点击只调用一次 ChooseChoiceIndex。
当当前节点没有选项时,所有选项按钮都隐藏,可通过继续操作推进文本。

具体按钮文字和选项数量由 Ink 剧情决定,实际运行结果会随 Story 状态变化。

防止索引和监听器错位

最常见的错误是直接在循环闭包里使用会继续变化的循环变量,或者忘记清空按钮的旧监听器。示例通过 int choiceIndex = i 固定本次按钮索引,并在重新绑定前执行 RemoveAllListeners(),这样按钮复用多少次都只保留当前轮回调。

什么时候需要更完整的对象池

如果选项按钮还包含进入动画、图标、倒计时或手柄焦点,建议把“激活、绑定、取消绑定、回收”封装到单独的 ChoiceButtonView 中;但对于普通文本选项,以上轻量池已经足够。关键不是池本身,而是每轮刷新都把可见数量、文本、索引和监听器视为一组不可分割的 UI 状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理多选项与动态刷新

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

登录哪都通