游戏叙事与剧情 / 系统课时
处理连续台词与结束状态
处理连续台词与结束状态
真实对话不会只读一行。你需要持续判断 Story 是否还能产出文本,在每次玩家推进时读取下一行,并在 canContinue 变为 false 后区分“故事真正结束”与“接下来存在选项”。这一节先建立不会越读的连续台词循环。
学习目标
- 连续调用
Continue()读取当前路径上的多行文本。 - 在每次推进前检查
canContinue,避免故事结束后继续读取。 - 用
currentChoices区分“文本暂时读完”和“故事完全结束”。
连续读取的状态判断
Ink 的运行时并不是“文件还有没有下一行”这么简单。当前路径可能处于三种常见状态:还能继续文本、文本停下但有选项、既没有文本也没有选项。
因此结束判断不要只看 canContinue。当它为 false 时,还要检查 currentChoices.Count。有选项时应进入选择流程;没有选项时,才可以把当前故事视为结束。
建立按次推进循环
下面的组件每调用一次 Advance() 就处理一步:优先读一行文本;没有文本时检查选项;两者都没有时报告结束。示例暂时不展开选项 UI,只把状态打印出来。
using Ink.Runtime;
using UnityEngine;
public class InkDialogueRunner : MonoBehaviour
{
[SerializeField] private TextAsset inkJsonAsset;
private Story story;
private void Start()
{
if (inkJsonAsset == null)
{
Debug.LogError("Ink JSON Asset 未绑定。");
return;
}
story = new Story(inkJsonAsset.text);
// 为了便于验证,启动时连续推进到当前路径停止。
while (Advance())
{
}
}
private bool Advance()
{
if (story.canContinue)
{
string line = story.Continue().TrimEnd();
Debug.Log(line);
return true;
}
if (story.currentChoices.Count > 0)
{
Debug.Log($"等待选择,共 {story.currentChoices.Count} 个选项。");
return false;
}
Debug.Log("故事结束。");
return false;
}
}使用下面这段 Ink 内容验证:
阿岚:你终于来了。
守门人:前面就是旧城。
阿岚:走吧。
-> END预期输出
阿岚:你终于来了。
守门人:前面就是旧城。
阿岚:走吧。
故事结束。这里的 while 只是为了在 Console 中快速验证连续读取。在真正的对话界面里,不应在 Start() 中一次性跑完整个循环,而应由按钮、输入事件或自动播放节奏逐次调用 Advance()。
为什么 false 不一定代表结束
如果 Ink 在当前位置提供选项,canContinue 可能已经是 false,但 currentChoices 仍然有内容。例如:
守门人:你要从哪条路进去?
* [走正门]
阿岚:从正门进去。
-> END
* [绕到后门]
阿岚:我们绕路。
-> END此时继续调用 Continue() 并不能替玩家做选择。运行时应读取 story.currentChoices,展示选项,并在玩家选定后调用 ChooseChoiceIndex(index),之后再重新进入文本推进流程。
给 UI 一个明确的结束信号
实际项目中,可以把“还有文本”“等待选择”“完全结束”视为三种不同状态。即使暂时不用枚举,也应该让结束逻辑只在两个条件同时满足时触发:
bool isStoryFinished =
!story.canContinue &&
story.currentChoices.Count == 0;这是片段示例,依赖已经初始化的 story。当表达式为 true 时,当前 Story 既没有可继续文本,也没有待处理选项,此时才适合关闭对话 UI、清理角色头像或通知任务系统剧情节点已完成。
连续对话的关键不是“不断调用 Continue()”,而是每一步都先读取 Story 当前状态:能继续就读文本,有选项就等待选择,两者都没有才结束。按照这个顺序组织推进逻辑,后续加入分支、标签和 UI 动画时也不会把结束状态误判掉。