はじめに

Gif画像のようなポストエフェクトを制御するタイムラインを作ります

比較

タイムラインが一番左のクリップの上にいる時は、目立つポストエフェクトはかかりません

タイムラインが真ん中のクリップの上にいる時は、Bloomエフェクトがかかり、後ろの花火が綺麗に見えます

タイムラインが右のクリップの上にいる時は、Depth of Fieldエフェクトがかかり、Unityちゃんがフォーカスされ、後ろの背景がボケて見えます

環境

Unity 2020.1.15f
Universal Render Pipeline

UniversalRenderPipelineについて

この記事の環境はUniversalRenderPipeline(以下URP)を使用します。
URPはUnityが新たに設計してるグラフィクスパイプラインで、従来のグラフィクスパイプラインとは互換性がありません。
この記事と同じ手順でタイムラインを作成する場合はプロジェクト作成時にUniversal Render Pipelineを選択してください。

検証用のポストエフェクトを用意する

Unityではポストエフェクトの設定データをVolumeと呼びます。
今回は3つのVolumeを用意しました

それぞれのパラメーターについては触れませんが、Volume1よりもVolume2が、Volume2よりもVolume3が華やかに見えるような設定にしました。
これらのVolumeは同名のゲームオブジェクトを作成しヒエラルキーに配置します。

タイムライントラックを自作する

VolumeTimelineTrackという名前のトラックを作成します。このトラックを使ってポストエフェクトを制御します。
タイムラインを作るには3つのクラスが必要になります。

VolumeTimelineAsset.cs

[Serializable]
public class VolumeTimelineAsset : PlayableAsset
{
    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        return Playable.Null;
    }
}

VolumeTimelineBehaviour.cs

public class VolumeTimelineBehaviour : PlayableBehaviour
{
}

VolumeTimelineTrack.cs

[Serializable]
[TrackClipType(typeof(VolumeTimelineAsset), false)]
public class VolumeTimelineTrack : PlayableTrack
{
}

これらのクラスを作成することでタイムラインにVolume Timeline Trackを作成できるようになります。

それぞれのクラスの役割

現時点ではクリップの配置やVolumeの設定はできませんが、それぞれのクラスの役割を完成したタイムラインを使って説明します。

VolumeTrack

VolumeTrackはトラックの設定に関するクラスで、具体的には以下のような処理を担当します。

トラック上に作れるクリップの種類を制限する
トラック上にクリップが作られた時の挙動を設定する
トラックの名前を変更する

VolumeTimelineBehaviour

VolumeTimelineBehaviourはクリップの振る舞いを制御するクラスで、具体的には以下のような処理を担当します。

クリップが再生された時の挙動を設定する
クリップが再生中の挙動を設定する
クリップが再生終了した時の挙動を設定する

VolumeTimelineAsset

VolumeTimelineAssetはVolumeTimelineBehaviourを作るためのクラスで、具体的には以下のような処理を担当します。

クリップが参照するオブジェクトを設定する
参照したオブジェクトをVolumeTimelineBehaviourに渡す

実装方針

これらの役割を踏まえて、以下のような実装方針を建てます。
1. トラック上にクリップを作れるようにする
2. クリップを再生している時にVolumeをアクティブにし、それ以外は非アクティブにする
3. タイムラインで制御するVolumeを指定できるようにする

1. トラック上にクリップを作れるようにする

これはすでにTrackClipTypeアトリビュートで設定されているため、追加の実装は不要です。

2. クリップを再生している時にVolumeをアクティブにし、それ以外は非アクティブにする

この動作はActivationTrackとまったく同じものになります。
そのためActivationControlPlayableを継承することで実装が可能です。

public class VolumeTimelineBehaviour : ActivationControlPlayable
{
    public void SetTarget(Volume volume, PostPlaybackState postPlaybackState)
    {
        gameObject = volume.gameObject;
        postPlayback = postPlaybackState;
    }
}

SetTargetメソッドを作り以下の情報を外部から渡せるようにします

アクティブ・非アクティブを切り替えるゲームオブジェクト
クリップの再生終了時にオブジェクトをどの状態にするか

3. タイムラインで制御するVolumeを指定できるようにする

画像のVolumeの指定欄を作るためのスクリプトを作成します。

VolumeTimelineAsset.cs

[Serializable]
public class VolumeTimelineAsset : PlayableAsset
{
    public ExposedReference<Volume> volume;

    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        Volume resolvedVolume = volume.Resolve(graph.GetResolver());
        if (resolvedVolume == null)
        {
            return default;
        }

        VolumeTimelineBehaviour behaviour = new VolumeTimelineBehaviour();
        behaviour.SetTarget(resolvedVolume, ActivationControlPlayable.PostPlaybackState.Inactive);
        return ScriptPlayable<VolumeTimelineBehaviour>.Create(graph, behaviour);
    }
}

ExporsedReferenceについて

ExporsedReferenceはシーンにあるオブジェクトをタイムラインから参照する仕組みです。
似たような仕組みとして [SerializeField]がありますが、Timelineはアセットのためシーンのオブジェクトを参照できません。
（Prefabの[SerializeField]にシーン上のオブジェクトを指定できない挙動と同じものになります）
そのため実行時にシーンにあるオブジェクトを動的に取得する必要がありExporsedReferenceはそれを行うための仕組みです。
ExposedReferenceの詳しい仕組みはこちらの記事を参考にしてください。
動的に取得したオブジェクトにアクセスする為にはResolveメソッドを使用します。

VolumeTimelineBehaviourにVolumeを渡す

自作したSetTargetメソッドにVolumeを渡します。ここでActivationControlPlayable.PostPlaybackState.Inactiveを指定することで、クリップの再生が終了時にgameObjectが非アクティブになります。

ScriptPlayableを生成して返す

ScriptPlayabeはPlayableGraphでグラフのノード生成に必要なクラスです。
タイムラインはPlayableGraphを利用するため、ScriptPlayableを生成する必要があります。TimelineとPlayableGraphの詳細についてはUnityのマニュアルを参考にしてください。

これで、タイムラインが再生されている時だけVolumeがアクティブになります。

自作トラックを再生してみる

VolumeTimelineTrackを作って、Volumeを配置します。

再生してみます。

Volumeを切り替えるトラックを作成することができました。

フェードを実装する

これまでの実装でVolumeを切り替えることができたので、次はクリップが重なってる部分をフェードする処理を実装します。

実装方針

画像の通り、VolumeはWeightを操作することで、2つのパラメーターをブレンドできます。

以下の実装方針を建てます

VolumeTimelineBehaviourからVolumeのWeight設定できるようにする
タイムラインのクリップの重なり合いを取得しVolumeのWeightに設定する

1. VolumeTimelineBehaviourからVolumeのWeight設定できるようにする

VolumeTimelineBehaviourを以下のように変更してVolumeTimelineBehaviourからVolumeのWeightを設定できるようにします。

VolumeTimelineBehaviour.cs

public class VolumeTimelineBehaviour : ActivationControlPlayable
{
    private Volume _volume;

    public void SetTarget(Volume volume, PostPlaybackState postPlaybackState)
    {
        _volume = volume;
        gameObject = volume.gameObject;
        postPlayback = postPlaybackState;
    }

    public void SetWeight(float weight)
    {
        if (_volume != null)
        {
            _volume.weight = weight;
        }
    }
}

タイムラインのクリップの重なり合いを取得しVolumeのWeightに設定するタイムラインのクリップの重なり合いを取得する為に VolumeTimelineMixerBehaviourクラスを作成します。

VolumeTimelineMixerBehaviour.cs

public class VolumeTimelineMixerBehaviour : PlayableBehaviour
{
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        int inputCount = playable.GetInputCount();
        for (int i = 0; i < inputCount; i++)
        {
            var inputPlayable = (ScriptPlayable<VolumeTimelineBehaviour>) playable.GetInput(i);
            float inputWeight = playable.GetInputWeight(i);
            if (inputWeight > 0)
            {
                inputPlayable.GetBehaviour().SetWeight(inputWeight);
            }
        }
    }
}

ProcessFrame内の処理について

ProcessFrameはタイムライン再生中に毎フレーム呼び出されます。
playable.GetInput()メソッドにより、トラックに存在するクリップの情報を取得し、これをScriptPlayable<VolumeTimelineBehaviour>にキャストする事で、VolumeTimelineBehaviourを取得します。
取得したクリップのWeightをVolumeTimelineBehaviour.SetWeight()メソッドに渡す事で、VolumeのWeightを設定します。

VolumeTimelineMixerBehaviourの役割

VolumeTimelineMixerBehaviourはトラック全体の振る舞いを設定します。
VolumeTimelineMixerBehaviourはトラック全体の振る舞いを制御するクラスで、具体的には以下のような処理を担当します。

クリップのWeightを取得する
再生中に毎フレーム呼ばれるメソッドで処理を実装する

VolumeTimelineMixerBehaviourを使うように設定する

VolumeTimelineTrackクラスを変更して、VolumeTimelineMixerBehaviourが呼び出されるように設定します。

VolumeTimelineTrack.cs

[Serializable]
[TrackClipType(typeof(VolumeTimelineAsset), false)]
public class VolumeTimelineTrack : PlayableTrack
{
    public override Playable CreateTrackMixer(PlayableGraph graph, GameObject go, int inputCount)
    {
        return ScriptPlayable<VolumeTimelineMixerBehaviour>.Create (graph, inputCount);
    }
}

再生する

クリップの切り替わり時にフェードするトラックが実装できました！

再生終了時に変更したパラメーターを元に戻す

最後に、再生終了後にタイムラインが変更したパラメーターが自動で戻るようにGatherPropertiesを設定します。

VolumeTimelineAsset.cs

public class VolumeTimelineAsset : PlayableAsset, IPropertyPreview
{
    public ExposedReference<Volume> volume;

    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        Volume resolvedVolume = volume.Resolve(graph.GetResolver());
        if (resolvedVolume == null)
        {
            return default;
        }

        VolumeTimelineBehaviour behaviour = new VolumeTimelineBehaviour();
        behaviour.SetTarget(resolvedVolume, ActivationControlPlayable.PostPlaybackState.Inactive);
        return ScriptPlayable<VolumeTimelineBehaviour>.Create(graph, behaviour);
    }

    public void GatherProperties(PlayableDirector director, IPropertyCollector driver)
    {
        // Volumeのweightとenabledをタイムライン終了時に戻す
        Volume resolvedVolume = director.GetReferenceValue(volume.exposedName, out var isValid) as Volume;
        if (isValid)
        {
            driver.AddFromName(resolvedVolume, "weight");
            if (resolvedVolume != null)
            {
                driver.AddFromName(resolvedVolume.gameObject, "m_IsActive");
            }
        }
    }
}

GatherPropertiesについて

GatherPropertiesを使用するためにIPropertyPreviewインターフェイスを実装します。driver.AddFromNameメソッドは元に戻すパラメーターのシリアライズ名を入力します。このメソッドを作成する事で、タイムラインが変更を加えたパラメーターが自動で元に戻ります。
またGatherPropertiesを設定したパラメーターは青色になり、インスペクターから確認する事ができます。

補足）最終的なコード

VolumeTimelineAsset.cs

[Serializable]
public class VolumeTimelineAsset : PlayableAsset
{
    public ExposedReference<Volume> volume;

    public override Playable CreatePlayable(PlayableGraph graph, GameObject owner)
    {
        Volume resolvedVolume = volume.Resolve(graph.GetResolver());
        if (resolvedVolume == null)
        {
            return default;
        }

        VolumeTimelineBehaviour behaviour = new VolumeTimelineBehaviour();
        behaviour.SetTarget(resolvedVolume, ActivationControlPlayable.PostPlaybackState.Inactive);
        return ScriptPlayable<VolumeTimelineBehaviour>.Create(graph, behaviour);
    }
}

VolumeTimelineBehaviour.cs

public class VolumeTimelineBehaviour : ActivationControlPlayable
{
    private Volume _volume;

    public void SetTarget(Volume volume, PostPlaybackState postPlaybackState)
    {
        _volume = volume;
        gameObject = volume.gameObject;
        postPlayback = postPlaybackState;
    }

    public void SetWeight(float weight)
    {
        if (_volume != null)
        {
            _volume.weight = weight;
        }
    }
}

VolumeTimelineMixerBehaviour.cs

public class VolumeTimelineMixerBehaviour : PlayableBehaviour
{
    public override void ProcessFrame(Playable playable, FrameData info, object playerData)
    {
        int inputCount = playable.GetInputCount();
        for (int i = 0; i < inputCount; i++)
        {
            var inputPlayable = (ScriptPlayable<VolumeTimelineBehaviour>) playable.GetInput(i);
            float inputWeight = playable.GetInputWeight(i);
            if (inputWeight > 0)
            {
                inputPlayable.GetBehaviour().SetWeight(inputWeight);
            }
        }
    }
}

VolumeTimelineTrack.cs

[Serializable]
[TrackClipType(typeof(VolumeTimelineAsset), false)]
public class VolumeTimelineTrack : PlayableTrack
{
    public override Playable CreateTrackMixer(PlayableGraph graph, GameObject go, int inputCount)
    {
        return ScriptPlayable<VolumeTimelineMixerBehaviour>.Create (graph, inputCount);
    }
}

Unityタイムライン拡張入門 ~自作トラックの作り方~

はじめに

比較

環境

UniversalRenderPipelineについて

検証用のポストエフェクトを用意する

タイムライントラックを自作する

それぞれのクラスの役割

VolumeTrack

VolumeTimelineBehaviour

VolumeTimelineAsset

実装方針

1. トラック上にクリップを作れるようにする

2. クリップを再生している時にVolumeをアクティブにし、それ以外は非アクティブにする

3. タイムラインで制御するVolumeを指定できるようにする

ExporsedReferenceについて

VolumeTimelineBehaviourにVolumeを渡す

ScriptPlayableを生成して返す

自作トラックを再生してみる

フェードを実装する

実装方針

1. VolumeTimelineBehaviourからVolumeのWeight設定できるようにする

ProcessFrame内の処理について

VolumeTimelineMixerBehaviourの役割

VolumeTimelineMixerBehaviourを使うように設定する

再生する

再生終了時に変更したパラメーターを元に戻す

GatherPropertiesについて

補足）最終的なコード