⚡ 传送落地「弹起几帧」根因分析与保底方案 · 角色1014

概述

轻度传送（LightTeleport）落地阶段，只有角色 1014 会被向上弹起几帧再恢复正常起立。 定位结论：落地 Seq（Seq3）的配置长度大于下落技能的蒙太奇长度——下落技能 1018 先播完、先结束， 技能结束时的清理动作与仍在驱动角色的 Seq3 打架，落地姿态被弹回。已用「两侧长度对齐」临时修复并验证。

现象（QA 录屏）

录屏逐帧可见的完整过程：

1. 角色从高空下落，调试面板 Phase: Skill（下落技能 1018 生效中）
2. 触地瞬间深蹲到最低点（Seq3 驱动的落地缓冲）
3. 最低点后躯干上弹几帧——不是起立动画的平滑回升，是姿态被瞬间拽回（弹起后画面出现角色名「执火人」）
4. 随后正常起立，Phase: Skill → Grounded、CurrentState: NotMoving

根因（实测确认）

传送落地有两个并行的视觉驱动者：

当 Seq3 配置长度 > 下落技能蒙太奇长度时：蒙太奇先播完 → 技能结束。技能结束瞬间做了三件事， 每一件都在和还在播放的 Seq3 抢角色：

完整链路

// TeleportController.OnStartDown（顺序严格：先 Seq 后技能）
await this.ExitLoadLevelAsync();      // ① Seq3 加载 → BindRealRoleToSeq3 → 播放（时长 T_s）
await this.StartTeleportDown();       // ② BeginLevelSkill(1018)

// LevelSkillLogicLightTeleportDown.OnStart（蒙太奇路径）
const playResult = this.SkillInstance?.PlaySkillMontage(
    0, 1, 0,
    () => { this.OnTeleportDownComplete(); },   // ← 蒙太奇播完(T_m)直接结束技能，没有等 Seq3
    startSection,
);

// OnTeleportDownComplete
this.SkillComp?.EndSkill(skillId, '传送-轻度传送下降完成', ESkillEndReasonType.SkillEnd);

// Skill.ClearSkillMontage / OnEnd
this.AnimComp!.MainAnimInstance!.Montage_Stop(0.2, montage);  // ① 硬切
this.ApplyPlayerGravityScale(true);                        // ② 重力恢复
// ③ Phase: Skill → Grounded（状态机接管）

代码现状：闸门只盖了一半

LevelSkillLogicLightTeleportDown.OnStart 有三条结束路径，只有一条有「等 Seq3」的闸门：

另一个帮凶：事件发射点散落

TeleportDownSkillComplete（Seq3 完成的唯一信号）在 TeleportController 里有 7 处 emit（OnFinished 正常路径 + 6 处失败收闸：配置缺失 / 绑定失败 / 播放器缺失 / 资源加载失败 / Actor 缺失 / 淡入淡出路径）。 排查「闸门为什么提前/延后关」时需要逐处找，是典型的多点收闸结构。

已实施修复 配置修复 · 已验证

两侧长度对齐：把下落技能蒙太奇长度与 Seq3 落地段配置长度调成一致， 技能结束与 Seq3 完成同帧到达，双驱动窗口消失，弹起不再出现。

保底方案（设计完成 · 待实施）

核心原则：技能结束条件 = 自身蒙太奇播完 AND 落地 Seq3 完成（双驱动完成闸门）， 复用已有的 WaitSeq3ThenComplete 模式，不是新发明。

① LevelSkillLogicLightTeleportDown.ts

• 蒙太奇 OnCompleted / 起播失败两条路径：主控不再直接 OnTeleportDownComplete， 改查 Seq3 流程状态——还在进行 → 复用 WaitSeq3ThenComplete()（事件 + 已有 15s 兜底）； 已结束 → 立即结束（避免反向场景「Seq 比 蒙太奇短、事件已发过、干等 15s」）
• 模拟端不经过新逻辑（没有 Seq3，行为完全不变）
• WaitSeq3ThenComplete() 加防重入保护

② TeleportController.ts

• 新增 IsDownSeqFlowActive 标志：ExitLoadLevelAsync 入口置 true， 收闸时清 false
• 把 7 处 TeleportDownSkillComplete emit 收口成一个私有方法（清标志 + emit）， 暴露只读查询给技能侧

③ 长度校验（防再犯）

• 传送配置加载时读出 Seq3 播放长度与下落蒙太奇长度，偏差超过阈值（如 0.5s）Log.Error 带两侧数值——错配在编辑器跑一次传送就能看到，不必等 QA 录屏

无竞态论证

await this.ExitLoadLevelAsync();   // Seq3 流程先建立 → IsDownSeqFlowActive 必然先为 true
await this.StartTeleportDown();  // 技能后启动 → 读标志时 Seq3 流程必然已存在

// 标志读取 + Once 注册在同一个同步块内，事件 emit 也是同步的
// JS 单线程 → 不存在「读到 false 但事件还没来得及发」的窗口

业界对照

「多个异步视觉驱动者 + gameplay 状态机抢角色控制权」这类问题，业界三种模式：

结论与待办

相关代码：Src/Game/World/Entity/Skill/SkillLogic/LevelSkillLogic/LevelSkillLogicLightTeleportDown.ts · Src/Game/Module/Teleport/TeleportController.ts · Src/Game/World/Entity/Skill/Skill.ts（ClearSkillMontage） · 下落技能 ID 1018（TeleportDefineConstants.TeleportDownSkillId）