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

让 UI 不阻塞剧情状态机

让 UI 不阻塞剧情状态机

这一节解决连续点击导致跳行,以及动画没结束 Story 就被继续推进的时序错位。核心做法是拆开输入请求、Ink 推进和 UI 演出,用一个明确状态机保证任意时刻只有一个地方有权调用 Continue()。

学习目标

  • 区分输入、剧情推进和 UI 演出三个阶段。
  • 用状态和协程锁阻止重复推进 Story。
  • 在普通文本、选项等待和剧情结束之间正确切换状态。

真正要锁的是剧情推进权

如果按钮回调直接调用 story.Continue(),然后才启动打字机或淡入动画,快速点击就可能让第二次 Continue() 抢先执行。此时 Ink 已经进入下一句,屏幕却仍在播放上一句的表现,状态从这一刻开始错位。

更稳定的规则是:只有 Ready 能接受推进请求;真正调用 Continue() 时进入 Advancing;拿到文本后进入 Presenting;表现完成后才能重新回到 Ready。

对话推进与 UI 演出的状态机

用一个协程串起推进和演出

下面示例让 DialogueRunner 独占 Story。按钮只调用 RequestAdvance();非 Ready 状态或已有推进协程时,新的请求直接被忽略。WaitForSecondsRealtime 代表异步演出窗口,实际项目可替换为打字机、Timeline 或语音播放的真实完成条件。

csharp
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 节点返回的实际文本。若后面还有普通文本,演出结束后会重新开放“下一句”按钮:

text
state=Presenting line=<TEXT>
state=Ready

如果当前行之后出现 Ink 选项,第二行会变为 state=WaitingForChoice;如果剧情已经结束,则为 state=Ended。这两个状态都不会重新开放普通推进按钮。

输入锁要覆盖整个异步窗口

只在 Continue() 前后短暂禁用按钮不够。真正需要锁住的是从“开始推进”到“当前演出完成”的整个窗口,因为打字机、语音、角色动作和转场都可能持续更久。

示例用了两层保护:state 必须是 Ready,并且 advanceRoutine 必须为空。前者表示业务阶段,后者防止同一帧或外部代码重复启动协程。即使未来把按钮换成键盘、手柄或自动播放,这个规则仍然成立。

表现层不要反向控制 Story

UI 或动画回调不应该自己调用 Continue()。否则输入层、表现层和 Runner 都可能推进剧情,后续加入跳过、自动播放和选项 UI 时很容易形成竞态。

稳定边界是:Runner 决定何时推进 Story;表现层只执行当前行并报告完成。即使一行同时播放语音、立绘动作和转场,也应该等这些子演出收敛成一次“完成”信号,再把推进权交还给 Runner。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 UI 不阻塞剧情状态机

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

登录哪都通