새로운 씬 생성 커스터마이즈

Unity가 템플릿에서 새로운 씬을 인스턴스화할 때 커스텀 코드를 실행하려면 씬 템플릿 파이프라인 스크립트를 생성한 후 템플릿에 연결하십시오. 템플릿에서 새로운 씬을 생성할 때마다 Unity는 파이프라인 스크립트의 새로운 인스턴스도 함께 생성합니다.

스크립트를 템플릿에 연결하려면 다음 단계를 따르십시오.

1. 템플릿을 확인하여 해당 프로퍼티를 편집합니다.
2. Scene Template Pipeline 프로퍼티가 씬 템플릿 파이프라인 스크립트를 가리키도록 설정합니다.

SceneTemplateAsset.templatePipeline 메서드를 사용하여 C#을 통해 스크립트를 템플릿에 연결할 수도 있습니다.

씬 템플릿 파이프라인 스크립트는 [ISceneTemplatePipeline] 인터페이스 또는 [SceneTemplatePipelineAdapter]에서 파생되어야 합니다. 또한 반응할 이벤트를 구현해야 합니다. 예를 들어 아래 코드에서는 BeforeTemplateInstantiation 또는 AfterTemplateInstantiation입니다.

예제:

using UnityEditor.SceneTemplate;
using UnityEngine;
using UnityEngine.SceneManagement;
public class DummySceneTemplatePipeline : ISceneTemplatePipeline
{
    public void BeforeTemplateInstantiation(SceneTemplateAsset sceneTemplateAsset, bool isAdditive, string sceneName)
    {
        if (sceneTemplateAsset)
        {
            Debug.Log($"Before Template Pipeline {sceneTemplateAsset.name} isAdditive: {isAdditive} sceneName: {sceneName}");
        }
    }

    public void AfterTemplateInstantiation(SceneTemplateAsset sceneTemplateAsset, Scene scene, bool isAdditive, string sceneName)
    {
        if (sceneTemplateAsset)
        {
            Debug.Log($"After Template Pipeline {sceneTemplateAsset.name} scene: {scene} isAdditive: {isAdditive} sceneName: {sceneName}");
        }
    }
}

씬 템플릿 인스턴스화 시퀀스

복제 가능한 종속성이 있는 템플릿에서 새로운 씬을 생성하면 Unity는 여러 파일 작업을 수행합니다. 이러한 작업의 대부분은 스크립트에서 수신하고 반응할 수 있는 Unity 이벤트를 트리거합니다.

인스턴스화 시퀀스는 다음과 같습니다.

1. New Scene 다이얼로그에서 Create를 클릭합니다. 그러면 Unity가 다음을 호출합니다.
   • 씬 템플릿 에셋.
   • 템플릿 씬. 템플릿에 연결된 Unity 씬입니다.
   • 새로운 씬. 템플릿 씬의 새로운 인스턴스입니다.

2. Unity가 템플릿 에셋에 대해 ISceneTemplatePipeline.BeforeTemplateInstantiation 이벤트를 트리거하고, 트리거하는 ISceneTemplatePipeline 스크립트에 에셋을 바인딩합니다.

3. Unity가 SceneTemplate.NewTemplateInstantiating 이벤트를 트리거합니다.

4. Unity가 템플릿 씬의 복사본인 새로운 씬을 생성합니다.

5. Unity가 새로운 씬과 동일한 이름의 폴더를 생성하고 복제 가능한 모든 종속성을 해당 폴더에 복사합니다.

6. Unity가 메모리에서 새로운 씬을 열고 다음 이벤트를 트리거합니다.
   • EditorSceneManager.sceneOpening
   • MonoBehavior.OnValidate(구현하는 모든 게임 오브젝트에서 트리거)
   • EditorSceneManager.sceneOpened

7. Unity가 모든 복제 가능 에셋에 대한 레퍼런스를 다시 매핑하므로, 새로운 씬이 복제물을 가리킵니다.

8. Unity는 새로운 씬을 저장하고 다음 이벤트를 트리거합니다.
   • EditorSceneManager.sceneSaving
   • EditorSceneManager.sceneSaved

9. Unity가 템플릿 에셋에 대해 ISceneTemplatePipeline.AfterTemplateInstantiation을 트리거하고, 트리거하는 ISceneTemplatePipeline 스크립트에 에셋을 바인딩합니다.

10. Unity가 SceneTemplate.NewTemplateInstantiated 이벤트를 트리거합니다.