Coroutine 핵심 키워드

Coroutine 핵심 키워드 정리

키워드	설명
IEnumerator	코루틴 함수의 반환형. yield 를 사용할 수 있게 해준다.
yield return	코루틴을 잠시 중단 ( 대기 ) 하고, 이후 다시 이어지게 하는 핵심 구문이다.
yield break	코루틴을 즉시 종료한다
StartCoroutine( )	코루틴을 실행시킬 때 사용하는 함수이다.
StopCoroutine( )	특정 코루틴을 중단할 때 사용한다.
StopAllCoroutines( )	현재 실행 중인 모든 코루틴을 중단한다.

 

 

대기 관련 정리

구문	설명
yield return null;	한 프레임 대기 후 다음 코드 실행 ( Update( ) ) 와 비슷하다
yield return new WaitForSeconds(float seconds);	지정한 초 만큼 대기한다.
yield return new WaitForEndOfFrame( );	프레임 렌더링이 끝날 때까지 대기한다.
yield return new WaitForFixedUpdate( );	다음 FixedUpdate( ) 전까지 대기 ( 물리 계산 주기와 맞춘다 )
yield return new WaitUntil(( ) => condition);	조건이 참이 될 때까지 대기한다.
yield return new WaitWhile(( ) => condition);	조건이 거짓이 될 때까지 대기한다.

 

 

추가적으로 함께 자주 사용하는 키워드

키워드	관련 내용
Start( ) / Update( )	코루틴 실행 타이밍 제어와 연계된다
Time.deltaTime	프레임 독립적인 시간 계산 ( 코루틴 내에서도 자주 사용 )
bool 변수	조건 반복이나 중단 제어용 ( while ( isRunning ) 등 )
while , for	반복 대기 패턴 구현 시 사용한다

 

 

 

정리

세부 분류	예시 키워드	설명 요약
코루틴 기본 문법	IEnumerator , yield return , yield break	코루틴 핵심 구조와 흐름 제어
코루틴 관리 함수	StartCoroutine , StopCoroutine , StopAllCoroutines	코루틴 시작과 중단 관련 함수
대기 제어	WaitForSeconds , WaitUntil , WaitWhile , WaitForEndOfFrame	시간 또는 조건 기반 대기
흐름 보조	null , while , Time.deltaTime	프레임 제어 및 반복 흐름 구현
응용 패턴	Fade , Spawn , Move , LoadScene	실제 게임 내 코루틴 활용 사례

 

 

 

참고 자료

https://docs.unity3d.com/kr/2021.3/Manual/Coroutines.html