도메인 재로드가 비활성화된 상태로 플레이 모드 시작
플레이 모드 시작 시 도메인 재로드를 비활성화하면 애플리케이션 상태에 어떤 영향을 미치는지, 코드에서 이러한 효과를 보정하는 방법을 알아봅니다.
읽는 시간 6분최근 업데이트: 9일 전
스크립팅 도메인(또는 애플리케이션 도메인 또는 단순히 도메인이라고도 함)은 Unity의 관리되는 스크립팅 환경의 핵심 기능입니다. 도메인은 특정 애플리케이션 전용 메모리의 단독 섹션으로, 애플리케이션에 필요한 컴파일된 타입을 포함하며, 어셈블리라는 논리적 단위로 그룹화되어 있습니다. 또한 현재 애플리케이션 상태를 나타내는 데이터(예: 변수 값 및 관리되는 메모리의 다양한 섹션에서 오브젝트 레퍼런스)도 포함되어 있습니다.
기본적으로 Unity 플레이 모드를 시작할 때 도메인을 다시 로드하여 애플리케이션 상태를 재설정합니다. 플레이 모드로 전환하기 전에 상태를 재설정하는 것이 바람직할 때가 많으므로 새 빌드가 시작될 때와 마찬가지로 애플리케이션이 시작됩니다. 예를 들어 이전 플레이 모드 세션에서 증분된 정적 카운터는 다음 세션에서 다시 0에서 시작해야 합니다. 하지만 도메인 재로드는 편집 모드와 플레이 모드 간에 자주 전환할 때 반복 시간에 부정적인 영향을 미치는 시간이 많이 소요되는 작업입니다. 더 빠른 반복 시간을 위해 플레이 모드를 시작할 때 도메인 재로드를 비활성화할 수 있지만 수동으로 코드 상태를 초기화해야 합니다.
플레이 모드를 시작할 때 도메인 재로드를 비활성화하는 효과
도메인 재로드를 비활성화하는 경우:
- 직렬화되지 않은 필드는 편집 모드로 돌아오면 플레이 모드 동안 할당된 값을 유지합니다. 이 설정은 MonoBehaviour를 포함한 모든 스크립트 타입의 필드(프리맵 에셋의 필드 포함), ScriptableObjects, 자체 커스텀 C# 타입 등)에 적용됩니다. 서로 다른 컨텍스트에서 직렬화되거나 직렬화되지 않는 항목에 대한 자세한 내용은 Serialization rules 를 참조하십시오.
- 정적 변수는 플레이 모드 세션 간에 값을 유지합니다.
- 정적 이벤트는 플레이 모드 세션 간에 등록된 구독자를 유지합니다.
- 스크립트에 대한 추가 또는
OnDisable호출은OnEnable또는[ExecuteInEditMode]로 표시되지 않습니다.[ExecuteAlways]
플레이 모드 세션 간 데이터의 지속성을 보정하고 새 애플리케이션 상태로 플레이 모드를 시작하려면 코드에서 상태를 재설정해야 합니다.
도메인 및 씬 재로드 비활성화의 효과에 대한 자세한 내용은 도메인 및 씬 재로드 비활성화의 세부 정보를 참조하십시오.
코드에서 상태 재설정
도메인 재로드를 비활성화하면 정적 필드 값과 정적 이벤트에 할당된 핸들러가 플레이 모드 실행 간에 유지됩니다. 다음 코드 예제에는 키보드 키를 누르면 증가하는 정적 카운터가 나와 있습니다. 또한 코드는 정적 이벤트 를 처리하는 메서드를 등록합니다.
EditorApplication.playModeStateChanged도메인 재로드를 활성화하면 Unity 플레이 모드를 시작할 때 이 코드를 재초기화하여 카운터 값과 이벤트 핸들러 등록을 포함하여 이전 플레이 모드 실행의 상태를 지웁니다. 도메인 재로드를 비활성화하면 카운터 값과 이벤트 핸들러 등록이 모두 이전 실행에서 유지됩니다. 다음 플레이 모드 실행 시 카운터는 이전 실행이 끝날 때의 값으로 시작하며 이벤트 핸들러 메서드는 이벤트가 발생할 때 여러 번 호출되어 콘솔에 여러 "Play mode!" 메시지를 생성합니다.
// Copy-paste this code into a MonoBehaviour script attached to a GameObject in your project.// Run it with domain reload enabled and then with domain reload disabled and note the different behavior.using UnityEngine;#if UNITY_EDITORusing UnityEditor;#endifpublic class StateResetExample : MonoBehaviour{ // With domain reload disabled this counter won't reset to zero on exiting Play mode 정적 int 카운터 = 0; void Start() { // Register handler#if UNITY_EDITOR EditorApplication.playModeStateChanged += OnExitPlayMode;#endif } void Update() { if (Input.anyKeyDown) { counter++; Debug.Log("Counter: " + counter); } }#if UNITY_EDITOR private static void OnExitPlayMode(PlayModeStateChange state) { if(state == PlayModeStateChange.ExitingPlayMode) { // With domain reload disabled this message prints multiple times after the first Play mode run Debug.Log("Exiting Play mode!"); } }#endif}
카운터를 명시적으로 초기화하고 플레이 모드 실행 간에 이벤트 핸들러를 등록 취소하는 코드를 사용하여 문제 동작을 수정할 수 있습니다. 플레이 모드를 시작하거나 플레이 모드를 종료할 때 이 작업을 수행할 수 있습니다.
플레이 모드 종료 시 상태 재설정
종종 플레이 모드를 종료할 때가 아닌 플레이 모드를 시작할 때 상태를 재설정하는 것이 가장 효율적입니다. 이벤트와 해당 열거형 값을 사용하여 플레이 모드 종료 이벤트를 잡고 해당 시점의 상태를 재설정할 수 있습니다. 다음 예제에서는 플레이 모드 종료에 대한 이벤트 핸들러를 사용하여 자체 등록을 취소하지만, 이 메서드를 사용하여 이 시점의 다른 정적 이벤트 핸들러 등록을 취소할 수도 있습니다.
EditorApplication.playModeStateChangedExitingPlayModeusing UnityEngine;#if UNITY_EDITORusing UnityEditor;#endifpublic class StateResetOnExit : MonoBehaviour{ 정적 int 카운터 = 0; void Start() {#if UNITY_EDITOR EditorApplication.playModeStateChanged += OnExitPlayMode;#endif } // Update is called once per frame void Update() { if (Input.anyKeyDown) { counter++; Debug.Log("Counter: " + counter); } }#if UNITY_EDITOR private static void OnExitPlayMode(PlayModeStateChange state) { if(state == PlayModeStateChange.ExitingPlayMode) { Debug.Log("Exiting Play mode!"); Debug.Log("Unregistering handler."); // Unregister the handler so it doesn't affect the next Play mode run EditorApplication.playModeStateChanged -= OnExitPlayMode; Debug.Log("Resetting counter."); // Reset the counter so it starts from 0 on the next Play mode run counter = 0; } }#endif}
EditorApplication.playModeStateChangedUnityEditor코드가 플레이 모드 외에 편집 모드에서 실행되는 경우, 플레이 모드를 종료할 때 상태 초기화에 의존할 수 없습니다. 편집 모드에서 코드가 정적 변수를 수정할 수 있으므로 대신 변수를 재설정해야 합니다. 플레이 모드 시작 시.
플레이 모드 시작 시 상태 재설정
플레이 모드를 시작할 때 상태를 재설정할 수도 있습니다. 플레이 모드 이벤트를 캡처하는 데 플랫폼별 문제가 발생하거나 편집 모드에서도 실행되는 코드가 있는 경우 유용한 대안입니다. 설명을 위해 다음 예시는 플레이 모드를 시작할 때 정적 변수를 재설정하고 정적 이벤트 핸들러를 등록 취소하는 방법을 보여줍니다. 가장 좋은 방법은 항상 정적 이벤트 핸들러를 등록 취소하는 것입니다. 플레이 모드를 종료하면. 다음 플레이 모드 세션까지 대기하면 오브젝트 레퍼런스 문제가 리드 잘못된 핸들러를 등록 취소할 수 있습니다.
Unity에는 네임스페이스와 네임스페이스 모두에 커스텀 초기화 속성이 있으며, 이 속성을 사용하여 수동 상태 초기화 작업을 수행할 수 있습니다. 어떤 속성을 사용해야 할지 코드가 편집 모드 또는 플레이 모드에서 실행되는지에 따라 다릅니다. 플레이어(런타임) 스크립트의 플레이 모드 시작 시 상태를 재설정하려면 파라미터와 함께 속성을 사용할 수 있습니다.
UnityEngineUnityEditorRuntimeInitializeLoadType.SubsystemRegistration[RuntimeInitializeOnLoadMethod]using UnityEngine;#if UNITY_EDITORusing UnityEditor;#endifpublic class StateResetOnEnter : MonoBehaviour{ 정적 int 카운터 = 0; [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)] static void Init() { Debug.Log("Unregistering handler."); // Unregister the handler so it doesn't affect the next Play mode run EditorApplication.playModeStateChanged -= OnExitPlayMode; Debug.Log("Resetting counter."); // Reset the counter so it starts from 0 on the next Play mode run counter = 0; } void Start() {#if UNITY_EDITOR EditorApplication.playModeStateChanged += OnExitPlayMode;#endif } // Update is called once per frame void Update() { if (Input.anyKeyDown) { counter++; Debug.Log("Counter: " + counter); } }#if UNITY_EDITOR private static void OnExitPlayMode(PlayModeStateChange state) { if(state == PlayModeStateChange.ExitingPlayMode) { Debug.Log("Exiting Play mode!"); } }#endif}
[RuntimeInitializeOnLoadMethod]UnityEngine- 을 사용하여
[InitializeOnLoadAttribute]에 대한 핸들러를 등록한 다음 플레이 모드를 시작하거나 종료할 때 상태를 정리합니다. 예제는EditorApplication.playModeStateChangedAPI 레퍼런스를 참조하십시오.EditorApplication.playModeStateChanged - 플레이 모드를 시작할 때 특정 정리 작업을 수행하려면 속성을 사용합니다.
[InitializeOnEnterPlayMode]