Serialization 규칙
스크립트의 필드가 직렬화되었는지 여부를 결정하는 조건입니다.
읽는 시간 4분최근 업데이트: 9일 전
Unity 런타임 시 효율적으로 작동하도록 특별히 설계된 자체 Serialization 시스템을 사용합니다. 따라서 Unity Serialization 다른 프로그래밍 환경의 Serialization 다르게 작동합니다.
Unity는 표준 .NET/C# 및 속성을 지원하지만 Unity의 동작은 Unity 전용 고려 사항에 따라 달라집니다. Unity는 다음 섹션에 설명된 Unity Serialization 규칙을 충족하지 않는 한 로 표시된 클래스를 자동으로 직렬화하지 않습니다.
[Serializable][NonSerialized][Serializable]Unity는 에서 상속하는 빌트인 Unity 타입을 자동으로 직렬화하므로 이러한 Unity 객체에서 필드로 사용되는 커스텀 클래스나 구조체에만 를 적용해야 합니다. Unity에서는 표준 C#과 마찬가지로 속성을 사용하여 필드를 Serialization에서 제외합니다. 하지만 Unity 컨텍스트에서는 인스펙터가 해당 필드를 직렬화하거나 표시하지 못합니다. Unity에는 자체 속성인 이 있습니다. 이 속성은 Serialization을 방지하지 않고 인스펙터에서 필드를 숨깁니다.
UnityEngine.Object[Serializable][NonSerialized][HideInInspector]필드 Serialization 규칙
Unity의 시리얼라이저는 해당 프로퍼티가 아닌 C# 클래스의 필드에서 직접 작동하므로 Unity는 특정 조건을 충족하는 경우에만 필드를 직렬화합니다. 다음 섹션에서는 Unity 필드 Serialization 사용하는 방법을 간략하게 설명합니다.
필드 Serialization 사용하려면 필드가 다음 사항인지 확인해야 합니다.
-
이거나
public속성이 있음[SerializeField] -
-
아님
static -
아님
const -
아님
readonly -
직렬화할 수 있는 필드 타입이 있습니다.
- 기본 데이터 유형(int, float, double, bool, string 등)
- 열거형 타입(32비트 이하)입니다.
- 고정 크기 버퍼。
- Unity 빌트인 유형(예: Vector2, Vector3, Rect, Matrix4x4, Color, AnimationCurve)
- 속성을 가진 커스텀 구조체.
[Serializable] - UnityEngine.Object에서 파생된 오브젝트에 대한 레퍼런스입니다.
- 속성이 있는 커스텀 클래스입니다. (커스텀 클래스의 Serialization 참조).
[Serializable] - 이전에 나열된 필드 타입 중 하나의 배열 또는 입니다. 값으로 기본 Serialization 하나의 요소가 리스트 또는 배열에 두 번 나타나면 직렬화된 컬렉션 버전에는 두 번 나타나는 하나의 사본이 아닌 해당 요소의 두 개의 사본이 있습니다. 레퍼런스를 통해 클래스 컬렉션을 직렬화하면 동일한 오브젝트에 대한 여러 레퍼런스가 보존됩니다. 자세한 내용은
List<T>API 자료를 참고하십시오.[SerializeReference]
- 클래스 또는 구조체에 중첩된 유형 래핑
- ISerializationCallbackReceiver를 구현하여 Serialization 콜백을 사용하여 커스텀 Serialization을 수행합니다.
사용자 지정 클래스의 Serialization
Unity 커스텀 클래스를 직렬화하려면 클래스를 다음과 같이 확인해야 합니다.
- 속성을 포함합니다.
[Serializable] - 정적이 아닙니다.
필드에 파생 클래스의 인스턴스를 할당하고 Unity가 해당 필드를 저장하면 해당 인스턴스에 대한 레퍼런스로 필드를 직렬화합니다. Unity 인스턴스 자체를 독립적으로 직렬화하므로 인스턴스에 여러 필드가 할당될 때 중복되지 않습니다. 그러나 에서 파생되지 않는 커스텀 클래스의 경우 Unity는 해당 클래스를 참조하는 MonoBehaviour 또는 ScriptableObject의 직렬화된 데이터에 인스턴스의 상태를 직접 포함합니다. 이것은 두 가지 방법으로 일어날 수 있습니다: 인라인과 .
UnityEngine.ObjectUnityEngine.Object[SerializeReference]- Inline Serialization: 기본적으로 클래스를 참조하는 필드에 를 지정하지 않으면 Unity는 값을 기준으로 커스텀 클래스를 직렬화합니다. 즉, 커스텀 클래스의 인스턴스에 대한 레퍼런스를 여러 다른 필드에 저장하면 직렬화 시 별도의 오브젝트가 됩니다. 그런 다음 Unity 필드를 역직렬화하면 필드에는 동일한 데이터가 포함된 서로 다른 오브젝트가 포함됩니다.
[SerializeReference] - 직렬화:
[SerializeReference]를 지정하면 Unity가 오브젝트를 관리 레퍼런스로 설정합니다. 호스트 오브젝트는 계속 직렬화된 데이터에 오브젝트를 직접 저장하지만 전용 레지스트리 섹션에 저장합니다.[SerializeReference]
[SerializeReference]- 필드는 null 수 있습니다. 인라인 Serialization null 나타낼 수 없으며, 대신 null 할당되지 않은 필드가 있는 인라인 오브젝트로 대체합니다.
- 동일한 오브젝트에 대한 여러 레퍼런스 를 사용하지 않고 여러 다른 필드에 커스텀 클래스의 인스턴스에 대한 레퍼런스를 저장하는 경우 직렬화 시 별도의 오브젝트가 됩니다.
[SerializeReference] - 그래프 및 순환 데이터(예: 자체에 레퍼런스가 있는 오브젝트) 인라인 클래스 Serialization null 또는 공유 레퍼런스를 지원하지 않으므로 데이터의 모든 주기가 예기치 않은 결과(예: 이상한 인스펙터 동작, 콘솔 오류, 무한 루프)를 리드 수 있습니다.
- 폴리모폴리즘。 부모 클래스에서 파생된 클래스를 생성하고 부모 클래스를 타입으로 사용하는 필드에 할당하면 없이 Unity는 부모 클래스에 속한 필드만 직렬화합니다. Unity 클래스 인스턴스를 역직렬화하면 파생 클래스가 아닌 부모 클래스를 인스턴스화합니다.
[SerializeReference] - 데이터 구조에서 오브젝트의 배열 포지션을 하드 코딩하거나 전체 배열을 검색하지 않고 특정 오브젝트를 가리키는 안정적인 식별자를 요구하는 경우 Serialization.ManagedReferenceUtility.SetManagedReferenceIdForObject를 참조하십시오.
프로퍼티 Serialization
Unity 일반적으로 다음 상황을 제외하고는 프로퍼티를 직렬화하지 않습니다.
- 프로퍼티에 명시적 지원 필드가 있는 경우 Unity 일반 Serialization 규칙에 따라 직렬화합니다. 예제는 아래와 같습니다.
public int MyInt{get => m_backing;private set => m_backing = value;}[SerializeField] private int m_backing;
- Unity 핫 리로드 중에만 자동 생성된 필드로 프로퍼티를 직렬화합니다.
public int MyInt { get; set; }
Unity가 자동 생성된 필드로 프로퍼티를 직렬화하지 않게 하려면 속성을 사용합니다.
[field: NonSerialized]