游戏叙事与剧情 / 系统课时
对话框如何等待玩家输入
对话框如何等待玩家输入
对话系统真正困难的不是“把文字画出来”,而是让剧情执行在需要玩家选择时暂停,同时不阻塞主线程;当按钮点击到达后,再从原来的节点继续。实现这一点的关键,是把“等待输入”建模成显式状态和可恢复的异步等待点。
学习目标
- 理解对话执行器为什么不能用死循环等待按钮状态
- 用异步等待保存“当前暂停在哪里、正在等什么”
- 处理重复点击、非法输入和恢复执行的边界
等待输入不是卡住线程
游戏主循环仍要继续渲染、播放动画和处理输入,因此对话执行器不能写成“没有选择就一直循环检查”。正确做法是:节点执行到选项时,把界面切到等待态,并返回一个尚未完成的异步任务;玩家点击后,由输入事件完成这个任务,剧情协程再继续。

可以把一次等待理解为“先登记一个未来结果,再把控制权交回引擎”。当玩家选择后,这个未来结果被填写,原来的执行链自然恢复。
用状态和异步结果保存暂停点
下面的 C# 示例不依赖游戏引擎,直接演示一个可暂停、可恢复的对话节点。真实项目中,ShowChoices 可以替换成 Unity、Godot 或自研 UI 的按钮绑定逻辑。
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("对话节点完成");
}
}预期输出:
旁白:你来到岔路口。
[0] 进入森林
[1] 返回村庄
等待玩家输入...
玩家选择:1
继续执行:branch-village
对话节点完成这里最重要的是 RunNodeAsync 在 await WaitForChoiceAsync() 处暂停,但线程并没有被占住。SubmitChoice 是唯一恢复入口,它先检查当前状态和选项范围,再尝试完成等待任务,因此按钮重复点击不会让同一个等待点继续两次。
UI 层只负责提交结果
剧情执行器最好不要直接读取按钮组件,也不要让按钮自己修改剧情节点。更稳定的职责划分是:Runner 决定何时等待、等待哪种输入;UI 只负责展示;输入回调只把结果提交给 Runner。
如果一个对话节点包含文本、选项和后续跳转,执行顺序通常是:
- Runner 进入节点并发送文本数据给 UI。
- UI 完成展示后,Runner 创建等待对象并进入
WaitingForChoice。 - 玩家点击按钮,UI 回调调用
SubmitChoice。 - Runner 校验输入并恢复原执行链。
- 当前节点完成,Runner 再进入下一个节点。
这种分层让自动测试也更容易:测试代码可以直接调用 SubmitChoice(1),不需要真的创建按钮和鼠标事件。
必须处理的几个边界
等待状态至少要考虑三类异常。第一类是重复点击:第一次成功后立即离开等待态,后续点击返回 false。第二类是输入越界:节点只有两个选项时,不能接受索引 2。第三类是页面被关闭或剧情被取消:生产代码应在等待对象上增加取消机制,例如 CancellationToken,避免界面销毁后任务永久悬挂。
把等待点当成执行边界
当剧情系统后续接入打字机动画、语音播放、网络确认或任务完成条件时,都可以复用同一种模型:执行器发起一个异步动作,进入明确的等待状态,事件到达后恢复。只要“谁负责等待、谁负责提交结果、何时允许恢复”三件事边界清楚,对话流程就能暂停而不失控。