游戏 AI / 系统课时
用状态机约束对话生命周期
用状态机约束对话生命周期
玩家连续点击选项、流式文本延迟到达,或关闭对话与网络回包交错时,NPC 对话容易重复提交动作或被旧结果覆盖。这里用一轮请求状态机约束输入锁、流式展示、选项确认与结束清理,并给异步回调设置明确的验收条件。
学习目标
- 区分请求、流式展示、等待选项、执行动作与结束状态。
- 使用请求标识和状态门禁挡住迟到数据与重复点击。
- 区分界面结束和服务器动作确认,验证异常路径。
定义合法的状态转换
以玩家当前的一轮 NPC 对话为单位管理状态。Idle 允许提交新输入;提交后进入 Requesting,首次收到文本分片进入 Streaming。完整响应若含选项,就进入 WaitingChoice;没有选项则进入 Ending。合法选择使状态进入 Executing,收到服务器最终执行结果后才能收尾并回到 Idle。

WaitingChoice 并不意味着所有输入解锁:自由文本继续禁用,只有当前选项可点。Ending 负责移除加载提示、解除输入锁、释放请求资源;如果某轮从未收到文本分片,也必须允许 Requesting 直接处理完成事件。
用请求标识拦截过期事件
下面的 Node.js 示例只模拟界面控制器;actionDone 代表已收到游戏服务器的最终回执,不是模型自行确认成功。每次 start 分配不同请求标识,事件必须同时通过“标识相同”和“状态允许”两道检查。
class NpcDialogue {
constructor() {
this.state = 'Idle';
this.seq = 0;
this.requestId = null;
this.line = '';
this.choices = [];
this.pendingAction = null;
}
start() {
if (this.state !== 'Idle') return null;
// 轮次标识每次递增,迟到的旧响应不能混入新对话。
this.requestId = `turn-${++this.seq}`;
this.line = '';
this.choices = [];
this.pendingAction = null;
this.state = 'Requesting';
return this.requestId;
}
chunk(id, text) {
// 标识与状态必须同时匹配,不能只看流是否仍在传输。
if (id !== this.requestId ||
!['Requesting', 'Streaming'].includes(this.state)) return false;
this.state = 'Streaming';
this.line += text;
return true;
}
complete(id, choices = []) {
if (id !== this.requestId ||
!['Requesting', 'Streaming'].includes(this.state)) return false;
this.choices = choices;
this.state = choices.length ? 'WaitingChoice' : 'Ending';
return true;
}
choose(id, optionId) {
if (id !== this.requestId || this.state !== 'WaitingChoice' ||
!this.choices.includes(optionId)) return false;
// 进入执行态后立即禁用选项,等待服务器最终回执。
this.pendingAction = `${id}:${optionId}`;
this.state = 'Executing';
return true;
}
actionDone(id, actionId) {
if (id !== this.requestId || this.state !== 'Executing' ||
actionId !== this.pendingAction) return false;
this.state = 'Ending';
return true;
}
cancel(id) {
// 动作已送达服务器时,不允许将本地退出当作撤销。
if (id !== this.requestId ||
!['Requesting', 'Streaming', 'WaitingChoice'].includes(this.state)) return false;
this.state = 'Ending';
return true;
}
close() {
if (this.state !== 'Ending') return false;
this.state = 'Idle';
this.requestId = null;
return true;
}
}
const ui = new NpcDialogue();
const turn = ui.start();
ui.chunk(turn, '守卫:');
ui.chunk(turn, '桥已放下。');
ui.complete(turn, ['continue']);
console.log('显示', ui.state, ui.line);
console.log('首次选择', ui.choose(turn, 'continue'));
console.log('重复选择', ui.choose(turn, 'continue'));
console.log('动作完成', ui.actionDone(turn, `${turn}:continue`));
ui.close();
const cancelled = ui.start();
ui.cancel(cancelled);
ui.close();
console.log('迟到响应', ui.chunk(cancelled, '旧回复'));
console.log('可再次输入', ui.state === 'Idle');预期输出:
显示 WaitingChoice 守卫:桥已放下。
首次选择 true
重复选择 false
动作完成 true
迟到响应 false
可再次输入 true重复点击时第一次 choose 立即切换到 Executing,第二次因状态不符返回 false。结束后的旧分片即使带原请求标识,也不能改变已关闭的对话。实际接入流式 API 时,回调仍要附带请求标识,不能只依赖取消网络请求来防止迟到事件。
让游戏服务器确认动作终态
界面状态机只能减少重复触发,不能代替服务器鉴权。玩家选择后,发送当前会话、requestId、choiceId 和稳定的动作幂等键;服务器重新检查玩家身份、NPC 距离、任务条件与世界版本,再决定提交或拒绝。即使客户端重发相同请求,也应由服务器事务和唯一键保证动作只执行一次。
Executing 期间若用户退出界面或连接中断,不能把“本地关闭”当成“动作撤销”。对已送达服务器的动作,应保留幂等键,重连后查询最终结果;只有明确拒绝、成功或确认未提交,才完成对应业务收尾。模型输出的意图只是候选,不得直接充当服务器回执。
验证乱序、超时和重复提交
- 让完整响应在首个分片前到达:控制器应从
Requesting正常转入WaitingChoice或Ending。 - 连点同一选项两次:界面只放行一次,服务器同一幂等键最多产生一次世界事件。
- 在流式过程中取消并立即开始新一轮:旧请求的文本和完成事件均不得覆盖新一轮。
- 在
Executing时模拟超时:界面提示“结果待确认”,恢复连接后按原动作标识查状态,不生成新的动作标识盲目重试。
只要请求标识、合法迁移和服务器确认这三处边界都被执行,流式对话与玩家操作即使乱序,也不会让界面自行推进到未经确认的世界状态。