Unity 매뉴얼 스크립팅 API 가이드

버전 정보

• 현재 지원되는 버전: 2022.3, 2023.2, 2023.1 등
• 다음 버전은 지원되지 않음: 전 버전 포함

스크립팅 개념

속성 (Attributes)

속성은 Unity 스크립트에서 클래스, 프로퍼티 또는 함수 위에 명시하여 특별한 동작을 나타내기 위해 사용되는 마커입니다. 예를 들어, HideInInspector 속성을 사용하면 공용 프로퍼티도 인스펙터에서 숨길 수 있습니다.

사용 예

다음은 HideInInspector 속성을 사용한 프로퍼티 선언 예입니다:

[HideInInspector]
public float strength;

이와 같이 속성을 활용하여 프로퍼티의 가시성을 제어할 수 있습니다. Unity에서는 사용자에게 유용하고 다양한 속성을 제공하며, 이들 속성은 API 레퍼런스 문서에 상세히 설명되어 있습니다.

관련 네임스페이스

• UnityEngine: 속성 관련 API 문서 참조 (예: AddComponentMenu)
• UnityEditor: 속성 관련 API 문서 참조 (예: CallbackOrderAttribute)

또한, .NET 라이브러리에도 여러 속성이 정义되어 있습니다. 이러한 속성들은 Unity 코드 개발에 많은 도움이 될 수 있습니다. 하지만, 주의해야 할 점은 .NET 라이브러리에 정의된 ThreadStatic 속성을 사용하지 않아야 한다는 것입니다. 이 속성을 Unity 스크립트에 추가하면 크래시가 발생할 수 있습니다.

참고자료

• 속성이 궁금하다면 Microsoft 문서를 참고하세요.

추가 정보

Unity Technologies에서 제공하는 다양한 자료와 튜토리얼을 통해 더 깊이 있는 이해를 돕고 있습니다. 스크립팅뿐만 아니라 Unity 에디터를 효과적으로 사용하는 방법에 대해서도 많은 자원이 있습니다.

활용 예제

여기서는 Unity의 속성을 활용한 간단한 예제를 소개합니다.

예제 1: 변수 숨기기

아래는 인스펙터에서 보이지 않도록 하려는 변수의 예입니다. 이 방법은 유용하게 게임 오브젝트의 속성을 정리할 때 사용할 수 있습니다.

[HideInInspector]
public float playerSpeed;

예제 2: 처리 순서 지정

다른 속성과 연계하여, 이벤트 처리의 순서를 지정하는 경우도 고려해볼 수 있습니다.

[CallbackOrder(1)]
void OnEnable() {
    // 초기화 코드
}

이러한 속성들을 활용함으로써 코드를 더 명확하고 관리하기 쉽게 만들 수 있습니다. Unity 스크립팅은 유연하게 사용할 수 있으므로 다양한 상황에 맞춰 응용해 보세요.

결론

Unity의 속성 기능은 스크립트를 더 강력하고 쉽게 관리할 수 있도록 도와줍니다. 다양한 속성을 이해하고 활용함으로써, Unity 개발 과정에서 이점을 얻을 수 있습니다.