游戏客户端架构 / 系统课时

不同引擎下哪些设计可以保持不变

不同引擎下哪些设计可以保持不变

迁移引擎时,资源引用、动画节点和求值回调往往都要重做,但角色为什么移动、谁能打断攻击,以及动作编号的含义应保持稳定。本课把这些不变规则写成可验收契约,用资源替换和旧回调测试检查迁移是否越过了职责边界。

学习目标

  • 区分稳定的业务语义与必须重新适配的引擎机制。
  • 为坐标、单位、动作编号和资源角色建立迁移约定。
  • 用相同输入和明确不变量验收替换后的实现。

能保留的是行为边界和语义

运动控制器仍然提供实际速度与接地事实,战斗逻辑仍然决定动作许可和打断,动画系统仍然负责姿态表现。迁移时不应因为新动画状态回调更方便,就把伤害、生命值或移动权限的唯一来源挪到动画节点中。

可以保持的设计 必须重新适配的实现
速度单位、角色方向坐标及参数类型 引擎坐标轴、属性名和更新阶段
业务动作优先级、取消窗口和终止规则 状态图、转场排序与中断机制
资源的逻辑角色、骨架兼容要求 文件格式、实际资源引用与导入设置
基础移动、局部动作、接触约束的职责 遮罩、加法空间和具体姿态节点
生命周期与动作编号的事件有效性 通知回调、线程及资源加载流程

保持设计不变不等于保持动画图一模一样。Unity 的状态机层、Unreal 的姿态图和 Godot 的 AnimationTree 可以承载相同需求,但相同权重数值不保证相同最终骨骼结果。迁移验收应关注腿部连续、动作时序和接触偏差,而非截图中的节点数量。

协议至少写清单位和更新来源

例如 speedMps 统一为米每秒,方向使用角色局部 X 向右、协议前向分量向前;实际引擎可使用其他世界轴。归一化与转换在适配边界只做一次。将厘米每秒直接写入同名字段,或者将世界方向冒充局部方向,接口名称虽相同,语义已经失效。

持续参数使用同一更新的快照,至少带采样编号与角色生命周期。动作开始和完成是事件,带当前动作实例编号。角色复活后生命周期递增;旧攻击结束事件不能解除新角色或新攻击的锁定。资源名称不承担这一职责,因为同一片段可能在不同动作实例中重复播放。

资源清单也应记录骨架兼容与根运动策略。迁移绑定可以更换片段,但不能无声地把原地局部攻击换成会驱动角色位移的全身片段。根运动提取与应用属于明确控制权,需要与运动系统共同修改和验收。

用不依赖引擎的契约测试迁移边界

下面的 Node.js 18 程序使用两个示例资源清单,只测试语义与引用分离,不伪装 Unity、Unreal 或 Godot 适配器。保存为 migration-contract.js 后运行;两份清单中的字符串都是教学逻辑标识,不对应真实引擎资产。

js
const assert = require('node:assert/strict');

function snapshot(facts) {
  assert.equal(facts.unit, 'm/s');
  assert.equal(typeof facts.grounded, 'boolean');
  assert([facts.localVX, facts.localVZ].every(Number.isFinite));
  assert(Number.isInteger(facts.epoch) && facts.epoch > 0);
  assert(Number.isInteger(facts.tick) && facts.tick >= 0);
  assert(typeof facts.actionId === 'string' && facts.actionId.length > 0);
  const speed = Math.hypot(facts.localVX, facts.localVZ);
  // 参数语义在转换层冻结,资源绑定不参与计算角色事实。
  return Object.freeze({ version: 1, epoch: facts.epoch, tick: facts.tick,
    speedMps: speed, moveX: speed > 1e-6 ? facts.localVX / speed : 0,
    moveY: speed > 1e-6 ? facts.localVZ / speed : 0,
    grounded: facts.grounded, actionId: facts.actionId });
}
function plan(params) {
  return { baseRole: params.grounded ? 'ground-locomotion' : 'air-locomotion',
    upperRole: 'upper-attack', speedMps: params.speedMps,
    epoch: params.epoch, actionId: params.actionId };
}
function bindUpper(role, catalog) {
  const binding = catalog[role]; assert(binding);
  // 变更资源名不能悄悄改变骨架或位移控制权。
  assert.equal(binding.rig, 'humanoid-main');
  assert.equal(binding.rootMotion, 'none');
  assert.equal(binding.maskRole, 'upper-body');
  return binding.clip;
}
class ActionLease {
  constructor(epoch, actionId) { this.epoch = epoch; this.current = actionId; }
  complete(event) {
    assert.equal(event.kind, 'completed');
    if (event.epoch !== this.epoch || event.actionId !== this.current
      || this.current === null) return false;
    // 完成后立即撤销租约,重复回调不能再次恢复控制权。
    this.current = null;
    return true;
  }
}

const facts = { unit: 'm/s', localVX: 3, localVZ: 4,
  grounded: true, epoch: 2, tick: 99, actionId: 'attack-12' };
const params = snapshot(facts), before = plan(params);
const binding = { rig: 'humanoid-main', rootMotion: 'none', maskRole: 'upper-body' };
const oldCatalog = { 'upper-attack': { ...binding, clip: 'rifle_attack_a' } };
const newCatalog = { 'upper-attack': { ...binding, clip: 'rifle_attack_b' } };
const oldClip = bindUpper(before.upperRole, oldCatalog);
const newClip = bindUpper(before.upperRole, newCatalog);
assert.deepEqual(plan(params), before);
assert.notEqual(oldClip, newClip);
console.log(`contract: speed=${params.speedMps}, direction=${params.moveX},${params.moveY}`);
console.log(`binding: ${oldClip} -> ${newClip}; semantics unchanged`);
assert.throws(() => snapshot({ ...facts, unit: 'cm/s' }));
assert.throws(() => bindUpper(before.upperRole, {
  'upper-attack': { ...binding, clip: 'lunge', rootMotion: 'extract' }
}));

const lease = new ActionLease(2, 'attack-12');
const event = { kind: 'completed', epoch: 2, actionId: 'attack-12' };
const accepted = [lease.complete({ ...event, epoch: 1 }),
  lease.complete({ ...event, actionId: 'attack-11' }),
  lease.complete(event), lease.complete(event)];
assert.deepEqual(accepted, [false, false, true, false]);
console.log(`completion acceptance: ${accepted.join(',')}`);

预期输出:

text
contract: speed=5, direction=0.6,0.8
binding: rifle_attack_a -> rifle_attack_b; semantics unchanged
completion acceptance: false,false,true,false

本例只演示已接受攻击的契约,不包含全部角色动作或网络协议。实际快照还应包含经过校验的动作类型,资源绑定还要检查目标资产存在、骨架映射、轨道与遮罩。单位拒绝和过期回调断言负责发现语义错误,不能代替真实资产加载测试。

用同一输入回放验收新的实现

先保留业务层与协议,替换资源和适配器,然后重放静止加速、奔跑攻击、攻击中受击、死亡及复活后旧事件到达等场景。比较动作许可与权威位移;表现部分再检查状态转场、关键骨骼、根运动、握把误差和通知次数。数值容差应按目标指标制定,不能要求不同求值系统每根骨骼都逐位一致。

求值与更新细节应重新核对官方说明。例如 Godot AnimationTree 的转场与混合文档 说明切换模式与缺失轨道初值,这些机制不能直接套用另一引擎的默认行为。本课已执行契约测试,未执行三个引擎的窗口预览、资源导入、蒙皮或线程接入;只有真实资产和运行时验收通过,才能声称迁移完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

不同引擎下哪些设计可以保持不变

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

登录哪都通