기술 자료

Unity 엔진

Unity 엔진

저수준 네이티브 플러그인을 위한 메모리 관리자 API

Unity 메모리 관리자에 액세스하고 네이티브 플러그인의 메모리 사용량을 트래킹합니다.
읽는 시간 2분최근 업데이트: 9일 전

IUnityMemoryManager
메모리 관리자 API는 네이티브 플러그인에서 Unity의 메모리 관리 및 메모리 프로파일링을 사용할 수 있는 C++ 인터페이스입니다.
이 API 사용하면 다음을 수행할 수 있습니다.
  • 메모리 할당자를 통해 Unity 메모리 관리자에 액세스합니다.
  • Unity Memory Profiler 패키지를 통해 플러그인의 메모리 사용량을 트래킹합니다.
이러한 기능을 사용하면 동등한 C++ 메모리 관리 방법과 비교하여 플러그인의 메모리 할당을 더 쉽게 관리하고 프로파일링할 수 있습니다.
플러그인 API는
IUnityMemoryManager.h
헤더에 선언된 IUnityMemoryManager 인터페이스를 통해 제공됩니다. API 대한 전체 레퍼런스는 이 파일에서 확인할 수 있습니다. 헤더 파일을 찾으려면:
  • Windows에서는 Unity 설치의
    <UnityInstallPath>\Editor\Data\PluginAPI
    폴더에 헤더를 저장합니다.
  • macOS에서 Unity 애플리케이션을 오른쪽 클릭하고 Show Package Contents를 선택합니다. 헤더가
    Contents\PluginAPI
    입니다.
이 API 효과적으로 사용하려면 다음 개념에 익숙해야 합니다.

Unity 메모리 사용 트래킹

플러그인의 메모리 사용량을 추적하려면 Memory Profiler 패키지를 사용하여 스냅샷을 생성한 다음 All Of Memory 탭에서 스냅샷을 엽니다.
IUnityMemoryManager
를 사용하여 메모리를 할당하면 각 할당자를 만들 때 할당한 영역과 객체 이름 아래에 플러그인의 메모리 할당이 Memory Profiler에 표시됩니다.
아래 스크린샷은
IUnityMemoryManager
API로 할당된 네이티브 플러그인의 메모리를 보여주는 Memory Profiler 패키지 창을 보여줍니다. 이 예제에서는 메서드 CreateAllocator가 호출되었습니다. "MyNativePlugin"을 areaName 파라미터로, "MyPluginAllocator"를 objectName 파라미터로 사용했습니다. 자세한 내용은 IUnityMemoryManager API 레퍼런스를 참조하십시오.

The Memory Profiler package window displaying the memory used by a user-defined allocator named Plugin Backend Allocator.

자세한 내용은 스냅샷을 참조하십시오.

메모리 관리 제한 사항

이 API 사용하면 네이티브 플러그인을 개발할 때 Unity 메모리 관리 시스템을 사용할 수 있습니다. 위에서 설명한 대로 큰 이점이 있지만 여전히 한계가 있습니다. Unity 메모리 관리 시스템:
  • 자동으로 관리되지 않으므로 직접 메모리를 할당하고 할당 해제해야 합니다.
  • 가비지 컬렉터 추적하고 정리하지 않습니다.
네이티브 C++의 메모리는 관리되지 않으므로 애플리케이션의 모든 메모리 요구 사항을 추적해야 합니다. 여기에는 할당할 올바른 메모리 양을 선택하고 더 이상 필요하지 않을 때 할당을 해제하는 것이 포함됩니다.
각 할당에 가상 호출이 필요하므로
IUnityMemoryManager
API는 성능에 영향을 미칩니다. 이러한 성능 영향을 최소화하려면 API 사용하여 더 큰 메모리 블록을 덜 자주 할당합니다. 더 작고 빈번한 할당을 처리하려면 이 API 사용하여 더 큰 블록 하나를 할당한 다음 자체 코드를 작성하여 이 블록 내에서 메모리를 관리하십시오. 작은 할당에 자주 이 API 사용하지 마십시오.

추가 리소스