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

对话框如何等待玩家输入

对话框如何等待玩家输入

对话系统真正困难的不是“把文字画出来”,而是让剧情执行在需要玩家选择时暂停,同时不阻塞主线程;当按钮点击到达后,再从原来的节点继续。实现这一点的关键,是把“等待输入”建模成显式状态和可恢复的异步等待点。

学习目标

  • 理解对话执行器为什么不能用死循环等待按钮状态
  • 用异步等待保存“当前暂停在哪里、正在等什么”
  • 处理重复点击、非法输入和恢复执行的边界

等待输入不是卡住线程

游戏主循环仍要继续渲染、播放动画和处理输入,因此对话执行器不能写成“没有选择就一直循环检查”。正确做法是:节点执行到选项时,把界面切到等待态,并返回一个尚未完成的异步任务;玩家点击后,由输入事件完成这个任务,剧情协程再继续。

对话节点等待玩家输入的时序

可以把一次等待理解为“先登记一个未来结果,再把控制权交回引擎”。当玩家选择后,这个未来结果被填写,原来的执行链自然恢复。

用状态和异步结果保存暂停点

下面的 C# 示例不依赖游戏引擎,直接演示一个可暂停、可恢复的对话节点。真实项目中,ShowChoices 可以替换成 Unity、Godot 或自研 UI 的按钮绑定逻辑。

csharp
using System;
using System.Threading.Tasks;

enum DialogueState
{
    Running,
    WaitingForChoice,
    Completed
}

sealed class DialogueRunner
{
    private DialogueState _state = DialogueState.Running;
    private TaskCompletionSource<int>? _choiceSource;

    public async Task<string> RunNodeAsync()
    {
        Console.WriteLine("旁白:你来到岔路口。");
        Console.WriteLine("[0] 进入森林");
        Console.WriteLine("[1] 返回村庄");

        int choice = await WaitForChoiceAsync();
        string nextNode = choice == 0 ? "branch-forest" : "branch-village";

        Console.WriteLine($"继续执行:{nextNode}");
        _state = DialogueState.Completed;
        return nextNode;
    }

    public bool SubmitChoice(int choiceIndex)
    {
        if (_state != DialogueState.WaitingForChoice)
        {
            return false;
        }

        if (choiceIndex is < 0 or > 1)
        {
            return false;
        }

        _state = DialogueState.Running;
        return _choiceSource!.TrySetResult(choiceIndex);
    }

    private Task<int> WaitForChoiceAsync()
    {
        _state = DialogueState.WaitingForChoice;
        _choiceSource = new TaskCompletionSource<int>(
            TaskCreationOptions.RunContinuationsAsynchronously);

        return _choiceSource.Task;
    }
}

static class Program
{
    static async Task Main()
    {
        var runner = new DialogueRunner();

        Task<string> running = runner.RunNodeAsync();
        Console.WriteLine("等待玩家输入...");

        await Task.Delay(300);
        Console.WriteLine("玩家选择:1");
        runner.SubmitChoice(1);

        await running;
        Console.WriteLine("对话节点完成");
    }
}

预期输出:

text
旁白:你来到岔路口。
[0] 进入森林
[1] 返回村庄
等待玩家输入...
玩家选择:1
继续执行:branch-village
对话节点完成

这里最重要的是 RunNodeAsync 在 await WaitForChoiceAsync() 处暂停,但线程并没有被占住。SubmitChoice 是唯一恢复入口,它先检查当前状态和选项范围,再尝试完成等待任务,因此按钮重复点击不会让同一个等待点继续两次。

UI 层只负责提交结果

剧情执行器最好不要直接读取按钮组件,也不要让按钮自己修改剧情节点。更稳定的职责划分是:Runner 决定何时等待、等待哪种输入;UI 只负责展示;输入回调只把结果提交给 Runner。

如果一个对话节点包含文本、选项和后续跳转,执行顺序通常是:

  1. Runner 进入节点并发送文本数据给 UI。
  2. UI 完成展示后,Runner 创建等待对象并进入 WaitingForChoice。
  3. 玩家点击按钮,UI 回调调用 SubmitChoice。
  4. Runner 校验输入并恢复原执行链。
  5. 当前节点完成,Runner 再进入下一个节点。

这种分层让自动测试也更容易:测试代码可以直接调用 SubmitChoice(1),不需要真的创建按钮和鼠标事件。

必须处理的几个边界

等待状态至少要考虑三类异常。第一类是重复点击:第一次成功后立即离开等待态,后续点击返回 false。第二类是输入越界:节点只有两个选项时,不能接受索引 2。第三类是页面被关闭或剧情被取消:生产代码应在等待对象上增加取消机制,例如 CancellationToken,避免界面销毁后任务永久悬挂。

把等待点当成执行边界

当剧情系统后续接入打字机动画、语音播放、网络确认或任务完成条件时,都可以复用同一种模型:执行器发起一个异步动作,进入明确的等待状态,事件到达后恢复。只要“谁负责等待、谁负责提交结果、何时允许恢复”三件事边界清楚,对话流程就能暂停而不失控。

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

目录与阅读设置

阅读设置

17

记录一个想法

对话框如何等待玩家输入

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

登录哪都通