游戏 AI / 系统课时

把模型请求从主线程移出去

把模型请求从主线程移出去

本篇解决模型请求耗时不稳定,导致游戏主线程卡顿、输入延迟甚至整帧停顿的问题。完成后,你可以把请求放进异步执行链,处理超时和取消,并用最小状态机管理一次生成请求的完整生命周期。

学习目标

  • 理解为什么网络模型调用不应该阻塞游戏循环
  • 用异步任务隔离请求、结果回传和主线程状态更新
  • 为请求加入超时、取消与完成状态,避免重复回调和悬挂任务

主线程只管理游戏状态

游戏主线程通常需要持续处理输入、物理、动画和渲染。如果一个模型请求要等待网络、服务端排队和模型推理,就不应该在主循环中同步等待。

模型请求与游戏主线程解耦的最小状态机

最小状态机不需要很多状态:Idle 表示没有请求,Pending 表示已经发出,Success、Failed、Timeout 和 Cancelled 表示终态。关键不是状态数量,而是保证一次请求只能从一个明确状态进入另一个允许的状态。

先定义请求对象和状态转换

游戏中常见场景是玩家点击“生成任务”。点击后只创建一个请求记录,把状态设为 Pending,然后启动异步操作。网络完成、超时或取消时,都通过统一入口推进状态。

下面使用 TypeScript 的 fetch 演示客户端侧的最小实现。示例中的 /generate 是你自己的后端接口;它负责连接具体模型服务,游戏客户端不需要绑定某一家模型 SDK。

ts
type RequestState = "idle" | "pending" | "success" | "failed" | "timeout" | "cancelled";

async function generateQuest(
  signal: AbortSignal,
  onState: (state: RequestState) => void,
): Promise<string> {
  onState("pending");

  try {
    const response = await fetch("/generate", {
      method: "POST",
      headers: { "content-type": "application/json" },
      body: JSON.stringify({ type: "quest", difficulty: 2 }),
      signal,
    });

    if (!response.ok) {
      throw new Error(`HTTP ${response.status}`);
    }

    const text = await response.text();
    onState("success");
    return text;
  } catch (error) {
    if (signal.aborted) {
      onState("cancelled");
      throw new Error("request cancelled");
    }

    onState("failed");
    throw error;
  }
}

async function main(): Promise<void> {
  const controller = new AbortController();
  const states: RequestState[] = [];

  try {
    const result = await generateQuest(controller.signal, (state) => states.push(state));
    console.log(states.join(" -> "));
    console.log(result);
  } catch (error) {
    console.log(states.join(" -> "));
    console.log(error instanceof Error ? error.message : String(error));
  }
}

void main();

预期结果

text
pending -> success
<后端实际返回的生成内容>

这里的关键点是 await 发生在异步函数内部,而不是把主游戏循环变成“等待模型返回再继续”。在真实游戏引擎中,应把类似结果通过引擎允许的主线程回调、事件或消息队列交回状态层。

超时和取消必须分开处理

超时解决的是“服务迟迟没有结果”,取消解决的是“玩家已经不需要这个结果”。两者都应该终止等待,但业务含义不同:超时通常意味着可以重试或降级,取消通常意味着直接丢弃结果。

可以用 AbortController 同时实现取消和超时控制:超时触发 abort(),手动取消也调用同一方法。这样不会留下一个已经失去用途、却还会在未来回调游戏逻辑的请求。

ts
function withTimeout(ms: number): AbortController {
  const controller = new AbortController();
  setTimeout(() => controller.abort(), ms);
  return controller;
}

async function run(): Promise<void> {
  const controller = withTimeout(3000);

  try {
    await generateQuest(controller.signal, (state) => console.log(state));
  } catch (error) {
    console.log(error instanceof Error ? error.message : String(error));
  }
}

void run();

预期结果

text
pending
cancelled
request cancelled

这里的 3000 毫秒只是示例值,实际超时应根据游戏容忍度、网络环境和后端尾延迟确定。若后端已经完成但客户端在业务上不再需要结果,也应确保回传时检查请求是否仍然有效。

防止旧请求覆盖新结果

玩家可能连续点击两次“生成”。如果第一次请求更慢,却最后才返回,就可能覆盖第二次已经显示的新任务。因此除了状态,还应给请求分配递增版本号或请求 ID。更新游戏对象前,先确认返回结果仍属于当前请求。

对于高频交互,最小原则是:主线程负责发起和提交最终状态,异步任务负责等待和网络 I/O,所有终态只提交一次。这样即使网络抖动、服务变慢或玩家取消操作,游戏循环仍能保持连续运行。

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

目录与阅读设置

阅读设置

17

记录一个想法

把模型请求从主线程移出去

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

登录哪都通