【Unity】TimelineをScriptから扱うときのTips

/// <summary>
/// オブジェクトをタイムラインのトラックにバインドさせる
/// </summary>
///
/// <param name="trackName"> トラック名 </param>
/// <param name="sourceComponent"> 紐づけたいオブジェクト </param>
public void BindTrack( string trackName, UnityEngine.Object sourceObject)
{
    foreach( PlayableBinding bind in GetPlayableDirector().playableAsset.outputs )
    {
        if( bind.streamName == trackName )
        {
            GetPlayableDirector().SetGenericBinding( bind.sourceObject, sourceObject );
            break;
        }
    }
}

/// <summary>
/// T型のバインドタイプを持ったトラックにT型のオブジェクトの参照を渡す
/// </summary>
///
/// <param name="bindObject"> バインドするオブジェクト </param>
public void BindObject<T>( T bindObject ) where T : UnityEngine.Object
{
    var outputTracks = (GetPlayableDirector().playableAsset as TimelineAsset).GetOutputTracks();
    foreach( TrackAsset trackAsset in outputTracks )
    {
        foreach( PlayableBinding binding in trackAsset.outputs )
        {
            if( binding.outputTargetType == typeof( T ) )
            {
                GetPlayableDirector().SetGenericBinding( binding.sourceObject, bindObject );
            }
        }
    }
}

/// <summary>
/// タイムラインクリップの取得
/// </summary>
///
/// <param name="trackName"> トラック名 </param>
/// <param name="clipName"> クリップ名 </param>
///
/// <returns>
/// タイムラインクリップ
/// </returns>
public TimelineClip FindTimelineClip( string trackName, string clipName )
{
    TimelineAsset timelineAsset = GetPlayableDirector().playableAsset as TimelineAsset;
    
    if( timelineAsset != null )
    {
        // トラックからクリップリストの取得
        IEnumerable<TrackAsset> tracks = timelineAsset.GetOutputTracks();
        
        foreach( TrackAsset track in tracks )
        {
            if( string.IsNullOrEmpty( trackName ) == false && track.name != trackName )
            {
                continue;
            }
            
            foreach( TimelineClip timelineClip in track.GetClips() )
            {
                if( timelineClip.displayName == clipName )
                {
                    return timelineClip;
                }
            }
        }
    }
    
    return null;
}

/// <summary>
/// タイムラインクリップの全取得
/// </summary>
///
/// <param name="trackName"> トラック名 </param>
///
/// <returns>
/// タイムラインクリップリスト
/// </returns>
public List<TimelineClip> FindTimelineClipList( string trackName )
{
    // タイムラインアセットに変換
    TimelineAsset timelineAsset = GetPlayableDirector().playableAsset as TimelineAsset;
    
    if( timelineAsset != null )
    {
        // トラックからクリップリストの取得
        IEnumerable<TrackAsset> tracks = timelineAsset.GetOutputTracks();
        TrackAsset track = tracks.FirstOrDefault( e => e.name == trackName );
        IEnumerable<TimelineClip> clips = track.GetClips();
        List<TimelineClip> result = clips.ToList();
        return result;
    }

    return null;
}

/// <summary>
/// ヴァーチャルカメラを検索してリストに追加する
/// </summary>
private List<CinemachineVirtualCamera> FindVirtualCameras()
{
    List<CinemachineVirtualCamera> timelineVirtualCameras = new List<CinemachineVirtualCamera>();
    var outputTracks = (GetPlayableDirector().playableAsset as TimelineAsset).GetOutputTracks();

    foreach( TrackAsset trackAsset in outputTracks )
    {
        if( trackAsset is CinemachineTrack )
        {
            foreach( TimelineClip timelineClip in trackAsset.GetClips() )
            {
                CinemachineShot cinemachineShot = null;
                cinemachineShot = timelineClip.asset as CinemachineShot;

                if( cinemachineShot != null )
                {
                    bool result;
                    CinemachineVirtualCamera cinemachineVirtualCamera = GetPlayableDirector().GetReferenceValue( cinemachineShot.VirtualCamera.exposedName, out result ) as CinemachineVirtualCamera;
                    
                    if( result )
                    {
                        timelineVirtualCameras.Add( cinemachineVirtualCamera );
                    }
                }
            }
        }
    }
    
    return timelineVirtualCameras;
}