​

🎬 技能动画管线：从 Animator Event 到可视化时间轴

​

1. 传统方案：Animation Events

​

1.1 工作流

1. 打开 Animation 窗口。
2. 在第 20 帧右键 -> Add Animation Event。
3. 填写函数名 OnHit 和参数 1.0。
4. 代码中实现 void OnHit(float damageMultiplier) { ... }。

​

1.2 致命缺陷 (The “Traps”)

• 弱引用地狱: Event 依赖字符串匹配函数名。如果你重构代码改了函数名，所有动画里的 Event 都会默默失效，编译器不会报错。
• 逻辑丢失: 当动画处于 Transition (过渡) 阶段，或者被 CrossFade 强行打断时，被跳过的帧上的 Event 不会触发。这会导致严重 Bug（例如：玩家动作被打断，但“无敌状态”没被清除，导致永久无敌）。
• 复用困难: 多个角色复用同一个动画文件（Humanoid Retargeting），但他们的脚本逻辑不同，会导致 MissingMethodException。
• 数据分散: 技能逻辑散落在几十个 .anim 文件里，策划无法在一个地方概览所有配置。

​

2. 进阶方案：State Machine Behaviours (SMB)

​

2.1 工作流

1. 在 Animator 窗口选中 “Attack_Slash” 状态。
2. 点击 Add Behaviour -> 新建脚本 SkillState.
3. 利用 OnStateEnter, OnStateUpdate, OnStateExit 钩子。

​

2.2 优缺点

• ✅ 生命周期明确: 保证 Enter/Exit 一定会成对调用（除非 Animator 被禁用），适合处理 Buff 开关、无敌帧开关。
• ✅ 逻辑解耦: 脚本在 Asset 层面，不依赖具体场景物体。
• ❌ 时序精度低: OnStateUpdate 每一帧都跑，如果要精确在“动作播放到 35%”时触发伤害，需要写繁琐的 normalizedTime 检查逻辑，且难以可视化编辑。

​

3. 工业级方案：可视化时间轴编辑器 (Visual Timeline Editor)

​

3.1 架构核心

• Animation Track: 播放哪个动作。
• Audio Track: 播放什么音效。
• VFX Track: 在哪个骨骼点生成特效。
• Logic Track: 伤害判定框 (Hitbox) 的开启与关闭时间窗口。
• Interrupt Track: 哪个时间段允许被移动打断，哪个时间段允许被大招打断。

​

3.2 实现路径

​

A. 使用 Unity Playable API + Timeline

• 魔改 Timeline: 自定义 Track 和 Clip。
• 优势: 编辑器体验极其丝滑，支持预览。
• 劣势: 运行时性能开销略大（Playable Graph），且数据结构较重。

​

B. 自研轻量级编辑器 (推荐)

• 数据结构:
  Copy

  public class SkillData : ScriptableObject {
      public float duration;
      public List<SkillEvent> events; // 按时间排序
  }
  
  [Serializable]
  public class SkillEvent {
      public float time;
      public EventType type; // Damage, VFX, Sound
      public string parameter;
  }
  
• 运行时驱动: 在 Update 中计时：
  Copy

  void Update() {
      timer += Time.deltaTime;
      while (nextEventIndex < events.Count && timer >= events[nextEventIndex].time) {
          Execute(events[nextEventIndex]);
          nextEventIndex++;
      }
  }
  

​

3.3 为什么它更优雅？

1. 确定性 (Determinism): 逻辑完全由时间驱动，不依赖动画系统的混合状态。即使模型丢失、动画卡住，伤害判定依然会准时触发。
2. 可视化 (Visualization): 策划可以直观地看到：伤害是在刀光特效出现的 0.1秒 后触发的。
3. 热重载: 可以在 Play Mode 下拖动时间轴上的滑块，实时调整手感（例如修改前摇时间），无需重编译。
4. 健壮性: 所有的配置都是强引用的 Asset，不会因为改了函数名而崩坏。

​

4. Vampirefall 落地建议

​

推荐方案：轻量级帧事件系统

1. 配置: 在技能 SO 中定义关键帧时间点。
   • FireTime: 0.5s (发射投射物时间)
   • BackswingTime: 0.8s (后摇结束，可进行下一次攻击时间)
   • TotalDuration: 1.2s (动作总时长)
2. 预览: 写一个简单的 Editor 脚本，在 Scene View 中根据当前选中的帧，画出怪物的 Hitbox 范围，方便对齐。
3. 执行: 使用 Coroutine 或 Timer 在代码中严格执行上述时间点，动画仅作为视觉表现配合逻辑播放，而不是逻辑驱动动画。