기술 자료

Unity 엔진

Unity 엔진

Serialization 규칙

스크립트의 필드가 직렬화되었는지 여부를 결정하는 조건입니다.
읽는 시간 4분최근 업데이트: 9일 전

Unity 런타임 시 효율적으로 작동하도록 특별히 설계된 자체 Serialization 시스템을 사용합니다. 따라서 Unity Serialization 다른 프로그래밍 환경의 Serialization 다르게 작동합니다.
Unity는 표준 .NET/C#
[Serializable]
및
[NonSerialized]
속성을 지원하지만 Unity의 동작은 Unity 전용 고려 사항에 따라 달라집니다. Unity는 다음 섹션에 설명된 Unity Serialization 규칙을 충족하지 않는 한
[Serializable]
로 표시된 클래스를 자동으로 직렬화하지 않습니다.
Unity는
UnityEngine.Object
에서 상속하는 빌트인 Unity 타입을 자동으로 직렬화하므로 이러한 Unity 객체에서 필드로 사용되는 커스텀 클래스나 구조체에만
[Serializable]
를 적용해야 합니다. Unity에서는 표준 C#과 마찬가지로
[NonSerialized]
속성을 사용하여 필드를 Serialization에서 제외합니다. 하지만 Unity 컨텍스트에서는 인스펙터가 해당 필드를 직렬화하거나 표시하지 못합니다. Unity에는 자체 속성인
[HideInInspector]
이 있습니다. 이 속성은 Serialization을 방지하지 않고 인스펙터에서 필드를 숨깁니다.

필드 Serialization 규칙

Unity의 시리얼라이저는 해당 프로퍼티가 아닌 C# 클래스의 필드에서 직접 작동하므로 Unity는 특정 조건을 충족하는 경우에만 필드를 직렬화합니다. 다음 섹션에서는 Unity 필드 Serialization 사용하는 방법을 간략하게 설명합니다.
필드 Serialization 사용하려면 필드가 다음 사항인지 확인해야 합니다.
  • public
    이거나
    [SerializeField]
    속성이 있음
    • 참고
      경우에 따라
      private
      필드가 직렬화됩니다. 핫 리로드를 참조하십시오.
  • static
    아님
  • const
    아님
  • readonly
    아님
  • 직렬화할 수 있는 필드 타입이 있습니다.
    • 기본 데이터 유형(int, float, double, bool, string 등)
    • 열거형 타입(32비트 이하)입니다.
    • 고정 크기 버퍼。
    • Unity 빌트인 유형(예: Vector2, Vector3, Rect, Matrix4x4, Color, AnimationCurve)
    • [Serializable]
      속성을 가진 커스텀 구조체.
    • UnityEngine.Object에서 파생된 오브젝트에 대한 레퍼런스입니다.
    • [Serializable]
      속성이 있는 커스텀 클래스입니다. (커스텀 클래스의 Serialization 참조).
    • 이전에 나열된 필드 타입 중 하나의 배열 또는
      List<T>
      입니다. 값으로 기본 Serialization 하나의 요소가 리스트 또는 배열에 두 번 나타나면 직렬화된 컬렉션 버전에는 두 번 나타나는 하나의 사본이 아닌 해당 요소의 두 개의 사본이 있습니다. 레퍼런스를 통해 클래스 컬렉션을 직렬화하면 동일한 오브젝트에 대한 여러 레퍼런스가 보존됩니다. 자세한 내용은
      [SerializeReference]
      API 자료
      를 참고하십시오.
참고
Unity 멀티 레벨 타입(다차원 배열, 나눠진 배열, 사전, 중첩된 컨테이너 타입)의 Serialization 지원하지 않습니다. 이를 직렬화하려면 두 가지 옵션이 있습니다.

사용자 지정 클래스의 Serialization

Unity 커스텀 클래스를 직렬화하려면 클래스를 다음과 같이 확인해야 합니다.
필드에
UnityEngine.Object
파생 클래스의 인스턴스를 할당하고 Unity가 해당 필드를 저장하면 해당 인스턴스에 대한 레퍼런스로 필드를 직렬화합니다. Unity 인스턴스 자체를 독립적으로 직렬화하므로 인스턴스에 여러 필드가 할당될 때 중복되지 않습니다. 그러나
UnityEngine.Object
에서 파생되지 않는 커스텀 클래스의 경우 Unity는 해당 클래스를 참조하는 MonoBehaviour 또는 ScriptableObject의 직렬화된 데이터에 인스턴스의 상태를 직접 포함합니다. 이것은 두 가지 방법으로 일어날 수 있습니다: 인라인과
[SerializeReference]
.
  • Inline Serialization: 기본적으로 클래스를 참조하는 필드에
    [SerializeReference]
    를 지정하지 않으면 Unity는 값을 기준으로 커스텀 클래스를 직렬화합니다. 즉, 커스텀 클래스의 인스턴스에 대한 레퍼런스를 여러 다른 필드에 저장하면 직렬화 시 별도의 오브젝트가 됩니다. 그런 다음 Unity 필드를 역직렬화하면 필드에는 동일한 데이터가 포함된 서로 다른 오브젝트가 포함됩니다.
  • [SerializeReference]
    직렬화:
    [SerializeReference]
    를 지정하면 Unity가 오브젝트를 관리 레퍼런스로 설정합니다. 호스트 오브젝트는 계속 직렬화된 데이터에 오브젝트를 직접 저장하지만 전용 레지스트리 섹션에 저장합니다.
[SerializeReference]
는 일부 오버헤드를 추가하지만 다음의 경우를 지원합니다.
  • 필드는 null 수 있습니다. 인라인 Serialization null 나타낼 수 없으며, 대신 null 할당되지 않은 필드가 있는 인라인 오브젝트로 대체합니다.
  • 동일한 오브젝트에 대한 여러 레퍼런스
    [SerializeReference]
    를 사용하지 않고 여러 다른 필드에 커스텀 클래스의 인스턴스에 대한 레퍼런스를 저장하는 경우 직렬화 시 별도의 오브젝트가 됩니다.
  • 그래프 및 순환 데이터(예: 자체에 레퍼런스가 있는 오브젝트) 인라인 클래스 Serialization null 또는 공유 레퍼런스를 지원하지 않으므로 데이터의 모든 주기가 예기치 않은 결과(예: 이상한 인스펙터 동작, 콘솔 오류, 무한 루프)를 리드 수 있습니다.
  • 폴리모폴리즘。 부모 클래스에서 파생된 클래스를 생성하고 부모 클래스를 타입으로 사용하는 필드에 할당하면
    [SerializeReference]
    없이 Unity는 부모 클래스에 속한 필드만 직렬화합니다. Unity 클래스 인스턴스를 역직렬화하면 파생 클래스가 아닌 부모 클래스를 인스턴스화합니다.
  • 데이터 구조에서 오브젝트의 배열 포지션을 하드 코딩하거나 전체 배열을 검색하지 않고 특정 오브젝트를 가리키는 안정적인 식별자를 요구하는 경우 Serialization.ManagedReferenceUtility.SetManagedReferenceIdForObject를 참조하십시오.
참고
인라인 Serialization은 더 효율적이며,
[SerializeReference]
가 지원하는 기능 중 하나가 필요하지 않는 한 사용해야 합니다.
[SerializeReference]
사용 방법에 대한 자세한 내용은 SerializeReference 문서를 참조하십시오.

프로퍼티 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]
속성을 사용합니다.

추가 리소스