游戏 AI / 系统课时

用状态机约束对话生命周期

用状态机约束对话生命周期

玩家连续点击选项、流式文本延迟到达,或关闭对话与网络回包交错时,NPC 对话容易重复提交动作或被旧结果覆盖。这里用一轮请求状态机约束输入锁、流式展示、选项确认与结束清理,并给异步回调设置明确的验收条件。

学习目标

  • 区分请求、流式展示、等待选项、执行动作与结束状态。
  • 使用请求标识和状态门禁挡住迟到数据与重复点击。
  • 区分界面结束和服务器动作确认,验证异常路径。

定义合法的状态转换

以玩家当前的一轮 NPC 对话为单位管理状态。Idle 允许提交新输入;提交后进入 Requesting,首次收到文本分片进入 Streaming。完整响应若含选项,就进入 WaitingChoice;没有选项则进入 Ending。合法选择使状态进入 Executing,收到服务器最终执行结果后才能收尾并回到 Idle。

NPC 对话状态转换与取消分支

WaitingChoice 并不意味着所有输入解锁:自由文本继续禁用,只有当前选项可点。Ending 负责移除加载提示、解除输入锁、释放请求资源;如果某轮从未收到文本分片,也必须允许 Requesting 直接处理完成事件。

用请求标识拦截过期事件

下面的 Node.js 示例只模拟界面控制器;actionDone 代表已收到游戏服务器的最终回执,不是模型自行确认成功。每次 start 分配不同请求标识,事件必须同时通过“标识相同”和“状态允许”两道检查。

js
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');

预期输出:

text
显示 WaitingChoice 守卫:桥已放下。
首次选择 true
重复选择 false
动作完成 true
迟到响应 false
可再次输入 true

重复点击时第一次 choose 立即切换到 Executing,第二次因状态不符返回 false。结束后的旧分片即使带原请求标识,也不能改变已关闭的对话。实际接入流式 API 时,回调仍要附带请求标识,不能只依赖取消网络请求来防止迟到事件。

让游戏服务器确认动作终态

界面状态机只能减少重复触发,不能代替服务器鉴权。玩家选择后,发送当前会话、requestId、choiceId 和稳定的动作幂等键;服务器重新检查玩家身份、NPC 距离、任务条件与世界版本,再决定提交或拒绝。即使客户端重发相同请求,也应由服务器事务和唯一键保证动作只执行一次。

Executing 期间若用户退出界面或连接中断,不能把“本地关闭”当成“动作撤销”。对已送达服务器的动作,应保留幂等键,重连后查询最终结果;只有明确拒绝、成功或确认未提交,才完成对应业务收尾。模型输出的意图只是候选,不得直接充当服务器回执。

验证乱序、超时和重复提交

  1. 让完整响应在首个分片前到达:控制器应从 Requesting 正常转入 WaitingChoice 或 Ending。
  2. 连点同一选项两次:界面只放行一次,服务器同一幂等键最多产生一次世界事件。
  3. 在流式过程中取消并立即开始新一轮:旧请求的文本和完成事件均不得覆盖新一轮。
  4. 在 Executing 时模拟超时:界面提示“结果待确认”,恢复连接后按原动作标识查状态,不生成新的动作标识盲目重试。

只要请求标识、合法迁移和服务器确认这三处边界都被执行,流式对话与玩家操作即使乱序,也不会让界面自行推进到未经确认的世界状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

用状态机约束对话生命周期

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

登录哪都通