기술 자료

Unity 엔진

Unity 엔진

이벤트 함수 실행 순서

이벤트에 응답하고 올바른 순서로 게임 상태를 업데이트할 수 있도록 Unity 빌트인 이벤트 함수의 실행 순서를 이해합니다.
읽는 시간 5분최근 업데이트: 9일 전

다음 다이어그램은 MonoBehaviour 스크립트 컴포넌트의 수명주기 동안 실행되는 이벤트 함수의 실행 순서에 대한 개략적인 개요를 제공합니다. 가독성을 위해 차트의 범위는 스크립트 라이프사이클의 주요 부분으로 제한되며, 컨텍스트에 대한 일부 추가 내부 보조 시스템 업데이트가 제공됩니다. 전체 플레이어 루프는 특정 시스템과 보조 시스템에 대한 더 길고 복잡한 업데이트 시퀀스로, 정의된 기본 순서로 하나씩 실행됩니다. 전체 플레이어 루프와 해당 시스템을 검색하려면 PlayerLoop API를 사용할 수 있습니다. 또한 이 API를 사용하여 시스템을 제거하고 시스템을 추가하고 업데이트 순서를 변경하여 플레이어 루프 시퀀스를 커스터마이즈할 수 있습니다.
각 콜백의 의미와 제한 사항에 대한 자세한 내용은 MonoBehaviour API 레퍼런스의 메시지 섹션을 참조하십시오.

Order of execution for event functions during the lifecycle of a MonoBehaviour script.

씬 로드 및 언로드 전

이전 다이어그램에는 씬이 각각 로드되고 언로드될 때 콜백을 수신할 수 있는
SceneManager.sceneLoaded
및
SceneManager.sceneUnloaded
이벤트가 표시되지 않습니다. Unity는 씬의 모든 오브젝트에 대해
OnEnable
이후 그러나
Start
전에
sceneLoaded
이벤트를 발생시킵니다. 자세한 내용과 사용 예제는 관련 API 레퍼런스 페이지를 참조하십시오.
실행 플로의 일부로 씬 로드를 포함하는 다이어그램은 도메인 및 씬 재로드 비활성화의 세부 정보를 참조하십시오.

에디터 실행 시 코드 실행

때로는 Unity 에디터 또는 런타임을 실행하는 즉시 코드의 일부를 실행하는 것이 유용할 수 있습니다. 추가 사용자 작업 없이 코드가 MonoBehaviour 스크립트의 일부가 될 필요가 없습니다. 정적 생성자가 있는 클래스에
[InitializeOnLoad]
속성을 적용하여 사용자 작업 없이 에디터 실행 시 코드를 실행할 수 있습니다. 또는 개별 메서드에
[InitializeOnLoadMethod]
속성을 적용할 수도 있습니다. 자세한 내용과 사용 예제는 이러한 속성에 대한 API 레퍼런스를 참조하십시오.

런타임 초기화 시 코드 실행

메서드에
[RuntimeInitializeOnLoadMethodAttribute]
를 적용하여 런타임 애플리케이션 초기화 시 코드를 실행할 수 있습니다. 또한
RunTimeInitializeLoadType
속성 파라미터를 지정하여 플레이어 루프에서 속성 코드가 실행되는 위치를 제어할 수도 있습니다. 이 속성으로 표시된 메서드의 실행 순서에 대한 자세한 내용은
RuntimeInitializeOnLoadMethodAttribute
에 대한 API 레퍼런스를 참조하십시오.

내부 애니메이션 업데이트

다음 다이어그램은 일반 애니메이션 업데이트 루프의 실행 순서를 보여주며 이전 다이어그램에서 내부 애니메이션 업데이트라고 표시된 노드를 확장합니다.

Order of execution for the regular Animation update loop.

다이어그램에 표시된 다음 애니메이션 루프 콜백은 MonoBehaviour에서 파생된 스크립트에서 호출됩니다.
추가 애니메이션 관련 이벤트 함수는
StateMachineBehaviour
에서 파생된 스크립트에서 호출됩니다.
다이어그램에 표시된 다른 애니메이션 함수는 애니메이션 시스템 내부이며 컨텍스트를 위해 제공됩니다. 이 함수에는 프로파일러 마커가 연결되어 있으므로 프로파일러를 사용하여 프레임에서 Unity가 호출하는 시점을 확인할 수 있습니다. Unity 이러한 함수를 호출하는 시점을 파악하면 호출하는 이벤트 함수가 정확히 실행되는 시점을 파악할 수 있습니다. 애니메이션 함수 및 프로파일러 마커의 전체 실행 순서는 프로파일러 마커를 참조하십시오.

렌더링

이 실행 순서는 빌트인 렌더 파이프라인에만 적용됩니다. 스크립터블 렌더 파이프라인을 기반으로 하는 렌더 파이프라인의 실행 순서에 대한 자세한 내용은 유니버설 렌더 파이프라인 또는 고해상도 렌더 파이프라인에 대한 문서의 관련 섹션을 참조하십시오. 렌더링 직전에 작업을 수행하려면 Application.onBeforeRender를 참조하십시오.
  • OnPreCull
    : 카메라가 씬을 컬링하기 전에 호출됩니다. 컬링은 카메라에 보이는 오브젝트를 결정합니다. 컬링 직전에
    OnPreCull
    가 호출됩니다.
  • OnBecameVisible
    /
    OnBecameInvisible
    : 오브젝트가 카메라에 보이거나 보이지 않을 때 호출됩니다. 오브젝트가 언제든지 보이지 않을 수 있으므로
    OnBecameInvisible
    는 위의 플로 차트에 표시되지 않습니다.
  • OnWillRenderObject
    : 오브젝트가 보이면 각 카메라에 대해 한 번 호출됩니다.
  • OnPreRender
    : 카메라가 씬 렌더링을 시작하기 전에 호출됩니다.
  • OnRenderObject
    : 모든 일반 씬 렌더링이 완료된 후 호출됩니다. 이 지점에서 사용자 지오메트리를 그리려면 GL 클래스나 Graphics.DrawMeshNow를 사용할 수 있습니다.
  • OnPostRender
    : 카메라가 씬 렌더링을 완료한 후 호출됩니다.
  • OnRenderImage
    : 이미지 포스트 프로세싱을 허용하기 위해 씬 렌더링이 완료된 후 호출(포스트 프로세싱 효과 참조).
  • OnGUI
    : GUI 이벤트에 대한 응답으로 프레임당 여러 번 호출. 레이아웃 및 리페인트 이벤트가 먼저 처리되고, 그런 다음 각 입력 이벤트에 대한 레이아웃 및 키보드/마우스 이벤트가 처리됩니다.
  • 시각화 목적으로 씬 뷰에서 기즈모를 그리는 데 사용되는
    OnDrawGizmos
    입니다.
참고
OnPreCull, OnPreRender, OnPostRender 및 OnRenderImage는 MonoBehaviour 스크립트에서 호출되는 빌트인 Unity 이벤트 함수이지만 이러한 스크립트가 활성화된 Camera 컴포넌트와 동일한 오브젝트에 연결된 경우에만 호출됩니다. 다른 오브젝트에 연결된 MonoBehaviour의
OnPreCull
,
OnPreRender
및
OnPostRender
에 대한 동등한 콜백을 수신하려면 Camera.onPreCull, Camera.onPreRender 및 Camera.onPostRender라는 이름의 소문자
on
를 참조하십시오. 스크립팅 레퍼런스 관련 페이지의 코드 예제에 표시된 것처럼.

코루틴 및 비동기 작업 재개

일시 중지된 코루틴은 사용되는 yield 명령에 따라 실행 순서의 다른 지점에서 재개될 수 있습니다. 예를 들어
WaitForEndOfFrame
을 사용하는 코루틴은 프레임이 끝날 때 다시 실행되고,
WaitForFixedUpdate
을 사용하는 코루틴은 고정 업데이트 단계가 끝날 때 다시 실행됩니다. 자세한 내용은 코루틴을 참조하십시오.
일반 .NET 작업과 비동기 메서드는
Update
단계에서 재개됩니다. 코루틴과 마찬가지로 Unity의 커스텀
Awaitable
클래스는 대기 중에 사용하는 메서드에 따라 다른 지점에서 재개될 수 있습니다. 자세한 내용은 Awaitable 클래스를 사용한 비동기 프로그래밍을 참조하십시오.
참고
코루틴 재개와 비동기 작업 간의 정확한 실행 순서는 보장되지 않습니다. Awaitables는 함께 그룹화되고 예상한 순서대로 실행됩니다.

MonoBehaviour를 Entities 결합

엔티티 컴포넌트 시스템(ECS)을 사용하는 경우 Unity는 ECS 시스템 그룹 업데이트를 플레이어 업데이트 루프에 병합합니다.
Entities Systems 창을 사용하여 전체 플레이어 루프를 기준으로 ECS 시스템 그룹의 업데이트 순서를 볼 수 있습니다. 자세한 내용은 Entities 패키지 문서의 시스템 업데이트 순서를 참조하십시오.

제한

일반적으로 순서가 명시적으로 문서화되거나 설정 가능한 경우를 제외하고 다른 GameObjects 오브젝트에 대해 동일한 이벤트 함수가 호출되는 순서에 의존할 수는 없습니다.
동일한 MonoBehaviour 스크립트의 여러 인스턴스에 대해 이벤트 함수가 호출되는 순서를 지정할 수 없습니다. 예를 들어, 하나의 MonoBehaviour의
Update
함수는 다른 게임 오브젝트에서 동일한 MonoBehaviour에 대한
Update
함수 이전 또는 이후에 호출될 수 있습니다(자신의 부모 또는 자식 게임 오브젝트 포함).
서로 다른 MonoBehaviour 스크립트 간의 실행 순서를 구성하려면 스크립트 실행 순서를 참고하십시오.

추가 리소스