UnityUI와 연출

Animator 파라미터 기본

상태 전환을 코드에서 제어하기 위해 `Animator`의 Bool, Float, Trigger 파라미터를 다루는 기본 패턴입니다.

마지막 수정 2026년 3월 19일

기본 패턴

csharp
animator.SetBool("IsRunning", true);
animator.SetTrigger("Attack");

설명

  • Animator Controller는 상태와 전이 조건을 시각적으로 관리하고, 파라미터는 그 조건을 코드에서 바꾸는 통로입니다.
  • Bool은 상태 유지형 조건, Float는 속도 같은 연속 값, Trigger는 한 번성 이벤트에 자주 쓰입니다.
  • 이동, 공격, 피격, UI 열림/닫힘 같은 연출 전환을 코드와 애니메이터 사이에서 연결할 때 핵심입니다.
  • 문자열 이름을 반복해서 쓰는 대신 해시나 상수로 정리하면 실수를 줄이기 쉽습니다.

짧은 예제

csharp
[SerializeField] private Animator animator;

private void Update()
{
    float speed = Mathf.Abs(Input.GetAxisRaw("Horizontal")) + Mathf.Abs(Input.GetAxisRaw("Vertical"));
    animator.SetFloat("Speed", speed);

    if (Input.GetKeyDown(KeyCode.Space))
    {
        animator.SetTrigger("Jump");
    }
}

빠른 정리

항목설명
SetBool유지형 상태 전환
SetFloat연속 값 전달
SetTrigger한 번성 이벤트 전달
상태 전이Animator Controller에서 조건으로 사용
코드 연결입력, 이동, 전투 로직과 애니메이션 연결

주의할 점

파라미터 이름이 Animator Controller와 한 글자라도 다르면 조용히 동작이 어긋날 수 있습니다. 문자열 상수나 Animator.StringToHash로 관리하는 팀도 많습니다.

참고 링크

2 sources