---
title: 인스펙터에서 설정할 수 있는 커스텀 이벤트
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/unity-events
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/object-oriented-development/managing-update-order/unity-events.md
generated_at: 2026-11-19T13:46:13.607Z
locale: ko-kr
---

# 인스펙터에서 설정할 수 있는 커스텀 이벤트

> 사용자 지정 이벤트를 생성하여 인스펙터 창에서 영구적인 (lasting between Edit mode and Play mode) 콜백을 구성합니다.

Unity는 표준 C# [이벤트 및 델리게이트](https://learn.microsoft.com/en-us/dotnet/standard/events/)에 대한 Unity 전용 대안으로 [UnityEvent](/engine/6000.0/script-reference/unityengine/events/unityevent.md) API를 제공합니다. 일반 C# 이벤트보다 Unity 이벤트의 주요 이점은 Unity 이벤트가 직렬화 가능하다는 점입니다. 즉, [인스펙터 창](/engine/6000.0/manual/unity-editor/editor-windows-views-reference/using-the-inspector.md)에서 설정할 수 있습니다.

`UnityEvent`는 모든 `MonoBehaviour`에 추가할 수 있으며 표준 C# 델리게이트처럼 런타임 시 실행됩니다. `MonoBehaviour`에서 `UnityEvent`가 선언되면 Edit 시간과 Runtime 사이에 유지되는 콜백을 정의할 수 있는 Editor 창에 표시됩니다.

Unity 이벤트에는 표준 C# 델리게이트와 유사한 제한 사항이 있습니다.

* 타겟 오브젝트에 대한 레퍼런스가 포함되어 타겟 오브젝트가 가비지 컬렉션되는 것을 막습니다.
* 대상으로 관리되는 (C#) `UnityEngine.Object`가 있고 관리되지 않는 (C++) 상대 오브젝트가 삭제된 경우 콜백이 호출되지 않습니다. 자세한 내용은 [오브젝트](/engine/6000.0/manual/scripting/object-oriented-development/fundamental-unity-types/class-object.md)를 참조하십시오.

## Unity 이벤트 구성##configure-unity-events

### 필수 조건##prerequisites

* `using UnityEngine.Events`를 포함하는 MonoBehaviour 스크립트 만들기
* `UnityEvent` 유형의 필드 하나 이상 선언

### 인스펙터 창 콜백을 설정합니다.##configure-callbacks-in-the-inspector-window:

1. 선언된 `UnityEvent` 필드가 포함된 스크립트 컴포넌트가 있는 게임 오브젝트를 선택합니다.

2. 이벤트 이름 아래의 + 버튼을 클릭 수 콜백의 슬롯을 추가합니다.

3. 콜백을 수신할 [UnityEngine.Object](/engine/6000.0/manual/scripting/object-oriented-development/fundamental-unity-types/class-object.md)를 선택합니다. 오브젝트 선택기를 사용하거나 오브젝트를 필드로 드래그 앤 드롭할 수 있습니다.

4. 이벤트가 발생할 때 호출될 함수를 선택합니다. 드롭다운 선택기는 게임 오브젝트와 해당 구성 요소에서 사용할 수 있는 [적절한 메서드](#static-dynamic-calls)의 필터링된 목록으로 채워집니다.

5. 필요에 따라 1-4단계를 반복하여 동일한 이벤트에 대한 추가 콜백을 추가합니다.


**Configuring callbacks for events called Trigger Entered and Trigger Exited in the Inspector window:**
![](/api/media?file=/engine/6000.0/media/images/unityevents-inspector.PNG)

### 정적 및 동적 호출##static-and-dynamic-calls

**인스펙터(Inspector)** 창에서 `UnityEvent`를 구성할 때 두 가지 유형의 함수 호출이 지원됩니다.

* **정적** 호출은 작성 시에 완전히 미리 구성되며, 대상 및 파라미터 값은 인스펙터 창에 정의됩니다. 콜백이 호출되면 타겟 함수가 인스펙터에 정의된 파라미터 값으로 호출됩니다. 이는 런타임 시 변하지 않는 값에 적합합니다. 예를 들어 특정 충돌이 발생할 때마다 체력 값을 일정 양만큼 줄이려는 경우가 있습니다. 정적으로 바인딩된 함수는 함수 선택 목록의 **정적 파라미터** 아래에 나타납니다.
* **동적** 호출은 호출되는 `UnityEvent` 유형과 일치하는 파라미터로 코드에서 프로그래밍 방식으로 호출됩니다. 이는 런타임 시점에 달라지는 값에 적합합니다. 예를 들어 캐릭터가 각 공격에서 입은 손상의 변수를 나타내는 `float`입니다. UI는 콜백을 필터링하고, 해당 `UnityEvent` 유형에 유효한 서명이 있는 동적 함수만 표시합니다. 예를 들어 `UnityEvent<string>`가 있는 경우 함수 선택자는 **동적 문자열** 헤더 아래에 `string` 파라미터를 허용하는 모든 함수를 나열합니다.


**Choosing between static or dynamic functions whose signatures match the event type in the Inspector window:**
![](/api/media?file=/engine/6000.0/media/images/unityevents-dynamic-static.PNG)

## UnityEvent의 일반 지원##generic-support-in-unityevent

기본적으로 `Monobehaviour`의 `UnityEvent`는 `void` 함수에 동적으로 바인딩됩니다. 그러나 다음 예시와 같이 최대 4개의 일반 타입 파라미터로 `UnityEvent`를 만들 수 있습니다.

```lang-cs
using UnityEngine;
using UnityEngine.Events;

public class GenericTest : MonoBehaviour
{
    public UnityEvent<int, int, bool, string> myEvent;
    
    // Start is called once before the first execution of Update after the MonoBehaviour is created
    void Start()
    {
        if (myEvent == null)
        {
            myEvent = new UnityEvent<int, int, bool, string>();
        }
        myEvent.AddListener(Ping);
    }

    // Update is called once per frame
    void Update()
    {
        if (Input.anyKeyDown && myEvent != null)
        {
            myEvent.Invoke(5, 6, true, "Hello");
        }
    }

    void Ping(int i, int j, bool print, string text)
    {
        if (print)
        {
            Debug.Log("Ping: " + text + i + j);
        }
    }
}
```

## 추가 리소스##additional-resources

* [드래그 앤 드롭 이벤트로 문, 트리거 등을 설정합니다.](https://youtu.be/tmmvhxQcbJk)
* [UnityEvent API 레퍼런스](/engine/6000.0/script-reference/unityengine/events/unityevent.md)
