游戏客户端架构 / 系统课时
让角色边移动边举枪瞄准
让角色边移动边举枪瞄准
角色举枪时,下半身应继续根据实际速度走跑,上半身则逐渐进入持枪姿态。本课搭建基础移动与局部瞄准的组合契约,用权重和时钟例程验证腿部节奏没有被重置,并说明松开瞄准、目标丢失与全身动作接管的处理方式。
学习目标
- 将移动事实、持枪姿态和瞄准请求分开处理。
- 平滑控制局部层权重,同时保持基础动画时间推进。
- 检验瞄准退出和全身接管不会留下残余姿态。
先准备能独立成立的两种姿态
基础移动输出完整姿态,根据实际水平速度选择待机、步行或奔跑。上半身分支提供与当前武器一致的持枪姿态,覆盖必要的脊柱、肩部、手臂和手部,排除骨盆与双腿。移动期间不要停止基础播放器,也不要每次瞄准都重启跑步周期。
先单独检查两个资源:移动动画步幅应与位移匹配;持枪动画的肩、肘、手和武器挂点应能形成合理握姿。仅用手臂遮罩可能缺少胸部配合;遮罩包含骨盆又可能破坏跑步重心,范围需要在实际骨架上调整。

用权重控制进入而不是改变运动事实
瞄准请求应先经过业务层的装备、存活状态与动作许可检查。通过后,表现层将上半身权重逐渐升至 1;松开或失去合法目标时降至 0。移动速度继续来自运动控制器,不因视觉层权重改变。若玩法要求瞄准减速,应由运动规则明确实施,而不是让动画自行推断。
线性权重变化可以按“每秒变化量乘以时间步”推进,使 30、60 或 120 帧的总渐变时间近似一致。这里使用每秒 5 的变化率,完整淡入约 0.2 秒,仅是示例参数。边界采样与大时间步仍会造成观察差异,并不保证所有帧率的画面完全相同。
完整验证权重与移动时钟
下面的 Node.js 18 程序不加载骨骼资源,只验证时钟、权重与方向限制。坐标契约是角色局部 X 向右、Z 向前,瞄准方向由上游转换到此空间;其他引擎的轴定义应在适配层转换。保存为 moving-aim.js 后运行。
const assert = require('node:assert/strict');
const clamp = (x, lo, hi) => Math.max(lo, Math.min(hi, x));
const approach = (a, b, step) => a + clamp(b - a, -step, step);
class MovingAim {
constructor() { this.baseTime = 0; this.weight = 0; this.yaw = 0; }
step(dt, state) {
assert(Number.isFinite(dt) && dt >= 0);
assert(Number.isFinite(state.speedMps) && state.speedMps >= 0);
for (const key of ['alive', 'aimWanted', 'weaponReady', 'fullBody']) {
assert.equal(typeof state[key], 'boolean');
}
const [x, z] = state.localDirection;
assert(Number.isFinite(x) && Number.isFinite(z));
const validDirection = Math.hypot(x, z) > 1e-6;
const eligible = state.alive && !state.fullBody && state.weaponReady
&& state.aimWanted && validDirection;
// 基础时间独立推进,瞄准期间保留移动循环相位。
this.baseTime += dt;
if (!state.alive || state.fullBody) this.weight = 0;
else this.weight = approach(this.weight, eligible ? 1 : 0, 5 * dt);
if (eligible) {
const rawYaw = Math.atan2(x, z) * 180 / Math.PI;
const yawLimit = state.speedMps > 0.1 ? 55 : 90;
this.yaw = clamp(rawYaw, -yawLimit, yawLimit);
}
return { phase: (this.baseTime % 0.8) / 0.8,
speedMps: state.speedMps, weight: this.weight, yaw: this.yaw };
}
}
const p = new MovingAim();
const moving = { alive: true, speedMps: 3, weaponReady: true,
fullBody: false, localDirection: [Math.sqrt(3), 1] };
const expectedWeights = [0, 0.5, 1, 0.5, 0];
for (const [i, wanted] of [false, true, true, false, false].entries()) {
const result = p.step(0.1, { ...moving, aimWanted: wanted });
assert.equal(result.weight, expectedWeights[i]);
assert.equal(result.speedMps, 3);
console.log(`frame${i}: phase=${result.phase.toFixed(2)}, weight=${result.weight.toFixed(2)}`);
}
assert.equal(p.yaw, 55);
console.log(`moving yaw limit: ${p.yaw}`);
// 目标缺失会退出局部层;全身动作立即关闭该层的影响。
p.step(0.2, { ...moving, aimWanted: true });
assert.equal(p.weight, 1);
const lost = p.step(0.1, { ...moving, aimWanted: true, localDirection: [0, 0] });
assert.equal(lost.weight, 0.5);
const full = p.step(0, { ...moving, aimWanted: true, fullBody: true });
assert.equal(full.weight, 0);
console.log('lost target: 0.50; full-body: 0.00');预期输出:
frame0: phase=0.13, weight=0.00
frame1: phase=0.25, weight=0.50
frame2: phase=0.38, weight=1.00
frame3: phase=0.50, weight=0.50
frame4: phase=0.63, weight=0.00
moving yaw limit: 55
lost target: 0.50; full-body: 0.00即使上半身权重达到 1,基础时间仍持续前进。目标缺失时保留最近的有效方向,降低权重,不把零向量解释成一个新瞄准方向。全身翻滚或死亡立即撤销局部层影响;全身动作自身仍可使用交叉混合,不能让它与未关闭的瞄准层继续争夺姿态。
接入真实动画图时保留明确边界
在 Unity 中可用带 Avatar Mask 的 Override 层承载持枪姿态,并通过 Animator.SetLayerWeight 写入指定层权重;层索引和参数名称应由适配器持有。Unreal 可使用 Layered Blend per Bone 等姿态节点,其过滤和混合语义需要按真实节点设置核对。
本课建立的是局部持枪基础,不是完整的三维瞄准求解器。极端左右瞄准应由角色朝向系统配合转身,不能无限扭转腰部。根运动也须由既定运动控制层统一处理;遮罩不会自动取消持枪资源中所有根运动影响。
控制台验证已经执行,但尚未进行引擎窗口预览、移动蒙皮与武器贴合检查。接入后分别测试静止举枪、行走举枪、奔跑松开、目标丢失、切换武器和翻滚接管;观察腿部相位、脊柱边界、武器握姿以及退出后权重归零,不能只看一帧姿态是否像在持枪。