---
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/coroutines-section/coroutines
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines.md
generated_at: 2026-11-19T13:46:15.438Z
locale: ko-kr
---

# 코루틴 작성 및 실행

> 코루틴 메서드를 작성하고 실행하여 점진적 페이드아웃 효과와 같이 여러 프레임에 영향을 미치는 작업을 수행합니다.

코루틴은 실행을 일시 중지하고 나중에 다시 실행할 수 있는 메서드입니다. Unity 애플리케이션에서 코루틴은 한 프레임에서 실행을 시작한 다음 다른 프레임에서 다시 실행할 수 있으므로 여러 프레임에 작업을 분산할 수 있습니다.

일반적인 코루틴이 아닌 메서드는 호출자에게 컨트롤을 반환하기 전에 완료되도록 실행되며, 이는 Unity 런타임에서 작업이 단일 프레임 업데이트 내에 완료된다는 의미입니다. 메서드의 작업이 점진적 페이드아웃 효과와 같이 여러 프레임에 걸쳐 적용되도록 하려는 경우 코루틴을 사용할 수 있습니다. 코루틴은 HTTP 전송 대기, 에셋 로드, 파일 I/O 완료 등 긴 비동기 작업을 처리하는 데 유용합니다.

> **Important:**
>
> 코루틴과 스레드를 혼동하지 마십시오. 코루틴 내에서 실행되는 동기 연산은 여전히 메인 스레드 실행됩니다. 메인 스레드 소비하는 CPU 시간을 줄이려면 다른 스크립트 코드 마찬가지로 코루틴에서 작업을 차단하지 않는 것이 중요합니다. Unity 멀티 스레드 코드를 사용하려면 다음 옵션을 사용하십시오.

* [직업 시스템](/engine/6000.0/manual/scripting/optimization/job-system.md)
* .NET [비동기 및 대기](/engine/6000.0/manual/scripting/optimization/async-await-support.md) 및 Unity의 커스텀 `Awaitable` 지원

## 코루틴 작성##writing-coroutines

오브젝트의 알파(불투명도) 값을 보이지 않을 때까지 점진적으로 줄이는 작업을 생각해 보겠습니다. 페이딩 효과가 보이게 하려면 프레임 순서에 따라 불투명도가 감소해야 합니다. `Fade` 메서드를 작성하려고 하면 다음과 같은 내용을 작성할 수 있습니다.

```lang-cs
void Fade()
{
    Color c = renderer.material.color;
    for (float alpha = 1f; alpha >= 0; alpha -= 0.1f)
    {
        c.a = alpha;
        renderer.material.color = c;
    }
}
```

이 메서드는 코루틴이 아니므로 단일 프레임 업데이트 내에서 모든 반복 `for` 루프를 실행하고 오브젝트가 페이드아웃되는 대신 즉시 사라집니다. 한 가지 가능한 솔루션은 프레임 단위로 페이드를 실행하는 `Update` 함수에 코드를 추가하는 것입니다. 그러나 코루틴을 사용하는 것이 더 편리할 수 있습니다.

코루틴은 실행이 일시 중지되는 지점인 [`IEnumerator`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerator) return type and a [성능](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/yield) return statement included somewhere in the body. The `yield return` 문이 있는 메서드입니다. 이전의 `Fade` 방법은 다음과 같이 코루틴으로 다시 작성할 수 있습니다.

```lang-cs
IEnumerator Fade()
{
    Color c = renderer.material.color;
    for (float alpha = 1f; alpha >= 0; alpha -= 0.1f)
    {
        c.a = alpha;
        renderer.material.color = c;
        출력 반환 null;
    }
}
```

이 버전의 메서드는 `yield return null` 문에서 실행을 일시 중지하기 전에 해당 `for` 루프의 한 번의 반복을 실행합니다. 다음 프레임에서 루프를 재개하고 또 다른 반복을 실행하여 점진적 페이드 효과를 표시합니다. `Fade` 메서드의 루프 카운터는 코루틴의 수명 주기 동안 올바른 값을 유지하며, 모든 변수 또는 파라미터는 `yield` 문 사이에 보존됩니다.

## 코루틴 시작 및 중지##starting-and-stopping-coroutines

코루틴 실행을 설정하려면 다음과 같이 [StartCoroutine](/engine/6000.0/script-reference/unityengine/monobehaviour/startcoroutine.md) 메서드를 사용하십시오.

```lang-cs
void Update()
{
    if (Input.GetKeyDown("f"))
    {
        StartCoroutine(Fade());
    }
}
```

코루틴을 중지하려면 [StopCoroutine](/engine/6000.0/script-reference/unityengine/monobehaviour/stopcoroutine.md)과 [StopAllCoroutines를](/engine/6000.0/script-reference/unityengine/monobehaviour/stopallcoroutines.md) 사용하십시오. 코루틴은 다음 경우에도 중지됩니다.

* 스크립트가 연결된 게임 오브젝트의 [`GameObject.activeSelf`](/engine/6000.0/script-reference/unityengine/gameobject/activeself.md) 값이 `false`가 됩니다.
* [Destroy](/engine/6000.0/script-reference/unityengine/object/destroy.md) 호출로 MonoBehaviour 스크립트가 파괴됩니다.

> **Note:**
>
> [활성화](/engine/6000.0/script-reference/unityengine/behaviour/enabled.md)를 `false`로 설정하여 MonoBehaviour 스크립트를 비활성화해도 코루틴이 중지되지 않습니다.

## 코루틴 재실행##resuming-coroutines

일시 중지된 코루틴이 실행을 재개하는 시점은 `yield return` 문에 제공된 yield 명령에 따라 달라집니다. 다음 프레임에서 `yield return null`가 재개됩니다. Unity 지정된 시간 후, 지정된 조건이 충족되거나 플레이어 루프의 특정 지점에서 다시 시작하는 데 사용할 수 있는 커스텀 yield 지침 세트가 있습니다. 자세한 내용은 [출력 지침 참조](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines-yield-instructions.md)를 참조하십시오.

페이드 효과 예시에서는 페이드 효과가 프레임 속도보다 더 낮고 일관된 속도로 발생하도록 할 수 있습니다. 다음과 같이 [`WaitForSeconds`](/engine/6000.0/script-reference/unityengine/waitforseconds.md) 명령을 `yield return`하여 `Fade` 메서드의 반복 간에 고정 시간 지연을 도입할 수 있습니다.

```lang-cs
IEnumerator Fade()
{
    Color c = renderer.material.color;
    for (float alpha = 1f; alpha >= 0; alpha -= 0.1f)
    {
        c.a = alpha;
        renderer.material.color = c;
        // Wait for 0.1 seconds before the next iteration
        yield는 새 WaitForSeconds(.1f)를 반환합니다.
    }
}
```

코루틴 내에서 Unity [`Awaitable`](/engine/6000.0/script-reference/unityengine/awaitable.md)를 `yield return`할 수도 있습니다. 이것은 `async` 및 `await`를 사용하는 비동기 코드와 코루틴을 통합하려는 경우에 유용할 수 있습니다. 예를 들어 이전 예시에서는 `yield return new WaitForSeconds(.1f)` 대신 `yield return Awaitable.WaitForSecondsAsync(.1f)`하여 동일한 효과를 얻을 수 있습니다.

> **Important:**
>
> 코루틴에서 일반 [`Awaitable<T0>`](/engine/6000.0/script-reference/unityengine/awaitable1.md)을 `yield return`하는 데는 지원되지 않습니다.

## 편집 모드의 코루틴##coroutines-in-edit-mode

코루틴은 주로 런타임 기능입니다. 연결된 [런타임 출력 지침](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines-yield-instructions.md)은 `UnityEngine` 네임스페이스에 있으며 에디터의 플레이 모드 또는 스탠드얼론 플랫폼 플레이어에서 실행됩니다. 스크립트가 [`[ExecuteInEditMode]`](/engine/6000.0/script-reference/unityengine/executeineditmode.md) 또는 [`[ExecuteAlways]`](/engine/6000.0/script-reference/unityengine/executealways.md) 속성을 사용하는 경우 편집 모드에서도 실행할 수 있지만 편집 모드의 업데이트 루프는 플레이어 루프만큼 고정되고 정규화되지 않습니다.

편집 모드에서 실행하도록 특별히 설계된 코루틴의 경우, [Editor Coroutines 패키지를 사용합니다](https://docs.unity3d.com/Packages/com.unity.editorcoroutines@latest).

## 테스트의 코루틴##coroutines-in-tests

Unity Test Framework Play 모드에서는 `[UnityTest]` 속성이 표시된 테스트를 코루틴으로 실행하여 테스트를 통해 Unity 에디터에 대한 커스텀 명령을 생성할 수 있습니다. 자세한 내용은 [에디터의 출력 지침](/engine/6000.0/manual/reference-custom-yield-instructions.md)을 참조하십시오.

## 코루틴 성능##coroutine-performance

코루틴을 잘못 사용하면 숨겨진 할당과 가비지 컬렉터 스파이크가 발생할 수 있습니다. 각 코루틴은 [`IEnumerator`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerator) 상태 머신을 생성합니다. 프레임별로 자주 시작하면 오버헤드가 할당되고 추가됩니다. `yield return null`는 할당하지 않고 `new WaitForSeconds`처럼 명령을 생성합니다. 일반적으로 재사용되는 램프를 캐시하고 [`WaitUntil`](/engine/6000.0/script-reference/unityengine/waituntil.md) 및 [`WaitWhile`](/engine/6000.0/script-reference/unityengine/waitwhile.md)에서 램프를 방지하여 델리게이트 및 캡처 할당을 방지합니다.

반복적으로 새 코루틴을 시작하는 대신 `yield return null`와 반복되는 수명이 긴 코루틴을 선호하십시오. 일정 기간의 캐시 또는 풀 [`WaitForSeconds`](/engine/6000.0/script-reference/unityengine/waitforseconds.md) 코루틴은 해당 소유자와 캡처된 변수에 대한 레퍼런스를 유지합니다. 누수를 피하기 위해 [`MonoBehaviour.StopCoroutine`](/engine/6000.0/script-reference/unityengine/monobehaviour/stopcoroutine.md)로 끝내거나 중지해야 합니다.

특히 제약이 있는 플랫폼에서는 항상 프로파일링하여 할당을 확인하고 찾습니다. 자세한 내용은 [코루틴 분석](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines-analyzing.md)을 참고하십시오.

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

* [Coroutine API 레퍼런스](/engine/6000.0/script-reference/unityengine/coroutine.md)
* [MonoBehaviour.StartCoroutine](/engine/6000.0/script-reference/unityengine/monobehaviour/startcoroutine.md)
