기술 자료

Unity 엔진

Unity 엔진

프로퍼티 팩

프로퍼티 팩의 역할과 사용 시 성능 고려 사항을 이해합니다.
읽는 시간 2분최근 업데이트: 9일 전

프로퍼티 백은 특정 .NET 오브젝트 타입의 컴패니언 오브젝트입니다. 이 가방에는 컴패니언 타입에 대한 프로퍼티 컬렉션이 포함되어 있습니다. 프로퍼티 백을 사용하여 컴패니언 타입 오브젝트의 인스턴스에 대한 데이터를 효율적으로 이동하고 액세스하고 수정할 수 있습니다.

프로퍼티 백 생성

Unity 다음 방법 중 하나를 사용하여 타입에 대한 프로퍼티 백을 생성합니다.
  • 반사: 기본적으로 Unity 반사를 사용하여 타입에 대한 프로퍼티 백을 생성합니다. 반사는 편의를 제공하며 프로퍼티 가방이 아직 등록되지 않은 경우 유형별로 한 번만 발생합니다.
  • 코드 생성: 성능을 향상하기 위해 코드 생성을 옵트인 수 있습니다. 코드 생성을 통해 프로퍼티 팩을 생성하려면 다음을 수행해야 합니다.

포함된 구성원

프로퍼티 백을 생성하는 두 가지 방법 모두 다음 타입의 멤버에 대한 프로퍼티를 생성합니다.
공용, 비공개 또는 내부 필드에
[DontCreateProperty]
속성을 추가하면 해당 필드가 프로퍼티 백에서 제외됩니다.
필드가 읽기 전용이거나 프로퍼티에 게터만 있는 경우 생성된 프로퍼티는 읽기 전용입니다.
[Unity.Properties.CreateProperty(ReadOnly = true)]
를 사용하여 생성된 등록 정보를 읽기 전용으로 만들 수도 있습니다.
다음 예시에서는 Unity Serialization 시스템과 Unity 프로퍼티 시스템을 결합합니다.
[!code-cs]
편의를 위해 Serialization 속성을 사용하여 속성 백에 속성을 생성하는 것은 항상 선호되는 접근 방식이 아닙니다. Unity의 Serialization 시스템은 필드와 자동 프로퍼티에서만 작동하므로 변경 사항을 효과적으로 검증하거나 전파하기가 어려워집니다.
Unity Serialization 시스템과 달리, 프로퍼티 백 내의 프로퍼티는
[SerializeField]
로 값 타입으로 적합하지 않습니다. 대신 구조체 타입은 값 타입으로 인식되고 클래스 타입은 레퍼런스로 인식됩니다.
Unity Serialization에서는 Polymorphism이 지원되지만, 명시적으로 선택하려면
[SerializeReference]
속성을 사용해야 합니다. 그렇지 않으면 인스턴스는 값 유형으로 직렬화됩니다.
UnityEngine.Object
유형은 이 규칙의 예외이며 자동으로 직렬화됩니다.

성능 고려 사항

반사를 통해 프로퍼티 백을 생성하면 특정 컨테이너 타입에 대한 프로퍼티 백을 처음 요청할 때 성능 오버헤드가 발생할 수 있습니다. 반사를 통해 필드 멤버에 대한 프로퍼티를 생성하면 메모리를 할당하고 IL2CPP 빌드에서 가비지 컬렉터 오버헤드를 늘릴 수 있습니다.
반사를 방지하고 성능을 향상시키기 위해 대신 코드 생성으로 프로퍼티 백을 생성합니다. 하지만 이러한 런타임 최적화로 인해 컴파일 시간이 길어질 수 있습니다. 프로퍼티 백이 내부 및 프라이빗 필드 및 프로퍼티에 액세스하도록 만들려면 유형
partial
를 만듭니다.

추가 리소스