Quick Reference

Timeline 1.8.12 기준입니다. Track은 "언제 무엇을 제어할지"를 역할별로 나누는 시간 축이고, Signal은 그 시간 축에서 코드로 넘기는 경계입니다. 기본 Signal Track에서는 SignalAsset을 SignalEmitter marker가 보내고, binding된 SignalReceiver가 UnityEvent로 받습니다.

SignalAsset "BossIntroFinished"
    -> SignalEmitter marker (Signal Track의 12.0초)
    -> Signal Track이 binding된 SignalReceiver로 notification 전송
    -> SignalReceiver reaction의 UnityEvent
    -> 게임 규칙 코드가 idempotent하게 상태 변경

Track을 나누는 기준

한 Track에는 한 가지 제어 책임을 둡니다. 캐릭터의 모션, Camera, 오디오, 게임 로직 호출을 Animation Track 하나에 억지로 묶으면 clip 이동 하나가 서로 다른 의도를 동시에 바꿉니다. Group Track은 관련 Track을 보기 좋게 묶는 용도이지 binding·재생 책임을 합치는 기능이 아닙니다.

Activation Track은 "해당 시점에 GameObject가 active인가"를 표현할 때 적합합니다. 하지만 pool에서 꺼내고 되돌리기, listener 등록 해제, 씬 전환 후 참조 정리는 Activation Track에 숨기지 않습니다. 어떤 시스템이 만든 오브젝트인지와 어떤 조건에서 반환할지는 코드가 소유합니다.

Control Track으로 sub-timeline이나 particle을 재생할 때는 중첩된 Director의 wrap·재생 시점을 부모의 Timeline과 맞춥니다. 자식 Director가 독자적으로 Play On Awake도 켜져 있으면, 부모가 아직 제어하기 전부터 재생되어 두 timeline이 같은 대상을 동시에 다룰 수 있습니다.

Signal 설정과 수신

1. Project 창에서 SignalAsset을 만들고, 의미가 드러나는 이름을 붙입니다.
2. Timeline의 Signal Track에 SignalEmitter marker를 두고 Asset에 그 SignalAsset을 지정합니다.
3. 수신 GameObject에 SignalReceiver를 붙이고, Director의 Bindings에서 그 Signal Track을 이 SignalReceiver에 연결합니다. Signal Track은 SignalReceiver를 binding 대상으로 사용합니다.
4. SignalReceiver의 reaction 목록에서 같은 SignalAsset을 등록하고 UnityEvent를 연결합니다. UnityEvent는 별도 MonoBehaviour의 public 메서드에 연결합니다.

SignalEmitter의 Emit Once는 Timeline이 loop될 때 그 signal을 한 번만 보낼지 정합니다. 반복 BGM cue처럼 loop마다 보내야 하는 signal에는 끄지만, 보상 지급·컷신 종료처럼 한 번만 발생해야 하는 이벤트에는 켜는 편이 안전합니다. Retroactive는 재생이 marker 시점 뒤에서 시작될 때도 signal을 보낼지 결정합니다. checkpoint에서 중간 재생할 때 필요한 초기화에는 쓸 수 있지만, 이미 끝난 퀘스트를 다시 완료시키는 신호에는 위험합니다.

using UnityEngine;
public sealed class CutsceneSignalHandler : MonoBehaviour
{
    [SerializeField] private QuestState questState;

    // SignalReceiver reaction의 UnityEvent에서 이 메서드를 지정합니다.
    public void CompleteIntro()
    {
        if (!questState.IntroCompleted)
        {
            questState.CompleteIntro();
        }
    }
}

SignalReceiver는 내부적으로 INotificationReceiver.OnNotify(Playable, INotification, object) 계약을 구현해 reaction을 실행합니다. 기본 Signal Track의 Inspector binding 타입은 SignalReceiver이므로, 일반 프로젝트에서는 UnityEvent를 public 메서드에 연결하는 경로가 가장 직접적입니다. 별도의 INotificationReceiver 구현체를 만들어 Signal Track의 대체 binding으로 넣을 수 있다고 가정하지 않습니다. custom notification을 직접 처리하려면 그 수신 타입을 지원하는 custom Track/Playable output까지 함께 설계합니다.

재생, seek, 반복에서의 안전성

Signal은 Timeline이 marker를 통과할 때 발생합니다. 따라서 Loop, replay, start time 변경, seek 뒤 Evaluate() 같은 재생 방식에 따라 같은 시점이 다시 평가될 수 있습니다. Timeline이 "한 번만 일어나야 하는 게임 규칙"을 보장한다고 가정하지 않습니다.

컷신을 보는 동안의 입력 잠금, HUD 숨김처럼 재생 동안 유지되는 상태는 시작과 종료를 대칭으로 처리합니다. Signal 하나로 시작만 하고 종료 signal이 누락되면, 중간 skip이나 씬 전환에서 입력이 영구히 잠긴 상태가 되기 쉽습니다. skip 경로는 Stop()만 호출하는 대신, 게임 상태·UI·Camera를 복구하는 단일 정리 함수를 호출하도록 설계합니다.

자주 틀리는 부분