Unity Serialization 사용하는 방식
Unity Serialization 작동하는 방식에 대한 자세한 내용입니다.
읽는 시간 4분최근 업데이트: 9일 전
저장 및 로드
Unity는 Serialization을 사용하여 씬, 에셋 및 에셋 번들을 장치의 메모리에 로드하고 저장합니다. 여기에는 MonoBehaviour 컴포넌트 및 ScriptableObjects와 같은 자체 스크립팅 API 객체에 저장된 데이터가 포함됩니다.
Unity 에디터 많은 기능은 핵심 Serialization 시스템을 기반으로 제작되었습니다. Serialization에서 특히 알아야 할 두 가지 사항은 인스펙터 창과 핫 리로드입니다.
인스펙터 창
인스펙터 창 검사된 오브젝트의 직렬화된 필드 값이 표시됩니다. 인스펙터에서 값을 변경하면 인스펙터가 직렬화된 데이터를 업데이트하고 검사된 오브젝트를 업데이트하는 역직렬화를 트리거합니다.
빌트인 Unity 객체와 MonoBehaviour 파생 클래스와 같은 스크립팅 객체도 마찬가지입니다.
인스펙터 창 값을 보거나 변경할 때 Unity C# 프로퍼티 게터와 세터를 호출하지 않습니다. 대신 Unity 직렬화된 백ing 필드에 직접 액세스합니다.
핫 리로드
스크립트 코드 핫 리로드는 에셋 데이터베이스 새로고침의 일부로 수행됩니다. 에디터 실행 중에 코드를 다시 시작하지 않고 코드 변경 사항을 직접 다시 로드하고 적용하는 프로세스를 가리킵니다. 자세한 내용은 에셋 데이터베이스 새로 고침 및 핫 리로드를 참조하십시오.
Unity 스크립트를 다시 로드하는 경우:
-
Unity 로드된 모든 스크립트의 모든 변수를 직렬화하고 저장합니다.
-
Unity는 원래의 사전 Serialization 값으로 복원합니다.
- Unity는 변수에 속성이 없는 경우에도 Serialization 요구 사항을 충족하는 모든 변수(프라이빗 변수 포함)를 복원합니다.
[SerializeField] - Unity 정적 변수를 복원하지 않습니다. 따라서 Unity 스크립트를 다시 로드한 후 유지해야 하는 상태에는 정적 변수를 사용하지 마십시오. 이는 재로드 프로세스에서 폐기되기 때문입니다.
- Unity는 변수에
Serialization 및 복원 방지
예를 들어 스크립트에서 다시 로드한 후 레퍼런스가 null 되도록 하려면 Unity 비공개 변수를 복원하는 것을 방지해야 할 때가 있습니다. 이 경우에는 속성을 사용합니다.
[NonSerialized]Unity의 복원 동작은 C#에 자동으로 구현된 프로퍼티의 값을 저장하는 프라이빗 백업 필드에도 적용됩니다. 예를 들어 다음과 같은 자동으로 구현된 프로퍼티를 생각해 보십시오.
public string MyProperty { get; set; }
이 경우 C#은 클래스에 보이지 않는 프라이빗 필드를 추가하여 의 실제 값을 저장합니다. Unity 핫 리로드 중에 이 값을 직렬화하고 복원합니다. 이를 방지하려면 등록 정보의 를 사용하십시오.
MyProperty[field: NonSerialized]다음 예제는 각각 정규 필드와 자동 등록 정보 백업 필드의 Serialization 및 복원을 방지하기 위해 속성과 를 모두 사용하는 방법을 보여줍니다.
[NonSerialized][field: NonSerialized]클래스 테스트{ // p will not be shown in the Inspector or serialized [System.NonSerialized] public int p = 5; // neverSerializeMe will never be serialized, even during an hot reload. [System.NonSerialized] private int neverSerializeMe; // The backing field for NeverSerializedProperty property will never be serialized, // even during a hot reload [field: System.NonSerialized] public int NeverSerializedProperty { get; set; }}
프리팩
하나 또는 여러 GameObjects 또는 컴포넌트의 직렬화된 데이터는 프리팩입니다. 프리맵 인스턴스에는 프리맵 소스에 대한 레퍼런스와 수정 목록이 모두 포함되어 있습니다. 수정은 Unity 해당 특정 프리 팩 인스턴스를 생성하기 위해 필요한 작업입니다.
Prefab 인스턴스는 Unity 에디터 프로젝트를 편집하는 동안에만 존재합니다. Unity 에디터 두 개의 Serialization 데이터 세트(프리맵 소스와 프리맵 인스턴스의 수정 사항)에서 게임 오브젝트를 인스턴스화합니다.
인스턴스화
씬에 존재하는 요소(예: 프리랩 또는 게임 오브젝트)에서 를 호출하는 경우 다음을 수행합니다.
Instantiate- Unity 이를 직렬화합니다. 이는 런타임 시점과 에디터에서 모두 발생합니다. Unity는 에서 파생되는 모든 것을 직렬화할 수 있습니다.
UnityEngine.Object - Unity 새 게임 오브젝트를 생성하고 데이터를 새 게임 오브젝트에 역직렬화합니다.
- Unity는 다른 배리언트에서 동일한 Serialization 코드를 실행하여 참조하는 다른 를 보고합니다. 모든 참조된
UnityEngine.Objects가 Unity가 인스턴스화하는 데이터의 일부인지 확인합니다. 레퍼런스가 텍스처와 같은 외부 요소를 가리키는 경우 Unity 해당 레퍼런스를 그대로 유지합니다. 레퍼런스가 자식 게임 오브젝트와 같은 내부 요소를 가리키는 경우 Unity 해당 복사본에 대한 레퍼런스를 패치합니다.UnityEngine.Objects
사용되지 않는 에셋 언로드
EditorUtility.UnloadUnusedAssetsImmediateUnityEngine.Objects에디터와 런타임 Serialization 차이점
대부분의 Serialization 에디터에서 이루어지지만 역직렬화는 런타임 시점에 주로 이루어집니다. Unity 에디터에서만 일부 기능을 직렬화하고, 에디터와 런타임 시점에 모두 다른 기능을 직렬화할 수 있습니다.
기능 | 에디터 | 런타임 |
|---|---|---|
| 바이너리 형식의 자산 | 읽기/쓰기 지원 | 읽음 지원됨 |
| YAML 형식의 자산 | 읽기/쓰기 지원 | 지원되지 않습니다. |
| 씬(Scenes), 프리랩 및 기타 자산 저장 | 플레이 모드가 아닌 경우 지원됨 | 지원되지 않습니다. |
| ** JsonUtility를 통한 개별 오브젝트 직렬화** | JsonUtility를 통한 읽기/쓰기 지원 EditorJsonUtility를 통한 추가 타입의 오브젝트 지원 | JsonUtility를 통한 읽기/쓰기 지원 |
| SerializeReference | 지원 가능 | 지원 가능 |
| ISerializationCallbackReceiver | 지원 가능 | 지원 가능 |
| FormerlySerializedAs | 지원 가능 | 지원되지 않습니다. |
Unity_EDITOR 스크립팅 심볼 내에서 필드를 선언하는 경우와 같이 오브젝트에 에디터만 직렬화하는 추가 필드가 있을 수 있습니다.
public class SerializeRules : MonoBehaviour{#if UNITY_EDITORpublic int m_intEditorOnly;#endif}
이전 예제에서 필드는 에디터에서만 직렬화되며 빌드에 포함되지 않습니다. 이를 통해 빌드에서 에디터에서 필요한 데이터만 생략하여 메모리를 절약할 수 있습니다. 이 필드를 사용하는 코드는 빌드 시 클래스를 컴파일할 수 있도록 블록 내에서 조건부로 컴파일해야 합니다.
m_intEditorOnly#if UNITY_EDITOR에디터는 Unity가 런타임 시에만 직렬화하는 필드가 있는 오브젝트를 지원하지 않습니다(예를 들어 Unity_STANDALONE 지시문 내에서 필드를 선언하는 경우).