unity Animation代码控制暂停和跳转的api

### Unity Animation API 暂停与跳转控制方法 在 Unity 中，`Animation` 和 `Animator` 是两个主要用来管理动画的组件。以下是关于如何通过这些 API 实现动画暂停和跳转的具体说明。 #### 动画暂停功能 对于传统的 `Animation` 组件，可以通过调整其 `speed` 属性来实现动画的暂停效果： ```csharp // 获取目标对象上的 Animation 组件实例 Animation animationComponent = GetComponent<Animation>(); // 设置指定动画片段的速度为 0 来暂停该动画 animationComponent["ani_name"].speed = 0; ``` 要重新启动已暂停的动画，只需将其速度设置回正值即可[^1]： ```csharp // 将 speed 设为 1 表示恢复正常播放速度 animationComponent["ani_name"].speed = 1; ``` 而对于现代的 `Animator` 系统，虽然没有直接提供类似的 `speed` 参数用于单个剪辑操作，但仍可通过修改全局时间比例 (`timeScale`) 或者自定义逻辑间接达到类似目的： ```csharp // 使用 Time.timeScale 影响整个游戏的时间流速 Time.timeScale = 0f; // 完全冻结时间（包括 Animator） Time.timeScale = 1f; // 恢复正常时间流动 ``` 需要注意的是，这种方法会影响场景中的所有基于时间的行为，而不仅仅是特定的动画[^3]。 #### 动画跳转至起始帧或其他位置 为了使某个正在运行的动画返回到它的初始状态或者任意中间时刻，在传统 `Animation` 类型下可手动设定当前播放进度(`time`)并强制采样更新: ```csharp public void ResetAniToStartFrame(Animation ani, string name){ AnimationState state = ani[name]; if(state != null){ state.time = 0; // 把 time 设置成 0 返回开头 ani.Sample(); // 更新动画数据以反映更改后的 time 值 state.enabled = true; // 如果之前禁用了此通道则需再次激活 } } ``` 而在更先进的 Mecanim (Animator) 架构里完成同样的任务稍微复杂一些，因为这里不存在简单的 'reset' 方法可以直接作用于单一 clip 上面；不过我们还是能够借助 Scripting 接口去操控底层的数据结构从而达成预期的效果 —— 即创建一个新的 Transition 并立即触发它指向同一个 State 自己本身，这样就相当于重启了一遍那个 State 所关联的一系列 Clips 的执行流程[^2]: ```csharp animator.Play("YourTargetClipName", -1, normalizedTime); ``` 其中第三个参数是一个介于 `[0..1]`之间的浮点数表示相对于总长度的比例偏移量，利用它可以精确定位到想要跳跃的目标瞬间而不是仅仅局限于首尾两端. --- ### 示例代码展示 下面给出一段综合上述知识点的小例子演示如何在一个按钮点击事件中分别处理这两种情况下的暂停/继续以及重置动作： ```csharp using UnityEngine; public class AnimController : MonoBehaviour { private Animation _oldAnimSys; private Animator _newMecanimSys; void Start(){ _oldAnimSys = GetComponent<Animation>(); _newMecanimSys=GetComponent<Animator>(); } public void TogglePauseOldSystem(string clipName,bool pauseFlag){ var target=_oldAnimSys[clipName]; if(target!=null){ target.speed=(pauseFlag)?0:Mathf.Abs(target.speed); } } public void JumpToBeginningNewSystem(string stateName,float normPos=0F){ _newMecanimSys.Play(stateName,-1,normPos); } } ``` ---