游戏 AI / 系统课时
设计异步请求避免阻塞主线程
设计异步请求避免阻塞主线程
NPC 回复可能需要数百毫秒甚至数秒。若在游戏主线程同步等待模型接口,输入、动画与渲染都会停顿。本课用 Unity 可运行脚本模拟异步请求,并加入主动取消和请求版本检查,确保旧回复不会覆盖当前对话。
学习目标
- 解释主线程发起请求、异步等待与主线程提交结果的边界。
- 在 Unity 中实现不阻塞每帧更新的 NPC 回复和取消操作。
- 验证切换场景、连续发送及超时时不会显示过期台词。
主线程只发起请求和提交结果
一次 NPC 对话可以拆成三个阶段:主线程读取玩家输入并显示“请求中”;网络 I/O 异步等待后端回应;返回时回到主线程,确认 NPC 仍有效、请求未取消,再更新台词。await 在等待异步任务时交还执行权,不等于把 Unity 对象操作交给工作线程。
每个 NPC 会话保持一个进行中的请求和一个递增的 generation。玩家关闭对话或发送新消息时,先取消旧任务并递增版本。即便底层网络请求无法及时取消,迟到回复也会因版本不一致而被丢弃。

在 Unity 中运行一个可取消的回复
创建 NpcAsyncDemo.cs,挂到启用的 GameObject 上,进入 Play Mode。下面用 Task.Delay 模拟后端延迟,因此无需 API 密钥或真实服务器。示例使用旧版 Input Manager;项目的 Active Input Handling 需设为 Input Manager 或 Both。
using System;
using System.Threading;
using System.Threading.Tasks;
using UnityEngine;
public sealed class NpcAsyncDemo : MonoBehaviour
{
private CancellationTokenSource pending;
private int generation;
private void Update()
{
if (Input.GetKeyDown(KeyCode.Return)) StartRequest();
if (Input.GetKeyDown(KeyCode.Escape)) CancelRequest();
}
private void StartRequest()
{
CancelRequest();
var cts = new CancellationTokenSource();
pending = cts;
_ = CompleteAsync(generation, cts);
}
private async Task CompleteAsync(int requestGeneration, CancellationTokenSource cts)
{
try
{
Debug.Log("NPC:请求中");
// 只模拟异步网络等待;await 不阻塞后续 Update。
await Task.Delay(300, cts.Token);
// 从主线程启动时,默认捕获 Unity 同步上下文再更新对象。
if (requestGeneration != generation || cts.IsCancellationRequested || !isActiveAndEnabled)
return;
Debug.Log("NPC:旅人,欢迎。");
}
catch (OperationCanceledException)
{
// 用户取消属于正常结束,不显示错误回复。
}
catch (Exception ex)
{
if (requestGeneration == generation && isActiveAndEnabled)
Debug.LogError("NPC 请求失败:" + ex.Message);
}
finally
{
if (ReferenceEquals(pending, cts)) pending = null;
cts.Dispose();
}
}
private void CancelRequest()
{
generation++;
pending?.Cancel();
pending = null;
}
private void OnDisable() => CancelRequest();
}预期输出:在 Unity Console 中按一次 Enter,先出现第一行,约 300 毫秒后出现第二行。
NPC:请求中
NPC:旅人,欢迎。如果在 300 毫秒内按 Esc,控制台只出现“NPC:请求中”,不会补上回复。连续快速按两次 Enter 时可以出现两次“请求中”,但旧任务被取消,仅最新一次可以输出回复。等待期间仍能执行其他 Update、播放动画和渲染画面。
从模拟延迟接到真实后端
把 Task.Delay 替换为可传入 CancellationToken 的异步 HTTP 请求,例如基于 HttpClient.SendAsync 的请求封装。客户端只请求可信游戏后端,由后端持有模型 API 密钥、读取权威事实并校验动作意图;模型响应不能直接修改任务、背包或关系状态。
如果在 Unity 主线程调用异步方法,默认的 await 会捕获当前同步上下文,完成后才安全访问 Unity UI。若第三方 SDK 在工作线程执行回调,必须通过主线程调度器转交结果,不可直接改 GameObject、Text 或动画组件,也不要为了“异步”用 Task.Run 包装同步阻塞网络调用。
生产请求还应设置合理超时,例如 8 秒,并把用户取消与超时分开处理:用户关闭界面不弹错误;超时显示可重试提示;服务端返回失败则记录请求标识和错误类型,但不要记录密钥和完整敏感对话。
验收旧响应保护
测试时保留 Console,分别运行三种操作:
- 按 Enter 后继续移动或播放动画,确认帧循环没有因为等待而停顿。
- 按 Enter,立即按 Esc,或禁用挂载脚本的 GameObject,确认没有迟到台词。
- 连续按 Enter 两次,确认只有最新请求可以落地;之后再切换 NPC,检查旧会话回复不会显示在新会话面板。
异步请求的验收标准是:主线程持续响应输入和渲染;只有当前会话、当前版本且未取消的结果能够更新 NPC 台词。