기술 자료

Unity 엔진

Unity 엔진

Unity 속성 소개

Unity 프로퍼티 API 기초와 용도를 이해합니다.
읽는 시간 2분최근 업데이트: 9일 전

Unity 속성은 런타임 시 C# 유형의 속성을 탐색하고 수정할 수 있는 시스템입니다. 이는 예측 가능하고 제어 가능한 방식으로 오브젝트 그래프의 프로퍼티를 통과하는 방문자 스타일 API 사용합니다.
Unity 프로퍼티를 사용하여 일반적으로 C# 타입을 읽거나 쓰고 타입별로 최소한의 처리 기능을 사용할 수 있습니다. 이를 통해 사용자가 정의한 커스텀 C# 타입을 사용하여 작업할 수 있으며, 예를 들어 이를 확인하거나 다른 표현 간에 전환할 수 있습니다.
Unity 프로퍼티를 사용하면 상대적으로 느리거나 메모리를 할당(가비지 컬렉터 오버헤드가 증가함)하고, 특히 IL2CPP로 AOT(Ahead-of-Time) 컴파일을 필요로 하는 플랫폼에서 지원이 제한되므로 반사를 방지하거나 최소화할 수 있습니다.
Unity 프로퍼티는 다음과 같은 일반적인 시나리오에 유용할 수 있습니다.
  • 데이터 확인 및 처리:
    • 오브젝트 그래프를 살펴보고 범위, null, 레퍼런스를 확인하거나 제약을 적용합니다.
    • 프로퍼티 간에 비교 분석, 해시를 계산하거나 감지를 변경합니다.
  • 복사, 복제 및 패치:
    • 컨테이너를 세부 복사하거나 특정 프로퍼티를 방문하여 패치를 적용합니다.
  • 저작-런타임 데이터 전환:
    • 예를 들어 프로퍼티 이동을 통해 ScriptableObject 구성 데이터를 런타임 구조체로 전환합니다.

기본 기능

Unity 프로퍼티 프레임워크에는 C# 유형 데이터를 일반적으로 처리하는 데 사용할 수 있는 다음의 기본 기능이 있습니다.
  • 프로퍼티 가방:
    IPropertyBag<T>
    은 타입
    T
    의 필드 및 등록 정보를 설명합니다. Unity 시스템이 타입의 프로퍼티를 열거할 수 있도록 프로퍼티 팩을 생성합니다.
  • 관객:
    Visit<TContainer, TValue>
    와 같은 콜백으로 방문자를 구현합니다. 프레임워크는 컨테이너의 프로퍼티를 가로질러 프로퍼티별로 로직을 호출합니다.
  • 어댑터: 특정 유형이 방문되거나 변환되는 방법을 사용자 지정하는 후크(예:
    Vector3
    , 열거형, Collections의 특수 처리).
  • 자산 경로 및 이동: 네스티드 컨테이너, 배열, 딕셔너리, 제어된 뎁스 및 옵션이 있는 경로를 통한 값 주소 지정 지원
이러한 기능을 함께 사용하는 자세한 예제는 Use
PropertyVisitor
to create a property visitor
및 Use low-level API to create a property visitor 를 참조하십시오.

추가 리소스