当前位置：首页 > article >正文

Unity Timeline 扩展

article 2025/3/18 0:41:47

这里认为大家已经会timeline的基本使用了，只介绍怎么自定义扩展。

第一步.自定义Track

首先要自定义一条轨道。剪辑是要在轨道里跑的，系统自带的轨道我们加不了自定义剪辑，得新建自己用的。这个很简单。

[TrackClipType(typeof(TransformTweenClip))] //关联的Clip类型
[TrackBindingType(typeof(GameObject))] //绑定的数据类型。
public class TestTrack1 : TrackAsset
{
}

编译过后就可以在Timeline的窗口里创建这个轨道了。后面再给这个轨道关联我们的自定义剪辑。

主要就是几个属性的作用需要了解一下。

[TrackClipType(type))]
指定关联的Clip类型，如果一个都没有，在Track上右键菜单里就没有可创建的clip。

[TrackBindingType(type))]
指定绑定的数据类型。这样在Track上会出现对象选择器，绑定的数据对象会作为playdata参数传递给我们（后面会看到）。

此外还有

[TrackColor(0,255,0)]轨道颜色是0~255的值

第二步创建Clip数据

Timeline窗口里编辑的是数据，这个就是定义Clip的数据。数据和逻辑分离的设计，很好理解。

public class TestClip1 : PlayableAsset
{
    public Transform trans;
    public Vector3 start;
    public Vector3 end;
}

记得用[TrackClipType(typeof(TestClip1))] 把它在TestTrack1上关联。

第三步创建Clip的行为

public class TestClip1Behaviour : PlayableBehaviour
{
    public TestClip1 data;
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        base.ProcessFrame(playable, info, playerData);
        data.trans.localScale = Vector3.Lerp(data.start, data.end, (float)(playable.GetTime() / playable.GetDuration()));//Clip上的当前时间/总时间
    }
}

还需要让数据和逻辑关联起来，Unity不知道TestClip1对应的是TestClip1Behaviour。Unity采取的办法是让我们在数据里的一个虚函数里创建逻辑对象并返回。TestClip1需要加一点代码。

public class TestClip1 : PlayableAsset
{
    public Transform trans;
    public Vector3 start;
    public Vector3 end;

    //增加的代码如下：
    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        return ScriptPlayable<TestClip1Behaviour>.Create(graph, new TestClip1Behaviour(){data = this});
    }
}

也很简单。

剪辑的行为对象在这个ScriptPlayable<T>里面，如果我们要获取其他剪辑行为对象，首先获取到的也是这个东西。通过T ScriptPlayable<T>.GetBehaviour()就可以获取到具体的行为对象了。这个后面做剪辑混合会用到。具体可以看手册。

编译结束后就可以去Timeline窗口里创建剪辑了。

小结

基本的剪辑扩展就完成了，功能都在Behaviour里。

一般会将控制的场景对象作为数据绑定传递到Clip和Mixer，作为字段放在Clip里会有引用丢失问题。

进阶一 ExposedReference<T>

需要注意的是，上面为了省事，TestClip1里直接把Transform声明为变量了。但是Timeline存储后是一种资源，资源是不能直接引用场景里的东西的，也就是说trans字段的引用对象不会保存到对象。这里可以通过关闭场景然后再次打开来验证，Timeline文件上引用的场景对象会丢失。

为了解决这个问题，unity搞了个ExposedReference<T>类型来实现对场景里的东西引用。估计是用路径查找实现的，具体就没去翻了。只需要将定义改成这样就行了：

public ExposedReference<Transform> trans;

//获取真正trans对象的代码为：
//trans.Resolve(playable.GetGraph().GetResolver())

详情可以看这里：

【Unity学习笔记】ExposedReference类的初识 + 自定义Timeline轨道初识-CSDN博客

进阶二剪辑混合

剪辑混合是一条Track里的多个剪辑发生过渡时，根据各个剪辑的权重用户自己算出一个最终的值。这个过程Unity不会自动做，要撸代码。注意混合是Track层面的事情，不是Clip里的事，要遍历多个Clip来计算。

总共可分两步。第一步创建混合行为代码。

public class TestTrack1Mixer : PlayableBehaviour
{
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        base.ProcessFrame(playable, info, playerData);
        var inputCount = playable.GetInputCount();
        var scale = Vector3.zero;
        for(int i = 0; i < inputCount; i++)
        {
            var scriptPlayable = (ScriptPlayable<TestClip1Behaviour>)playable.GetInput(i);
            var bhv = scriptPlayable.GetBehaviour();//如果不是TestClip1Behaviour，这里会返回null。设计时注意即可。
            float weight = playable.GetInputWeight(i);
            //Behaviour是在包含它的ScriptPlayable<T>里跑的，时间从scriptPlayable这个变量获取，而不是函数传入的playable变量
            scale += weight * Vector3.Lerp(bhv.data.start, bhv.data.end, (float)(scriptPlayable.GetTime() / scriptPlayable.GetDuration()));
        }

        //这里用了playerData，就是[TrackBindingType(typeof(GameObject))] 绑的
        var go = playerData as GameObject;
        go.transform.localScale = scale;
    }
}

这里混合后最后控制的对象是playerData传入的。从遍历到的TestClip1Behaviour上取也行，但是不如这样方便。

第二步在Track1Asset里创建这个混合器。

[TrackClipType(typeof(TransformTweenClip))] //关联的Clip类型，如果一个都没有，在Track上右键菜单里就没有可创建的clip。
[TrackBindingType(typeof(GameObject))] //绑定的数据类型。
public class TestTrack1 : TrackAsset
{
    //新增的代码
    public override Playable CreateTrackMixer(PlayableGraph graph, GameObject go, int inputCount)
    {
        return ScriptPlayable<TestTrack1Mixer>.Create(graph, inputCount);
    }
}

进阶三自定义信号

继承自SignalEmitter就行了。

public class TestSignal : SignalEmitter
{
    public string arg;
}

编译通过后，Timeline编辑器里就会显示自己的信号。

既然已经自定义信号了，那么也得自定义一个信号接收器了，自带的信号接收器SignalReceiver不能处理自定义信号。代码如下，也很简单。

public class TestSignalReceiver : MonoBehaviour, INotificationReceiver
{
    public void OnNotify(Playable origin, INotification notification, object context)
    {
        var s = notification as TestSignal;
        Debug.Log(s.arg);
    }
}

系统自带的信号发送和接收，相当于就是把一个资源文件作为信号参数传递，然后根据信号参数调用对应处理函数，大多数情况下用系统自带的就够用了。