sequence

# 시퀀스 시스템

await/Coroutine 지옥 없이 게임 연출 흐름을 선언적 스텝 목록으로 구성합니다.

구조

SequenceAsset (ScriptableObject)
  [SerializeReference] List<SequenceStep>

SequenceRunner (MonoBehaviour)
  — 스텝을 순서대로 코루틴 실행

SequenceStep (abstract, [Serializable])
  — 커스텀 스텝을 상속해서 구현

기본 제공 스텝

스텝	설명
`WaitStep`	N초 대기
`MoveStep`	Transform을 목적지로 이동 (이징 지원)
`FadeStep`	CanvasGroup 알파 애니메이션
`ScaleStep`	Transform 스케일 애니메이션
`SoundStep`	AudioClip 재생
`CallbackStep`	UnityEvent 호출

빠른 시작

방법 A — SequenceAsset (에디터 설정)

Create → AchUtils/Sequence/Sequence Asset

인스펙터에서 스텝 추가 후 실행:

using AchUtils.Sequence;

[SerializeField] SequenceAsset introSequence;
[SerializeField] SequenceRunner runner;

void PlayIntro()
{
    runner.Run(introSequence);
}

방법 B — 코드로 구성

var steps = new List<SequenceStep>
{
    new FadeStep  { Target = overlay,    TargetAlpha = 1f, Duration = 0.3f },
    new WaitStep  { Duration = 0.5f },
    new MoveStep  { Target = boss,       Destination = centerPos, Duration = 1f },
    new ScaleStep { Target = boss,       TargetScale = Vector3.one * 1.5f, Duration = 0.3f },
    new SoundStep { Clip = bossRoar },
    new FadeStep  { Target = overlay,    TargetAlpha = 0f, Duration = 0.5f },
};

runner.Run(steps);

API

SequenceRunner

// 실행
void Run(SequenceAsset asset)
void Run(IEnumerable<SequenceStep> steps)
void Stop()

bool IsRunning

event Action OnCompleted
event Action OnStopped

MoveStep

Transform       Target
Vector3         Destination
float           Duration        // 초
AnimationCurve  Ease            // 기본: EaseInOut
bool            UseLocalSpace   // true면 localPosition 사용

FadeStep

CanvasGroup     Target
float           TargetAlpha     // 0~1
float           Duration
AnimationCurve  Ease

ScaleStep

Transform       Target
Vector3         TargetScale
float           Duration
AnimationCurve  Ease

SoundStep

AudioClip       Clip
float           Volume              // 0~1
bool            WaitUntilFinished   // true면 클립 재생 완료 대기

SoundStep은 Camera.main에 의존하지 않고 SequenceRunner 위치에서 클립을 재생합니다.

CallbackStep

UnityEvent      OnExecute           // 인스펙터에서 연결

커스텀 스텝 만들기

[Serializable]
public class ShowPanelStep : SequenceStep
{
    public GameObject Panel;
    public float HoldDuration = 2f;

    public override IEnumerator Execute(SequenceRunner runner)
    {
        Panel.SetActive(true);
        yield return new WaitForSeconds(HoldDuration);
        Panel.SetActive(false);
    }
}

[Serializable]만 붙이면 [SerializeReference] 필드에서 인스펙터 선택이 가능합니다.

완료 이벤트

runner.OnCompleted += () =>
{
    Debug.Log("인트로 연출 완료");
    StartGameplay();
};

runner.Run(introSequence);

연출 예시 — 보스 등장

FadeStep     오버레이 Fade In  (0.3s)
WaitStep     0.5s 대기
MoveCameraAction  보스 방향 이동  ← CameraDirector와 병행 가능
MoveStep     보스 등장 이동  (1.5s, EaseOut)
ScaleStep    보스 스케일 업  (0.5s, Bounce)
SoundStep    보스 포효
FadeStep     오버레이 Fade Out (0.5s)
CallbackStep UI 표시 이벤트

sequence

목차