概要

Timeline のアニメーション出力ウェイトを設定して、アニメーターとブレンドする方法を紹介します。
すぐに使えるスクリプトも Github に置いてあります。

この記事の結果：

解説

解説の流れ：

AnimationPlayableOutput.SetWeight() で出力ウェイトが設定できる
しかし、Timeline のほうで毎フレーム weight を設定している
→ 毎フレーム再設定するための PlayableBehaviour を作成する

AnimationPlayableOutput.SetWeight でウェイトを設定

Timeline の根底にある技術は Animator と同じもので、Playable を使用しています。
例えばアニメーショントラックの場合、トラック上にあるアニメーションクリップを再生時間に合わせて weight を調整し、AnimationPlayableOutput に出力して、最終的に Animator のほうでアニメーションさせています。

　図：PlayableGraph の例

また、AnimationPlayableOutput が複数ある場合、それぞれの weight を見て、ブレンドします。

Animator の出力も、Timeline の出力も、AnimationPlayableOutput ですので、ウェイト機能を利用すれば、Timeline のアニメーショントラックの出力を好きなようにアニメーターとブレンドさせることができます：

private PlayableGraph graph;

public void SetWeight(float weight)
{
    var output = (AnimationPlayableOutput) graph.GetOutput(0);
    output.SetWeight(weight);
}

このように、weight を設定すれば、Timeline のアニメーションをアニメーターのアニメーションとブレンドすることできます。

しかし、ここで問題が発生します。なんと、Timeline ではこの weight を毎フレーム設定しているため、通常では任意で設定することはできません。

再設定しているところ：

TimelinePlayable.AnimationOutputWeightProcessor

    class AnimationOutputWeightProcessor : ITimelineEvaluateCallback
    {
        // ...
        public void Evaluate()
        {
            float weight = 1;
            m_Output.SetWeight(1);
            for (int i = 0; i < m_Mixers.Count; i++)
            {
                var mixInfo = m_Mixers[i];
                weight = WeightUtility.NormalizeMixer(mixInfo.mixer);
                mixInfo.parentMixer.SetInputWeight(mixInfo.port, weight);
            }

            // only write the final weight in player/playmode. In editor, we are blending to the appropriate defaults
            // the last mixer in the list is the final blend, since the list is composed post-order.
            if (Application.isPlaying)
                m_Output.SetWeight(weight);
        }
    }

これを解決するために、Timeline が設定した後、自分の weight を更に設定必要があります。

ウェイトを再設定する PlayableBehaviour

残念ながら、Timeline の weight 設定処理は PlayableGraph の中で行われているので、同じく Playable からしか間に合う方法はありません。（Update() も LateUpdate() も不可）
そのため、下記のような PlayableBehaviour を追加する必要があります：

    public class SetAnimationOutputWeightBehaviour : PlayableBehaviour
    {
        public float weight;
        public List<AnimationPlayableOutput> outputList = new();

        public override void ProcessFrame(Playable playable, FrameData info, object playerData)
        {
            // weight を設定
            // set weight
            foreach (var output in outputList) {
                output.SetWeight(weight * output.GetWeight());
            }
        }
    }

    // あとは再生開始のタイミングで追加するだけ
    // var playable = ScriptPlayable<SetAnimationOutputWeightBehaviour>.Create(graph);
    // ... ...

この PlayableBehaviour を同じ graph に追加すれば、Timeline 側が weight を設定した後、設定したいウェイトを更に上書き設定できるようになります。

実際のスクリプト (Github)

上記 Playable を作成・適用する処理を書くと長くなりますので、Gihtub に最終的なスクリプトを載せました。

上記スクリプトを PlayableDirector と同じ GameObject にアタッチすれば、任意の割合でアニメーター、あるいは別の Timeline アニメーション出力とブレンドすることができます：

応用例

応用例として、Timelineの開始と終了で weight を 0→1, 1→0 でイージングして、きれいなアニメーション遷移をさせることができます。

一応、Timeline クリップ側の Extraporlation を設定すれば同じことが達成できますが、各 Timeline 毎回一々設定するのは面倒くさいので、システムとして作るのが良いと思います

結

この記事で Timeline のアニメーション出力をアニメーターのアニメーションとブレンドする方法を紹介しました。Playable や SetWeight() を紹介して、PlayableBehaviour を作成して Timeline 側の既存処理を上書きする方法を紹介しました。

Timeline と Playable に対する理解や、カスタマイズ方法を少しでもご理解いただけたら幸いです。