ドキュメント

Unity Engine

Unity Engine

アンマネージ C# メモリ

ネイティブコンテナへのメモリの割り当て方法をコントロール。
読み終わるまでの所要時間 11 分最終更新 5日前

C# アンマネージメモリーレイヤーを使用すると、ネイティブメモリーレイヤーにアクセスしてメモリー割り当てを微調整できます。C# コードを記述するだけで簡単に行えます。
Unity Core APIの
Unity.Collections
名前空間(
NativeArray
を含む)とUnity Collectionsパッケージのデータ構造を使用して、C#アンマネージメモリにアクセスできます。Unityのジョブ システム、つまりBurstを使用する場合は、C#アンマネージ メモリを使用する必要があります。

ネイティブコンテナの概要

Unity のネイティブコードは、Unity のネイティブメモリマネージャーによってマネージされるメモリラベル、領域、ルートのシステムを通じて、ネイティブブメモリの使用を追跡します。プロファイラーはネイティブメモリーマネージャーを使用して、ネイティブメモリーの使用を監視します。アセットガベージコレクターは、
UnityEngine.Object
から継承するタイプも追跡します。そのため、
Resources.UnloadUnusedAssets
の呼び出し時に、参照されなくなったアセットに割り当てられたメモリをクリーンアップできます。
Unityのネイティブ メモリ マネージャは、メモリ ラベルを使用してメモリ使用量を分類し、メモリを割り当てる
Allocator
を選択します。メモリマネージャーが各ラベルに使用するアロケーターは、プラットフォームによって異なります。
メモリーマネージャーは、領域を使用してメモリー使用をプロファイリング目的で分類します。ルートを使用して、1 つのルート下の関連するメモリ割り当てを追跡します。例えば、
UnityEngine.Object
から継承する各タイプのネイティブメモリは、
Object
と呼ばれる領域にルートを持ちます。例えば
Resources.UnloadUnusedAssets
によってオブジェクトが削除されると、そのオブジェクトのルートに関連付けられているすべての割り当ても解放されます。
Memory Profiler パッケージを使用すると、メモリーラベル、領域、ルートの順序でメモリー使用量を確認できます。また、どの基本アロケーターがメモリを地域名によって割り当てたかも確認できます。

アロケータータイプ

特定のネイティブアロケータータイプを、
Unity.Collections
名前空間のネイティブコンテナタイプとともに使用できます。この方法で使用可能なアロケーターのタイプは次のとおりです。
  • 短期割り当て用の一時アロケータータイプ。
  • ジョブからジョブに渡される、より長期にわたる割り当てのための一時アロケーターのタイプ。
  • 一時的な制限のないアロケーター。
  • DSP オーディオカーネル割り当てのアロケーター。
  • ドメインの生存期間を持続するアロケーター。
これらの型を使用するには、
Allocator
enum 値を渡し、使用するネイティブアロケータータイプのメモリラベルを選択します。選択した
Temp
アロケーターがいっぱいの場合、Unity は代わりにフォールバック アロケーターを選択します (通常は
TempJob
または Temp Overflow)。

Temp

Temp
は Unity の一時アロケータータイプです。これは、1つのジョブ内で実行される一時割り当てなど、フレーム境界を超えることができない小規模な短期割り当て向けに設計されています。
Temp
タイプは、Unity がメイン メモリ プールから割り当てる少量のメモリ用のスタック タイプのアロケーターです。
複数の
Temp
アロケーターがあり、アロケーターを必要とする各スレッドに 1 つずつあります。Unityは
Temp
アロケーターをフレームごとにリサイクルし、クリーンなメモリ使用パターンを保証します。ただし、フォールバック アロケーターにメモリがスピルオーバーすると、そのメモリが断片化される可能性があります。
Profiler.GetTempAllocatorSize
と
Profiler.SetTempAllocatorRequestedSize
を使用して、
Temp
アロケーターのサイズを取得および設定できます。
Temp
アロケーターのサイズは、デフォルトで次の値になります。
  • エディター:16 MB メインスレッド、256 KB ワーカースレッド
  • Players (プレイヤー)4 MB メインスレッド、256 KB ワーカースレッド
これらのサイズを超えた場合、メインスレッドの割り当ては
TempJob
アロケーターにフォールバックし、他のスレッドの割り当ては一時オーバーフローアロケーターにフォールバックします。一時ネイティブ割り当ての詳細については、スレッドストレージローカル (TLS) アロケーターのドキュメントを参照してください。

TempJob

このタイプは、Unity がメインメモリから割り当てる
TempJob
領域に格納するリニアスタイルアロケーターを使用します。これは、ジョブ間で渡される大規模な一時割り当てや、フレーム間でデータを運ぶ可能性がある一時割り当て向けに設計されています。割り当てが作成から 4 フレーム以内に破棄されない場合は、Unity エディターに注意が表示されます。
注
使用可能なメモリが不足している場合、Unity はメイン メモリ(malloc)でオーバースピル割り当てを行います。ほとんどのプラットフォームでは最大 64 MB の
TempJob
メモリを使用できますが、これよりも小さいメモリ システムでは、この制限は 16 MB まで低くすることができます。
このアロケーターがいっぱいの場合、割り当ては Temp Job Overflow アロケーターにフォールバックします。一時ジョブ割り当ての詳細については、スレッドセーフリニアアロケーターのドキュメント を参照してください。

--persistent

このアロケーターは時間制限なしでメモリを割り当て、デバイスの空きメモリ量によってのみ制限されるため、フォールバックは行われません。必要な期間だけ存在できますが、これはまた、割り当て済みメモリーを再度解放しないと、
DisposeSentinel
クラスのみが警告を発し、メモリーへのハンドルがガベージコレクションされた場合にだけ警告を発します。永続化されたメモリの割り当ては、一時メモリの割り当てよりも遅くなります。

追加リソース