游戏 AI / 系统课时
把模型请求从主线程移出去
把模型请求从主线程移出去
本篇解决模型请求耗时不稳定,导致游戏主线程卡顿、输入延迟甚至整帧停顿的问题。完成后,你可以把请求放进异步执行链,处理超时和取消,并用最小状态机管理一次生成请求的完整生命周期。
学习目标
- 理解为什么网络模型调用不应该阻塞游戏循环
- 用异步任务隔离请求、结果回传和主线程状态更新
- 为请求加入超时、取消与完成状态,避免重复回调和悬挂任务
主线程只管理游戏状态
游戏主线程通常需要持续处理输入、物理、动画和渲染。如果一个模型请求要等待网络、服务端排队和模型推理,就不应该在主循环中同步等待。

最小状态机不需要很多状态:Idle 表示没有请求,Pending 表示已经发出,Success、Failed、Timeout 和 Cancelled 表示终态。关键不是状态数量,而是保证一次请求只能从一个明确状态进入另一个允许的状态。
先定义请求对象和状态转换
游戏中常见场景是玩家点击“生成任务”。点击后只创建一个请求记录,把状态设为 Pending,然后启动异步操作。网络完成、超时或取消时,都通过统一入口推进状态。
下面使用 TypeScript 的 fetch 演示客户端侧的最小实现。示例中的 /generate 是你自己的后端接口;它负责连接具体模型服务,游戏客户端不需要绑定某一家模型 SDK。
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();预期结果
pending -> success
<后端实际返回的生成内容>这里的关键点是 await 发生在异步函数内部,而不是把主游戏循环变成“等待模型返回再继续”。在真实游戏引擎中,应把类似结果通过引擎允许的主线程回调、事件或消息队列交回状态层。
超时和取消必须分开处理
超时解决的是“服务迟迟没有结果”,取消解决的是“玩家已经不需要这个结果”。两者都应该终止等待,但业务含义不同:超时通常意味着可以重试或降级,取消通常意味着直接丢弃结果。
可以用 AbortController 同时实现取消和超时控制:超时触发 abort(),手动取消也调用同一方法。这样不会留下一个已经失去用途、却还会在未来回调游戏逻辑的请求。
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();预期结果
pending
cancelled
request cancelled这里的 3000 毫秒只是示例值,实际超时应根据游戏容忍度、网络环境和后端尾延迟确定。若后端已经完成但客户端在业务上不再需要结果,也应确保回传时检查请求是否仍然有效。
防止旧请求覆盖新结果
玩家可能连续点击两次“生成”。如果第一次请求更慢,却最后才返回,就可能覆盖第二次已经显示的新任务。因此除了状态,还应给请求分配递增版本号或请求 ID。更新游戏对象前,先确认返回结果仍属于当前请求。
对于高频交互,最小原则是:主线程负责发起和提交最终状态,异步任务负责等待和网络 I/O,所有终态只提交一次。这样即使网络抖动、服务变慢或玩家取消操作,游戏循环仍能保持连续运行。