游戏叙事与剧情 / 系统课时
点击选项后继续剧情
点击选项后继续剧情
显示选项只是交互链路的一半。玩家点击按钮后,需要把对应索引交给 Ink,再持续调用 Continue() 读取新文本,最后重新刷新下一批选项。本节把选择、推进和 UI 刷新串成一次完整且可重复执行的对话循环。
学习目标
- 使用
ChooseChoiceIndex提交玩家选择 - 在选择后通过
canContinue与Continue()推进剧情 - 按正确顺序刷新正文和下一轮选择,避免重复点击或旧按钮残留
一次点击包含四个动作
按钮点击后不能只调用 ChooseChoiceIndex。这个方法负责告诉 Ink “玩家选择了哪一项”,但新的剧情内容仍需要继续读取。典型顺序是:禁用旧选项、提交选择、读取后续正文、重新读取 currentChoices 并渲染。

把选择和推进封装在控制器中
下面示例使用 UGUI,将 Story、正文文本和选项按钮统一放在一个控制器里。场景中需要把编译后的 Ink JSON 作为 TextAsset 赋给 inkJsonAsset,并准备按钮预制体和选项容器。
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 剧情。
进入选择点 -> 显示当前选项
点击某个选项 -> 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() 之后。
if (!story.canContinue && story.currentChoices.Count == 0)
{
Debug.Log("Story finished.");
}预期输出:当 Story 真正执行到末尾且没有任何选项时,Unity Console 出现一次结束提示。
Story finished.完整交互链路的关键不是某一个 API,而是调用顺序:提交当前选择后推进 Story,推进结束后再根据 Story 的最新状态刷新界面。只要 UI 始终从当前 Story 状态重新构建,就不会把已经失效的选择带到下一轮对话中。