游戏叙事与剧情 / 系统课时
让 UI 不阻塞剧情状态机
让 UI 不阻塞剧情状态机
这一节解决连续点击导致跳行,以及动画没结束 Story 就被继续推进的时序错位。核心做法是拆开输入请求、Ink 推进和 UI 演出,用一个明确状态机保证任意时刻只有一个地方有权调用 Continue()。
学习目标
- 区分输入、剧情推进和 UI 演出三个阶段。
- 用状态和协程锁阻止重复推进 Story。
- 在普通文本、选项等待和剧情结束之间正确切换状态。
真正要锁的是剧情推进权
如果按钮回调直接调用 story.Continue(),然后才启动打字机或淡入动画,快速点击就可能让第二次 Continue() 抢先执行。此时 Ink 已经进入下一句,屏幕却仍在播放上一句的表现,状态从这一刻开始错位。
更稳定的规则是:只有 Ready 能接受推进请求;真正调用 Continue() 时进入 Advancing;拿到文本后进入 Presenting;表现完成后才能重新回到 Ready。

用一个协程串起推进和演出
下面示例让 DialogueRunner 独占 Story。按钮只调用 RequestAdvance();非 Ready 状态或已有推进协程时,新的请求直接被忽略。WaitForSecondsRealtime 代表异步演出窗口,实际项目可替换为打字机、Timeline 或语音播放的真实完成条件。
using System.Collections;
using Ink.Runtime;
using UnityEngine;
using UnityEngine.UI;
public sealed class DialogueRunner : MonoBehaviour
{
private enum RunnerState
{
Ready,
Advancing,
Presenting,
WaitingForChoice,
Ended
}
[SerializeField] private TextAsset storyJson;
[SerializeField] private Text dialogueText;
[SerializeField] private Button nextButton;
[SerializeField] private Animator panelAnimator;
[SerializeField] private float showDurationSeconds = 0.35f;
private Story story;
private RunnerState state;
private Coroutine advanceRoutine;
private void Awake()
{
story = new Story(storyJson.text);
state = RunnerState.Ready;
nextButton.onClick.AddListener(RequestAdvance);
}
private void Start()
{
RequestAdvance();
}
public void RequestAdvance()
{
if (state != RunnerState.Ready || advanceRoutine != null) return;
advanceRoutine = StartCoroutine(AdvanceOnce());
}
private IEnumerator AdvanceOnce()
{
state = RunnerState.Advancing;
nextButton.interactable = false;
if (!story.canContinue)
{
MoveToStopState();
advanceRoutine = null;
yield break;
}
string line = story.Continue().Trim();
state = RunnerState.Presenting;
dialogueText.text = line;
panelAnimator.SetTrigger("Show");
Debug.Log($"state=Presenting line={line}");
// 演出完成前绝不再次推进 Story。
yield return new WaitForSecondsRealtime(showDurationSeconds);
if (story.canContinue)
{
state = RunnerState.Ready;
nextButton.interactable = true;
Debug.Log("state=Ready");
}
else
{
MoveToStopState();
}
advanceRoutine = null;
}
private void MoveToStopState()
{
nextButton.interactable = false;
if (story.currentChoices.Count > 0)
{
state = RunnerState.WaitingForChoice;
Debug.Log("state=WaitingForChoice");
}
else
{
state = RunnerState.Ended;
Debug.Log("state=Ended");
}
}
}预期输出中的 <TEXT> 是当前 Ink 节点返回的实际文本。若后面还有普通文本,演出结束后会重新开放“下一句”按钮:
state=Presenting line=<TEXT>
state=Ready如果当前行之后出现 Ink 选项,第二行会变为 state=WaitingForChoice;如果剧情已经结束,则为 state=Ended。这两个状态都不会重新开放普通推进按钮。
输入锁要覆盖整个异步窗口
只在 Continue() 前后短暂禁用按钮不够。真正需要锁住的是从“开始推进”到“当前演出完成”的整个窗口,因为打字机、语音、角色动作和转场都可能持续更久。
示例用了两层保护:state 必须是 Ready,并且 advanceRoutine 必须为空。前者表示业务阶段,后者防止同一帧或外部代码重复启动协程。即使未来把按钮换成键盘、手柄或自动播放,这个规则仍然成立。
表现层不要反向控制 Story
UI 或动画回调不应该自己调用 Continue()。否则输入层、表现层和 Runner 都可能推进剧情,后续加入跳过、自动播放和选项 UI 时很容易形成竞态。
稳定边界是:Runner 决定何时推进 Story;表现层只执行当前行并报告完成。即使一行同时播放语音、立绘动作和转场,也应该等这些子演出收敛成一次“完成”信号,再把推进权交还给 Runner。