游戏 AI / 系统课时

设计异步请求避免阻塞主线程

设计异步请求避免阻塞主线程

NPC 回复可能需要数百毫秒甚至数秒。若在游戏主线程同步等待模型接口,输入、动画与渲染都会停顿。本课用 Unity 可运行脚本模拟异步请求,并加入主动取消和请求版本检查,确保旧回复不会覆盖当前对话。

学习目标

  • 解释主线程发起请求、异步等待与主线程提交结果的边界。
  • 在 Unity 中实现不阻塞每帧更新的 NPC 回复和取消操作。
  • 验证切换场景、连续发送及超时时不会显示过期台词。

主线程只发起请求和提交结果

一次 NPC 对话可以拆成三个阶段:主线程读取玩家输入并显示“请求中”;网络 I/O 异步等待后端回应;返回时回到主线程,确认 NPC 仍有效、请求未取消,再更新台词。await 在等待异步任务时交还执行权,不等于把 Unity 对象操作交给工作线程。

每个 NPC 会话保持一个进行中的请求和一个递增的 generation。玩家关闭对话或发送新消息时,先取消旧任务并递增版本。即便底层网络请求无法及时取消,迟到回复也会因版本不一致而被丢弃。

NPC异步请求与取消返回主线程的时序

在 Unity 中运行一个可取消的回复

创建 NpcAsyncDemo.cs,挂到启用的 GameObject 上,进入 Play Mode。下面用 Task.Delay 模拟后端延迟,因此无需 API 密钥或真实服务器。示例使用旧版 Input Manager;项目的 Active Input Handling 需设为 Input Manager 或 Both。

csharp
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 毫秒后出现第二行。

text
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,分别运行三种操作:

  1. 按 Enter 后继续移动或播放动画,确认帧循环没有因为等待而停顿。
  2. 按 Enter,立即按 Esc,或禁用挂载脚本的 GameObject,确认没有迟到台词。
  3. 连续按 Enter 两次,确认只有最新请求可以落地;之后再切换 NPC,检查旧会话回复不会显示在新会话面板。

异步请求的验收标准是:主线程持续响应输入和渲染;只有当前会话、当前版本且未取消的结果能够更新 NPC 台词。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计异步请求避免阻塞主线程

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

登录哪都通