Version: 2023.2
언어: 한국어
로우레벨 네이티브 플러그인 셰이더 컴파일러 액세스
IUnityMemoryManager API reference

Memory Manager API for low-level native plug-ins

The IUnityMemoryManager memory manager API is a C++ interface that allows you to use Unity’s memory management and memory profiling in native plug-ins.

This API enables you to:

  • Access Unity’s memory manager through a memory allocator.
  • Track your plug-in’s memory use through Unity’s Memory Profiler package.

These features make it easier to manage and profile your plug-in’s memory allocations when compared to the equivalent C++ memory management methods.

The plug-in API is provided by the IUnityMemoryManager interface, which is declared in the IUnityMemoryManager.h header. The full reference for the API is available in this file. To find the header file:

  • On Windows, Unity stores the header in the <UnityInstallPath>\Editor\Data\PluginAPI folder of your Unity installation.
  • On macOS, right-click on the Unity application, and select Show Package Contents. The header is in Contents\PluginAPI.

You should be familiar with the following concepts to use this API effectively:

Track memory use in Unity

To track your plug-in’s memory usage, use the Memory Profiler package to take a snapshot, then open the snapshot in the All Of Memory tab. When you use the IUnityMemoryManager to allocate memory, the Memory Profiler displays the plug-in’s memory allocations under the area and object name you assigned when you created each allocator.

The below screenshot shows the Memory Profiler package window displaying memory used by a native plug-in with memory allocated with the IUnityMemoryManager API. In this example, the method CreateAllocator was called, with “MyNativePlugin” as the areaName parameter, and “MyPluginAllocator” as the objectName parameter. For more information, see CreateAllocator.

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

For more information, see Snapshots.

Memory management limitations

This API enables you to use Unity’s memory management system when you develop native plug-ins. This has major benefits as described above, but there are still limitations. Unity’s memory management system:

  • Isn’t automatically managed; you need to allocate and deallocate the memory yourself.
  • Isn’t tracked and cleaned up by a garbage collector.

Since memory in native C++ isn’t managed, you need to keep track of any memory requirements your application has. This includes choosing the correct amount of memory to allocate and making sure you deallocate it when it’s no longer needed.

The IUnityMemoryManager API impacts performance because each allocation requires a virtual call. To minimize this performance impact, use the API to allocate larger blocks of memory less frequently. To handle smaller and more frequent allocations, use this API to allocate a single larger block, then write your own code to manage the memory within this block. Don’t use this API for frequent small allocations.

추가 리소스

로우레벨 네이티브 플러그인 셰이더 컴파일러 액세스
IUnityMemoryManager API reference
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961