游戏客户端架构 / 系统课时
不同引擎下哪些设计可以保持不变
不同引擎下哪些设计可以保持不变
迁移引擎时,资源引用、动画节点和求值回调往往都要重做,但角色为什么移动、谁能打断攻击,以及动作编号的含义应保持稳定。本课把这些不变规则写成可验收契约,用资源替换和旧回调测试检查迁移是否越过了职责边界。
学习目标
- 区分稳定的业务语义与必须重新适配的引擎机制。
- 为坐标、单位、动作编号和资源角色建立迁移约定。
- 用相同输入和明确不变量验收替换后的实现。
能保留的是行为边界和语义
运动控制器仍然提供实际速度与接地事实,战斗逻辑仍然决定动作许可和打断,动画系统仍然负责姿态表现。迁移时不应因为新动画状态回调更方便,就把伤害、生命值或移动权限的唯一来源挪到动画节点中。
| 可以保持的设计 | 必须重新适配的实现 |
|---|---|
| 速度单位、角色方向坐标及参数类型 | 引擎坐标轴、属性名和更新阶段 |
| 业务动作优先级、取消窗口和终止规则 | 状态图、转场排序与中断机制 |
| 资源的逻辑角色、骨架兼容要求 | 文件格式、实际资源引用与导入设置 |
| 基础移动、局部动作、接触约束的职责 | 遮罩、加法空间和具体姿态节点 |
| 生命周期与动作编号的事件有效性 | 通知回调、线程及资源加载流程 |
保持设计不变不等于保持动画图一模一样。Unity 的状态机层、Unreal 的姿态图和 Godot 的 AnimationTree 可以承载相同需求,但相同权重数值不保证相同最终骨骼结果。迁移验收应关注腿部连续、动作时序和接触偏差,而非截图中的节点数量。
协议至少写清单位和更新来源
例如 speedMps 统一为米每秒,方向使用角色局部 X 向右、协议前向分量向前;实际引擎可使用其他世界轴。归一化与转换在适配边界只做一次。将厘米每秒直接写入同名字段,或者将世界方向冒充局部方向,接口名称虽相同,语义已经失效。
持续参数使用同一更新的快照,至少带采样编号与角色生命周期。动作开始和完成是事件,带当前动作实例编号。角色复活后生命周期递增;旧攻击结束事件不能解除新角色或新攻击的锁定。资源名称不承担这一职责,因为同一片段可能在不同动作实例中重复播放。
资源清单也应记录骨架兼容与根运动策略。迁移绑定可以更换片段,但不能无声地把原地局部攻击换成会驱动角色位移的全身片段。根运动提取与应用属于明确控制权,需要与运动系统共同修改和验收。
用不依赖引擎的契约测试迁移边界
下面的 Node.js 18 程序使用两个示例资源清单,只测试语义与引用分离,不伪装 Unity、Unreal 或 Godot 适配器。保存为 migration-contract.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(',')}`);预期输出:
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 的转场与混合文档 说明切换模式与缺失轨道初值,这些机制不能直接套用另一引擎的默认行为。本课已执行契约测试,未执行三个引擎的窗口预览、资源导入、蒙皮或线程接入;只有真实资产和运行时验收通过,才能声称迁移完成。