unity 动作播放速度

### 更改 Unity 中动画播放速度的方法

#### 使用 Animator 组件调整整体播放速度
当需要在运行时动态调整整个 `Animator` 的播放速度时，可以通过设置 `Animator.speed` 属性来实现。此属性影响所有处于活动状态下的动画片段的播放速率。

// C# 代码示例：调整 Animator 整体播放速度
public class AdjustAnimationSpeed : MonoBehaviour
{
    public float newSpeed = 1.0f;
    private Animator animator;

    void Start()
    {
        animator = GetComponent<Animator>();
        animator.speed = newSpeed; // 设置新的播放速度
    }
}

这种方法适用于希望统一改变角色或物体上所有动画的表现情况[^2]。

#### 针对特定状态调整播放速度
对于想要单独控制某一个具体动画状态的情况，在默认情况下直接通过 API 调整单个状态的速度并不被支持。不过，可以采用间接的方式达成目的——即检测当前是否进入了目标状态并相应地调整 `Animator` 的全局速度；一旦退出该状态再恢复原来的速度设定。

// C# 代码示例：针对特定状态调整播放速度
void Update()
{
    if (animator.GetCurrentAnimatorStateInfo(0).IsName("Target State"))
    {
        originalSpeed = animator.speed;
        animator.speed = specialSpeedForThisState;
    }
    else
    {
        animator.speed = originalSpeed;
    }
}

这种方式允许开发者灵活应对不同场景的需求，而无需每次都重新配置复杂的参数。

#### 利用 Timeline 系统自定义播放速度
如果项目中使用了 Unity 的 Timeline 工具来进行复杂序列化叙事或者高级时间线管理，则有更多选项可用于定制动画行为：

- **编辑器内操作**：可以在 Editor 中右键点击轨道选择 "Convert To Clip Track" 后手动输入 Speed Multiplier 值。

- **编程接口调用**
- 对于整个 Playable Director 可以利用如下方式快速更改编播速：

    // C# 代码示例：修改 Timeline 全局播放速度
    var graph = director.playableGraph;
    if (!graph.IsValid())
        return;
        
    graph.GetRootPlayable(0).SetSpeed(newGlobalSpeed);

- 或者精确到每一个独立轨道上的剪辑（Clip），逐一遍历并应用所需的时间缩放因子：

    // C# 代码示例：修改指定轨道中的每个剪辑播放速度
    foreach (var track in timelineAsset.GetOutputTracks())
    {
        foreach (var clip in track.GetClips())
        {
            clip.timeScale = individualClipSpeed;
        }
    }

上述方法提供了极大的灵活性，使得即使是最细致入微的变化也能得到妥善处理[^3]。