Quick Reference

페이드와 입력 차단은 CanvasGroup, 스크립트까지 멈추는 완전한 숨김은 SetActive(false), 렌더링만 끄려면 Canvas.enabled를 사용합니다.

• 기준 버전은 Unity 6.5 (6000.5), Unity UI (UGUI) 2.0.0입니다. 화면에서 안 보임, 입력을 안 받음, 오브젝트가 비활성임은 서로 다른 상태입니다.
• 페이드하는 팝업은 CanvasGroup.alpha, interactable, blocksRaycasts를 함께 바꿉니다.
• 패널의 MonoBehaviour와 하위 오브젝트까지 멈춰야 하면 GameObject.SetActive(false)를 씁니다.
• 렌더링만 끄되 GameObject와 스크립트 수명주기는 유지하려면 Canvas.enabled를 씁니다. 페이드 중에는 끄지 않습니다.

Inspector 설정

CanvasGroup은 자신과 자식 UI의 표시와 UI raycast 처리를 묶어 제어합니다. 하위 Group이 여러 개면 alpha와 입력 조건이 계층을 따라 합쳐지므로, 상위 Group 하나의 값만 보고 판단하면 안 됩니다.

• Alpha의 기본은 1이며 값 범위는 0에서 1입니다. 자식 Graphic의 alpha와, 중첩 CanvasGroup의 alpha가 곱해집니다. 0은 보이지 않게 할 뿐 Update를 멈추거나 SetActive(false)가 되게 하지는 않습니다.
• Interactable의 기본은 켜짐입니다. Button, Toggle, Slider처럼 Selectable을 사용하는 자식이 상호작용 가능한지 정합니다. false로 하면 자식 버튼이 회색 상태와 비슷한 비활성 규칙을 따르지만, blocksRaycasts를 대신하지는 않습니다.
• Blocks Raycasts의 기본은 켜짐입니다. 이 Group 아래 Graphic이 GraphicRaycaster 입력 후보를 막을 수 있는지 정합니다. 숨긴 패널은 보통 false로 같이 바꿔 투명 blocker를 없앱니다.
• Ignore Parent Groups의 기본은 꺼짐입니다. 이 Group이 상위 CanvasGroup의 규칙을 무시하게 합니다. 부모 팝업을 흐리게 해도 자식 도움말만 독립적으로 유지해야 하는 제한적인 경우에만 씁니다. alpha 0인 부모 안에서 자식을 예외로 보이게 하려면 별도 Canvas가 필요한 경우가 있으므로, 단순한 페이드 해결책으로 켜지 않습니다.

스크립트 연결

표시 상태를 한 메서드에 모으면 alpha만 바꾸고 입력을 남기는 실수를 막을 수 있습니다. CanvasGroup은 이벤트 함수가 아니라 필드 값을 바꾸는 컴포넌트이므로, 애니메이션과 함께 써도 최종 입력 상태를 명시적으로 맞춥니다.

using UnityEngine;

public sealed class ModalVisibility : MonoBehaviour
{
    [SerializeField] private CanvasGroup group;
    [SerializeField] private Canvas canvas;

    public void SetVisible(bool visible)
    {
        group.alpha = visible ? 1f : 0f;
        group.interactable = visible;
        group.blocksRaycasts = visible;
    }

    public void DisableRendering()
    {
        canvas.enabled = false;
    }
}

// 완전 종료가 필요한 메뉴라면, 페이드가 끝난 시점에 호출합니다.
gameObject.SetActive(false);

• SetActive(false)는 해당 GameObject와 자식의 active 상태를 끕니다. 활성화된 MonoBehaviour에는 OnDisable이 호출되고, 다시 켤 때 OnEnable이 다시 들어올 수 있습니다. 구독 해제·재구독을 이 흐름에 맞춰 작성합니다.
• Canvas.enabled는 Canvas 컴포넌트의 렌더링을 끄는 선택입니다. 자식 GameObject를 inactive로 만들지 않으므로, 패널 수명주기를 끝내려는 의도라면 대체재가 아닙니다.
• CanvasGroup.IsRaycastLocationValid는 GraphicRaycaster가 내부적으로 raycast 허용 여부를 판단할 때 쓰는 ICanvasRaycastFilter 구현입니다. 보통 직접 호출하지 않고 blocksRaycasts를 설정합니다.

자주 틀리는 부분