Unity自定义Track编辑器模式预览：Clip外时段处理方法咨询

阿华AIGC实验室

2026-5-21

解决Timeline自定义Track处理Clip外时段的问题

我之前做自定义Track的时候也碰到过一模一样的困扰——用空Clip凑数实在太麻烦了！其实Timeline本身就提供了更优雅的解决方案，不需要额外添加空Clip，直接在Track层面就能处理全局的帧逻辑。

核心思路：利用TrackAsset的`ProcessFrame`方法

默认情况下，Clip的ProcessFrame只在Clip激活的时段触发，但TrackAsset本身的ProcessFrame方法会在Timeline播放的每一帧都被调用，不管Track上有没有Clip。我们可以重写这个方法，在里面判断当前时间是否处于任意Clip的范围内，再分别处理不同场景的逻辑。

具体实现步骤

打开你的自定义Track类（继承自TrackAsset），重写ProcessFrame方法。
在方法里获取当前Timeline的播放时间，遍历Track上的所有Clip，判断当前时间是否落在某个Clip的时间区间内。
如果不在任何Clip范围内，就执行你想要的“Clip外”逻辑；如果在，就让Clip自身的逻辑正常运行即可。

代码示例

using UnityEngine;
using UnityEngine.Timeline;

// 自定义Track的颜色和关联的Clip类型
[TrackColor(0.8f, 0.2f, 0.2f)]
[TrackClipType(typeof(MyCustomClip))]
public class MyCustomTrack : TrackAsset
{
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        // 先调用基类方法，保证Clip的ProcessFrame能正常执行
        base.ProcessFrame(playable, info, playerData);

        // 获取当前Timeline的全局播放时间
        double currentTimelineTime = playable.GetGraph().GetRootPlayable(0).GetTime();

        // 检查当前时间是否处于任意一个Clip的范围内
        bool isInsideAnyClip = false;
        foreach (var clip in clips)
        {
            if (currentTimelineTime >= clip.start && currentTimelineTime <= clip.end)
            {
                isInsideAnyClip = true;
                break;
            }
        }

        // 处理Clip以外的时段逻辑
        if (!isInsideAnyClip)
        {
            // 这里写你需要的逻辑，比如重置状态、执行默认行为等
            Debug.Log($"处理Clip外的帧，当前时间：{currentTimelineTime}");
            
            // 举个例子：如果是控制某个物体的状态，这里可以把它重置到初始状态
            var target = playerData as YourTargetComponentType;
            if (target != null)
            {
                target.ResetToDefault();
            }
        }
    }
}

额外优化：区分Clip之前和之后的逻辑

如果需要对Clip之前和之后的时段做不同处理，可以进一步判断时间范围：

if (clips.Count > 0)
{
    double firstClipStart = clips[0].start;
    double lastClipEnd = clips[clips.Count - 1].end;

    if (currentTimelineTime < firstClipStart)
    {
        // Clip开始前的逻辑
    }
    else if (currentTimelineTime > lastClipEnd)
    {
        // Clip结束后的逻辑
    }
}
else
{
    // Track上没有任何Clip时的逻辑
}