游戏叙事与剧情 / 系统课时
处理多选项与动态刷新
处理多选项与动态刷新
这一节解决选项数量不固定时最容易出现的问题:旧按钮残留、监听器重复、索引错位和频繁创建对象。目标是让 UI 能根据 Story.currentChoices 动态显示 0~N 个按钮,并在玩家选择后安全回收旧状态,再刷新下一轮选项。
学习目标
- 根据
Story.currentChoices的实际数量动态生成选项 - 复用按钮并重置监听器,避免重复点击和对象抖动
- 在选择后按正确顺序更新 Story,再刷新下一轮 UI
多选项刷新真正难在哪里
Ink 的选项数会随剧情条件变化,同一个节点可能这次出现 3 个选项,下次只出现 1 个。UI 因此不能预设固定按钮数量,而应把每次刷新都当成一次完整状态替换:旧按钮先失活或回收,再用当前 Choice 列表重新绑定文本和点击事件。

如果每次刷新都 Instantiate 再 Destroy,逻辑上可以工作,但在高频对话、移动端或带动画的按钮上会产生不必要的分配和销毁。一个简单对象池就足够解决这类 UI 的复用问题。
用按钮池承载 0 到 N 个选项
下面的脚本把按钮实例保存在 buttonPool。当新一轮选项更多时才补建按钮;更少时把多余按钮设为不可见。每次复用按钮之前先清空旧监听器,避免一次点击触发多条历史回调。
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);
}
}
}预期结果
传入 3 个选项:首次创建 3 个按钮并全部显示。
随后传入 1 个选项:复用第 1 个按钮,其余 2 个按钮隐藏,不再创建新对象。
再次传入 3 个选项:直接复用池中的 3 个按钮,并按当前选项重新绑定文本与点击事件。这是一个可直接挂到 Unity 对象上的视图组件,但它本身不推进剧情。上面的预期结果描述的是池容量与可见状态,具体按钮文本仍由传入的 Choice 决定。
把选择动作接回 Story
剧情控制器只需要把当前选项交给 ChoiceListView,点击回调里调用 ChooseChoiceIndex,然后再推进下一段剧情。这里不缓存 Choice 对象本身,只缓存玩家点击时需要的索引,减少状态不同步的机会。
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();
}
}
}预期结果
当前节点有 3 个选项时显示 3 个按钮。
进入下一节点只剩 1 个选项时,只保留 1 个可见按钮,其余池中按钮被隐藏。
重复刷新同一按钮不会累积旧监听器;每次点击只调用一次 ChooseChoiceIndex。
当当前节点没有选项时,所有选项按钮都隐藏,可通过继续操作推进文本。具体按钮文字和选项数量由 Ink 剧情决定,实际运行结果会随 Story 状态变化。
防止索引和监听器错位
最常见的错误是直接在循环闭包里使用会继续变化的循环变量,或者忘记清空按钮的旧监听器。示例通过 int choiceIndex = i 固定本次按钮索引,并在重新绑定前执行 RemoveAllListeners(),这样按钮复用多少次都只保留当前轮回调。
什么时候需要更完整的对象池
如果选项按钮还包含进入动画、图标、倒计时或手柄焦点,建议把“激活、绑定、取消绑定、回收”封装到单独的 ChoiceButtonView 中;但对于普通文本选项,以上轻量池已经足够。关键不是池本身,而是每轮刷新都把可见数量、文本、索引和监听器视为一组不可分割的 UI 状态。