기술 자료

Unity 엔진

Unity 엔진

Unity 프로그래밍 성공 사례

Unity 애플리케이션용 코드를 작성할 때 주의해야 할 주요 사항과 흔히 발생하는 장애물을 피할 수 있는 베스트 프랙티스
읽는 시간 6분최근 업데이트: 9일 전

Unity 프로그래밍 환경에는 표준 C#/.NET 프로젝트에 비해 코드를 작성할 때 추가로 고려해야 하는 몇 가지 고유한 기능이 있습니다. 다음은 Unity 애플리케이션용 코드를 작성할 때 주의해야 할 주요 문제에 대한 요약과 함께 흔히 발생하는 문제를 피하는 데 도움이 되는 베스트 프랙티스입니다.

Unity 오브젝트 라이프사이클 및 레퍼런스

Unity C#을 작성할 때 다른 오브젝트나 null 동일하게 오브젝트를 비교할 때 주의해야 합니다. UnityEngine.Object에서 상속하는 타입의 경우 Unity는 C# 평등 및 불평등 연산자의 커스텀 버전을 사용합니다. 즉, null 확인
myGameObject == null
은
myGameObject
가 기술적으로 유효한 C# 객체 참조를 보유하고 있더라도
true
를 평가할 수 있습니다(그 반대로
myGameObject != null
는
false
를 평가할 수 있습니다). 이 동작의 세부 사항에 대한 자세한 내용은 커스텀 평등 연산자를 참조하십시오.
Unity 커스텀 동작과 오브젝트 라이프사이클은 코드에 몇 가지 영향을 미칩니다.
  • 삭제된 객체를 체크에서 제외하려는 경우 Unity 객체에
    ReferenceEquals
    가 아닌
    if (obj == null)
    를 사용해야 합니다.
  • 실제 C# null 레퍼런스가 있는지 확인하려면 먼저
    ReferenceEquals
    를 사용하거나
    System.Object
    에 캐스트합니다.
  • 두 개의 Unity 오브젝트를 비교하여 균등을 얻을 때는 두 레퍼런스가 서로 다른 C# 오브젝트인 경우에도
    obj1 == obj2
    가
    true
    를 반환할 수 있습니다. 예를 들어 하나 또는 둘 다
    Undo
    를 통해 파괴되고 재생성되었을 때도 마찬가지입니다.
  • 커스텀 Equality 연산자는 표준 C# 1보다 느립니다. 일반적으로 문제가 되지 않지만 크기와 핫 경로에서 주의해야 합니다.
  • 컴포넌트는 삭제할 수 있지만 관리되지 않는 상대 오브젝트가 없는 C# 래퍼 오브젝트로 남아 있기 때문에 보존 없이 씬의 언로드에 대해 캐싱하지 마십시오.
  • 정적 필드에 큰 에셋에 대한 강렬한 레퍼런스는 씬에 걸쳐 유지되고 언로딩을 방지하기 때문에 유지하지 마십시오.
  • 오브젝트를 파괴할 때
    Object.DestroyImmediate
    는 에디터 전용이므로 런타임 시점에
    Object.Destroy
    를 사용하고 Unity가 파괴를 예약하도록 합니다.

C# 완료자 사용 안 함

다음과 같은 이유로 런타임 코드에서 C# 마무리기를 사용하지 마십시오.
  • 별도의 파니메이터 스레드에서 실행되며, 일반적으로 Unity API에는 메인 스레드 필요합니다.
  • 결정론적으로 실행되지 않아 예측할 수 없는 동작이 발생합니다.
  • 애플리케이션 가비지가 수집하고 대기하지 않는 한 실행되지 않을 수 있습니다.
  • 완료자에서 발생하는 예외는 특별히 처리되지 않으면 애플리케이션이 중지될 수 있습니다.
  • 그들의 존재 자체로 가비지 컬렉터 오버헤드를 증가시킵니다.

가비지 컬렉터 오버헤드 및 할당

Unity 애플리케이션에서 가장 중요한 성능 위험 요소 중 하나는 메모리를 할당하고 특히 핫 경로에서 가비지 컬렉터 오버헤드를 증가시키는 런타임 코드입니다.
이를 방지하려면 다음 코딩 방법을 적용하십시오.
  • 캐싱 및 리스트 재사용을 통해 프레임별 할당을 방지하고 가능한 경우 할당되지 않는 버전의 메서드를 사용합니다. 여기에는 캐싱
    WaitForSeconds
    및 기타 코루틴 사용 시 출력 지침이 포함됩니다.
  • 가능한 경우 할당되지 않는 메서드 버전을 사용하고
    Update
    에서 반복적으로 호출하는 대신
    Awake
    의
    GameObject.GetComponent
    및 반환된 객체에 대한 레퍼런스를 캐시하는 등의 비용이 많이 드는 작업을 수행하십시오.
  • 런타임 코드에서 특히 프레임당
    Update
    또는
    FixedUpdate
    및 기타 핫 경로의 맥락에서 LINQ를 사용하지 마십시오.
    System.Linq
    네임스페이스의 메서드는 불필요한 할당을 생성하고 박싱 및 닫기를 포함할 수 있습니다.
  • 연결과 같은 반복된 문자열 작업을 피하십시오.
  • 반사 인스턴스를 식별하고 회피합니다. 자세한 내용은 C# 반사 오버헤드 방지를 참조하십시오.
이러한 문제에 대한 자세한 지침과 예제는 관리되는 메모리에 대한 코드 최적화를 참조하십시오.
가비지 컬렉터의 오버헤드를 추적하고 줄이는 방법에 대한 자세한 내용은 관리되는 메모리를 참조하십시오.

MonoBehaviour 업데이트 루프 최적화

많은 Unity 프로젝트의 기존 패턴으로 MonoBehaviour 스크립트 컴포넌트를 사용하여 일반적으로 초당 여러 번 실행되는
MonoBehaviour.Update
,
MonoBehaviour.FixedUpdate
및
MonoBehaviour.LateUpdate
와 같은 빌트인 콜백을 통해 정기적으로 게임 상태를 업데이트합니다.
이 간단한 모델은 적절하게 사용할 경우에도 제대로 작동할 수 있지만, 다음과 같은 몇 가지 주요 성능 위험 요소가 있습니다. 이는 일반적으로 경험이 없는 개발자에게 흔히 나타납니다.
  • Unity 프레임당 기본 구현 또는 기타 일반 이벤트 함수는 스케일이 부족할 수 있습니다. 이러한 각
    Update
    함수는 Unity의 내부 관리 및 네이티브 레이어와의 상호작용으로 인해 약간의 부하가 발생합니다. 이러한 MonoBehaviour 스크립트가 많으면 누적 오버헤드가 성능에 상당한 영향을 미칠 수 있습니다.
  • 빌트인 업데이트가 매우 자주 실행되므로 핫코드 경로가 되고 비효율적이고 메모리를 많이 소모하는 작업의 효과가 커집니다. 경험이 없는 사용자의 일반적인 나쁜 패턴은 대부분의 경우 불필요하게 실행되거나 실행 시 불필요하게 메모리를 소모하는
    Update
    함수를 가진 MonoBehaviour 스크립트가 많다는 것입니다.
이러한 위험 요소를 완화하려면 다음 옵션을 고려하십시오.
  • Unity의 엔티티 컴포넌트 시스템(ECS)을 사용하여 프로젝트를 데이터 지향 아키텍처로 전환하여 여러 Entities로 확장성을 높일 수 있습니다.
  • MonoBehaviour 기반 아키텍처를 사용하는 경우:
    • 핫 경로에서 관리되는 메모리 영향을 최소화하려면 관리되는 메모리에 대한 코드 최적화를 참조하십시오.
    • 중앙 집중식 업데이트 관리자를 사용하거나 플레이어 루프를 커스터마이즈하여 활성화된
      Update
      함수의 수를 최소화합니다. 자세한 내용은 커스텀 업데이트 관리자 사용 및 플레이어 루프 사용자 정의를 참조하십시오.
    • MonoBehaviour 기반 프로젝트에서도 Unity 데이터 지향 시스템의 특정 기능을 사용할 수 있다는 점에 유의하십시오. 코드의 잡을 사용하고, 코드 섹션을 버스트 컴파일하고, 성능이 중요한 코드 섹션의
      NativeArray
      와 같은 더 효율적인 데이터 구조를 사용하고, 관리되는 API(예: 트랜스폼 작업용 API) 대신 관리되지 않는 대안을 선택할 수 있습니다.

스레드 안전

Unity에는 다중 스레드 기능이 있지만, 코어 런타임은 단일 스레드이며,
UnityEngine
및
UnityEditor
네임스페이스의 대부분의 API는 메인 스레드에서만 호출할 수 있습니다. 백그라운드 스레드에서 GameObjects, Transforms, Components 또는 Asset API를 참조하지 마십시오. 메인 스레드에
Task.Result
또는
Task.Wait
로 결코
await
하지 마십시오. 이로 인해 고정 상태가 발생합니다.
자체적으로 비동기적이고 오래 실행되는 작업을 처리할 때, Unity는 .NET
Task
에 대한 Unity 전용 대안으로
Awaitable
클래스를 제공합니다.
Awaitable
는 오브젝트 풀링을 사용하여 할당을 줄이고,
Update
및
FixedUpdate
와 같은 Unity 전용 개념을 알고 있으므로 작업을
await
하고 플레이어 루프의 특정 지점에서 다시 시작하도록 예약할 수 있습니다. 자세한 내용은 Awaitable 클래스를 사용한 비동기 프로그래밍을 참조하십시오.
수명이 짧지만 컴퓨팅 집약적인 병렬 작업의 경우 Unity는 버스트 컴파일이 가능한 잡 시스템을 제공합니다. 자세한 내용은 작업 시스템을 사용하여 멀티스레드 코드 작성을 참고하십시오.

컴파일 고려 사항

최적의 성능을 위해서는 코드를 작성하는 방식뿐만 아니라 컴파일하는 방식도 고려해야 합니다. 코드를 순진하게 컴파일하는 대신 특정 소스 파일 또는 코드 영역과 관련된 컨텍스트를 적극적으로 정의하면 다음과 같은 비용이 발생합니다.
  • 불필요한 코드가 포함된 경우 빌드 크기가 증가합니다.
  • 변경 사항을 적용하기 위해 컴파일하고 다시 컴파일하는 데 소비한 시간입니다. 이는 특히 에디터에서 반복 시간에 영향을 미칠 수 있습니다.
  • 특정 플랫폼 또는 컨텍스트에 부적절한 코드가 포함된 경우 발생할 수 있는 런타임 오류입니다.
Unity 다양한 플랫폼 및 컨텍스트에 대해 컴파일되는 코드 부분을 제어하는 데 도움이 되는 여러 메커니즘을 제공합니다.
  • 어셈블리 정의를 사용하여 소스 파일을 별도로 컴파일할 수 있는 어셈블리로 그룹화할 수 있습니다. 이를 통해 에디터 전용 코드를 런타임 코드와 플랫폼별 코드를 크로스 플랫폼 코드와 분리할 수 있습니다. 자세한 내용은 스크립트를 어셈블리로 구성을 참고하십시오.
  • 타겟 플랫폼 또는 컨텍스트에 따라 컴파일에서 코드의 특정 영역을 제외하기 위해 스크립팅 기호와 함께
    #if
    지시문을 사용할 수 있습니다. 예를 들어 에디터 전용 코드를
    #if UNITY_EDITOR
    지시문 뒤에 보호하여 런타임 빌드에서 제외합니다. Unity가 코드를 조건부로 포함 또는 제외하는 다양한 방법에 대한 자세한 내용은 조건부 컴파일을 참조하십시오.
  • Unity 전용 주요 개념은 플레이 모드를 시작하고 종료하거나 스크립트를 다시 컴파일할 때 에디터에서 도메인 재로드입니다. 도메인 재로드는 시간이 많이 소요되며, 에디터에서 작성하고 테스트할 때 반복 시간에 영향을 미칠 수 있습니다. 플레이 모드를 시작할 때 도메인 재로드를 비활성화하여 반복 시간을 개선할 수 있지만, 정적 상태를 수동으로 재설정해야 합니다. 자세한 내용은 플레이 모드 시작 시 코드 및 씬 재로드를 참조하십시오.

Unity 분석 툴

Unity 병목 현상을 식별하고 성능 향상된 코드를 작성하는 데 도움이 되는 다양한 툴을 제공합니다. Project Auditor 툴은 프로젝트 코드를 분석하여 일반적인 성능 문제를 식별하고 수정 사항을 제안할 수 있습니다. CPU 및 GPU 사용량, 메모리 할당 등에 대한 자세한 정보를 제공하여 코드에서 런타임 성능 병목 현상을 파악하는 데 도움이 되는 프로파일러입니다. 코딩 표준을 적용하고 프로젝트에 맞는 성능 문제를 식별하기 위해 Roslyn 분석기를 만들 수도 있습니다.
사용자 지정 Roslyn 분석기 및 소스 제너레이터 제작에 대한 자세한 내용은 Roslyn 분석기 및 소스 제너레이터를 참조하십시오.
Unity의 분석 툴 제품군에 대한 자세한 내용은 최적화를 참고하십시오.

추가 리소스