Unity OnGUI 버튼 만들기: GUI.Button 예제와 Unity 6에서의 선택

기존 Unity 프로젝트에서 OnGUI 버튼을 유지해야 한다면 GUI.Button의 반환값으로 클릭을 처리할 수 있습니다. 다만 Unity 6의 새 게임 화면 UI에는 uGUI 또는 UI Toolkit을 먼저 검토하세요. 아래 세 장은 2015년 IMGUI 예제의 스크립트 연결, 코드, 실행 결과를 순서대로 보여주는 구버전 화면입니다.

직접 답
OnGUI() 안에서 if (GUI.Button(new Rect(x, y, width, height), "버튼"))처럼 작성하면 클릭한 프레임에 true가 됩니다. 빠른 디버그 화면이나 레거시 유지에는 쓸 수 있지만, 해상도 대응과 복잡한 런타임 UI에는 적합하지 않습니다.

첫 화면은 스크립트를 GameObject에 연결하는 단계입니다

2015년 Unity에서 OnGUI 버튼 스크립트를 GameObject에 연결한 Inspector 화면
2015년 Unity Inspector에서 버튼 스크립트를 연결한 화면입니다. 화면 속 선택 위치는 당시 에디터 기준이며 현재 버전에서는 Inspector 구성과 메뉴가 다를 수 있습니다.

OnGUI가 들어 있는 클래스는 MonoBehaviour를 상속하고, 활성화된 GameObject의 컴포넌트로 붙어 있어야 호출됩니다. 코드만 프로젝트 폴더에 넣고 컴포넌트로 연결하지 않으면 Game 뷰에 버튼이 나타나지 않아요. Inspector에서 스크립트 이름이 보이고 체크박스가 활성화됐는지 확인합니다.

두 번째 화면의 핵심은 Rect와 반환값입니다

Unity OnGUI 함수 안에서 GUI.Button과 Rect를 작성한 C# 코드 화면
코드 화면에서 강조된 GUI.Button과 Rect가 버튼의 클릭 처리와 위치·크기를 정합니다.
using UnityEngine;

public class LegacyButtonExample : MonoBehaviour
{
    private void OnGUI()
    {
        if (GUI.Button(new Rect(20, 20, 160, 40), "점수 올리기"))
        {
            Debug.Log("버튼 클릭");
        }
    }
}

Rect의 네 값은 왼쪽 위치, 위쪽 위치, 너비, 높이 순서입니다. 이 값은 픽셀 좌표라 화면 비율이 달라지면 같은 크기로 보이지 않을 수 있습니다. 버튼을 누른 프레임에는 GUI.Button이 true를 반환하므로 그 안에서 상태 변경이나 메서드 호출을 처리합니다.

세 번째 화면은 Game 뷰의 기대 결과입니다

2015년 Unity Game 뷰에 OnGUI 버튼이 표시된 실행 결과
Play 모드의 Game 뷰에 버튼이 표시된 결과입니다. 앞의 스크립트 연결과 코드가 모두 정상일 때 기대할 화면입니다.

버튼이 보이지 않으면 Console의 컴파일 오류, 스크립트가 붙은 GameObject의 활성 상태, OnGUI 철자와 대소문자를 차례로 확인하세요. 클릭은 되는데 원하는 작업이 실행되지 않으면 Debug.Log로 조건문 진입 여부부터 나눠 보는 편이 빠릅니다.

새 프로젝트에서 OnGUI를 그대로 쓰지 않는 이유

IMGUI는 화면을 그릴 때마다 코드가 실행되는 즉시 모드 방식입니다. 간단한 디버그 버튼이나 에디터 도구에서는 코드 몇 줄로 결과를 볼 수 있지만, 많은 요소를 배치하고 스타일·접근성·다양한 해상도를 관리하기에는 불편합니다. Unity 공식 문서는 게임 런타임 UI에는 Unity UI를 권장하고, 에디터 UI에는 UI Toolkit을 권장합니다.

따라서 기존 강좌를 따라 재현하는 목적이라면 위 코드를 사용하되, 실제 메뉴·HUD·설정 창을 새로 만든다면 Canvas 기반 uGUI나 UI Toolkit Button으로 옮길 계획을 함께 세우세요. 오래된 화면의 빨간 네모나 화살표가 있다면 삭제하지 말고, 무엇을 가리켰는지 캡션에서 설명해야 절차 정보가 남습니다.

UI Toolkit 버튼으로 바꿀 때 달라지는 점

UI Toolkit의 Button은 요소를 한 번 만들고 클릭 콜백을 연결하는 보류 모드 방식입니다. UXML과 USS로 구조와 스타일을 나눌 수도 있고 C#에서 직접 만들 수도 있어요.

var button = new Button(() => Debug.Log("버튼 클릭"))
{
    text = "점수 올리기"
};
rootVisualElement.Add(button);

어느 방식이 무조건 우월한 것이 아니라 목적이 다릅니다. 레거시 코드 복구와 빠른 디버그 도구에는 IMGUI가 간단하고, 새 런타임 화면에는 uGUI 또는 UI Toolkit이 유지보수하기 좋습니다.

공식 자료

기존 이미지는 2015년 Unity에서 직접 캡처된 자료를 재사용했습니다. 표시 위치의 의미는 보존했으며, 현재 메뉴와 권장 UI 방식은 Unity 6 공식 문서를 기준으로 보완했습니다.

댓글 쓰기

0 댓글