---
title: Unity 속성 소개
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/object-oriented-development/properties/intro
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/object-oriented-development/properties/intro.md
generated_at: 2026-11-19T13:51:51.883Z
locale: ko-kr
---

# Unity 속성 소개

> Unity 프로퍼티 API 기초와 용도를 이해합니다.

Unity 속성은 런타임 시 C# 유형의 속성을 탐색하고 수정할 수 있는 시스템입니다. 이는 예측 가능하고 제어 가능한 방식으로 오브젝트 그래프의 프로퍼티를 통과하는 방문자 스타일 API 사용합니다.

Unity 프로퍼티를 사용하여 일반적으로 C# 타입을 읽거나 쓰고 타입별로 최소한의 처리 기능을 사용할 수 있습니다. 이를 통해 사용자가 정의한 커스텀 C# 타입을 사용하여 작업할 수 있으며, 예를 들어 이를 확인하거나 다른 표현 간에 전환할 수 있습니다.

Unity 프로퍼티를 사용하면 상대적으로 느리거나 메모리를 할당(가비지 컬렉터 오버헤드가 증가함)하고, 특히 [IL2CPP](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp.md)로 AOT(Ahead-of-Time) 컴파일을 필요로 하는 플랫폼에서 지원이 제한되므로 [반사](https://learn.microsoft.com/en-us/dotnet/fundamentals/reflection/reflection)를 방지하거나 최소화할 수 있습니다.

Unity 프로퍼티는 다음과 같은 일반적인 시나리오에 유용할 수 있습니다.

* 데이터 확인 및 처리:

  * 오브젝트 그래프를 살펴보고 범위, null, 레퍼런스를 확인하거나 제약을 적용합니다.
  * 프로퍼티 간에 비교 분석, 해시를 계산하거나 감지를 변경합니다.

* 복사, 복제 및 패치:
  * 컨테이너를 세부 복사하거나 특정 프로퍼티를 방문하여 패치를 적용합니다.

* 저작-런타임 데이터 전환:
  * 예를 들어 프로퍼티 이동을 통해 ScriptableObject 구성 데이터를 런타임 구조체로 전환합니다.

## 기본 기능##fundamental-features

Unity 프로퍼티 프레임워크에는 C# 유형 데이터를 일반적으로 처리하는 데 사용할 수 있는 다음의 기본 기능이 있습니다.

* [프로퍼티 가방](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-bags.md): [`IPropertyBag<T>`](/engine/6000.0/script-reference/unity/properties/ipropertybag1.md)은 타입 `T`의 필드 및 등록 정보를 설명합니다. Unity 시스템이 타입의 프로퍼티를 열거할 수 있도록 프로퍼티 팩을 생성합니다.
* [관객](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors.md): [`Visit<TContainer, TValue>`](/engine/6000.0/script-reference/unity/properties/ipropertyvisitor/visit.md)와 같은 콜백으로 방문자를 구현합니다. 프레임워크는 컨테이너의 프로퍼티를 가로질러 프로퍼티별로 로직을 호출합니다.
* 어댑터: 특정 유형이 방문되거나 변환되는 방법을 사용자 지정하는 후크(예: `Vector3`, 열거형, Collections의 특수 처리).
* [자산 경로 및 이동](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-paths.md): 네스티드 컨테이너, 배열, 딕셔너리, 제어된 뎁스 및 옵션이 있는 경로를 통한 값 주소 지정 지원

이러한 기능을 함께 사용하는 자세한 예제는 [Use `PropertyVisitor` to create a property visitor](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-property-visitor.md) 및 [Use low-level API to create a property visitor](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-low-level-api.md) 를 참조하십시오.

## 추가 리소스##additional-resources

* [자산 가방](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-bags.md)
* [자산 방문자](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors.md)
* [자산 경로](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-paths.md)
* [`PropertyVisitor`를 사용하여 등록 정보 방문자 만들기](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-property-visitor.md)
* [로우 레벨 API를 사용하여 프로퍼티 방문자 생성](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-low-level-api.md)
