ドキュメント

Unity Engine

Unity Engine

ネイティブメモリアロケーターリファレンス

ネイティブブアロケーター設定のリファレンス
読み終わるまでの所要時間 11 分最終更新 5日前

ネイティブメモリーの割り当て方法は、コマンドライン引数を使用するか、Unity エディターの設定 (編集> プロジェクト設定> メモリー設定) を使用してコントロールできます。ネイティブメモリアロケーターのカスタマイズ方法については、ネイティブメモリアロケーターのカスタマイズ を参照してください。

Project Settings > Memory Settings, showing a selection of Player memory settings

以下の表に、各アロケーター設定、コマンドライン引数、デフォルト値に関する情報を示します。

主なアロケーター

これらのアロケーターは、Unity がほとんどの割り当てに使用するものです。

メインアロケーター

Unity がほとんどの割り当てに使用するアロケーター。以下の設定があります。

設定

説明

コマンドライン引数

初期値

メインスレッドブロックサイズ専用メインスレッドアロケーターのブロックサイズ。
memorysetup-main-allocator-block-size
バイト
共有スレッドブロックサイズ共有スレッドアロケーターのブロックサイズ。
memorysetup-thread-allocator-block-size
バイト

Gfx アロケーター

Unity が Gfx システムに関連する CPU 割り当てに使用するアロケーター。以下の設定があります。

設定

説明

コマンドライン引数

初期値

メインスレッドブロックサイズ専用メインスレッド Gfx アロケーターのブロックサイズ。
memorysetup-gfx-main-allocator-block-size
バイト
共有スレッドブロックサイズ共有スレッド Gfx アロケーターのブロックサイズ。
memorysetup-gfx-thread-allocator-block-size
バイト

その他のアロケーター

タイプツリーとファイルキャッシュに使用される割り当て以下の設定があります。

設定

説明

コマンドライン引数

初期値

ファイルキャッシュブロックサイズファイルキャッシュには、断片化を回避するための独自のアロケーターがあります。これはそのブロックサイズです。
memorysetup-cache-allocator-block-size
バイト
タイプ樹木ブロックサイズタイプ ツリーには独自のアロケーターがあり、多くの小さな割り当てによる断片化を回避します。これはそのブロックサイズです。
memorysetup-typetree-allocator-block-size
バイト

共有バケットアロケーター

メインアロケーター間で共有されるバケットアロケーター。以下の設定があります。

設定

説明

コマンドライン引数

初期値

バケットアロケーター粒度共有アロケーターのバケットのステップサイズ。
memorysetup-bucket-allocator-granularity
バイト
バケットアロケーター BucketCountバケット サイズの数。
memorysetup-bucket-allocator-bucket-count
8
バケットアロケーターブロックサイズバケットに使用されるメモリブロックのサイズ。
memorysetup-bucket-allocator-block-size
Editor:
8388608
bytes
プレイヤー:
4194304
bytes
バケットアロケーターブロック数割り当てられるブロックの最大数
memorysetup-bucket-allocator-block-count
エディター:
8

"Player",

スレッドごとの高速一時アロケーター

ごく短期間の割り当てを処理するスレッドローカルストレージ (TLS) アロケーター。

アロケーター

説明

コマンドライン引数

デフォルト値(バイト単位)

メインスレッドブロックサイズメインスレッドスタックの初期サイズ。
memorysetup-temp-allocator-size-main
エディター:
16777216

"Player",
ジョブ ワーカーのブロック サイズUnity ジョブ システム内の各ジョブ ワーカーのサイズ。
memorysetup-temp-allocator-size-job-worker
E262144
背景ジョブ ワーカー ブロック サイズ各背景ワーカーのサイズ。
memorysetup-temp-allocator-size-background-worker
32768
プリロードブロックサイズプリロード マネージャのスタック サイズ。
memorysetup-temp-allocator-size-preload-manager
エディター:
33554432

"Player",
オーディオ ワーカー ブロック サイズ各オーディオワーカースレッドのスタックサイズ。
memorysetup-temp-allocator-size-audio-worker
65536
クラウド ワーカーのブロック サイズクラウドワーカースレッドのスタックサイズ
memorysetup-temp-allocator-size-cloud-worker
32768
Gfx スレッドブロックサイズメインのレンダリングするスレッドのスタックサイズ
memorysetup-temp-allocator-size-gfx
262144
GI Baking Blocksize各 GI ワーカースレッドのスタックサイズ。
memorysetup-temp-allocator-size-gi-baking-worker
262144
ナビメッシュワーカーブロックサイズナビゲーションメッシュワーカースレッドのスタックサイズ
memorysetup-temp-allocator-size-nav-mesh-worker
65536

高速スレッド共有一時アロケーター

スレッド間で共有される短期割り当て用の高速リニアアロケーター。

アロケーター

説明

コマンドライン引数

デフォルト値(バイト単位)

ジョブアロケーターブロックサイズUnity が主にジョブワーカースレッドに使用する端数処理リニアスレッドアロケーター。
memorysetup-job-temp-allocator-block-size
2097152
背景ジョブ アロケーター ブロック サイズより長い期間の割り当てを可能にする、背景ワーカー用のリニアアロケーター。
memorysetup-job-temp-allocator-block-size-background
21048576
低メモリ プラットフォームのジョブ アロケーター ブロック サイズメモリが 2 GB 未満のプラットフォームでは、ジョブワーカーと背景ジョブの両方にこのサイズが使用されます。
memorysetup-job-temp-allocator-reduction-small-platforms
262144

プロファイラーアロケーター

Unity がプロファイラー専用に使用するアロケーター。アプリケーションのアロケーションパターンに干渉しません。以下の設定があります。

設定

説明

コマンドライン引数

初期値

プロファイラーブロックサイズプロファイラーの主要部分のブロックサイズ。
memorysetup-profiler-allocator-block-size
16777216
エディタープロファイラーブロックサイズプロファイラーのエディター部分のブロックサイズ。これはプレイヤーには存在しません。
memorysetup-profiler-editor-allocator-block-size
バイト

共有プロファイラーバケットアロケーター

プロファイラーおよびエディタープロファイラーアロケーターの共有バケットアロケーター。メモリ不足のプラットフォームでは使用できません。以下の設定があります。

設定

説明

コマンドライン引数

初期値

バケットアロケーター粒度共有アロケーターのバケットのステップサイズ。
memorysetup-profiler-bucket-allocator-granularity
バイト
バケットアロケーター BucketCountバケット サイズの数。例えば、値が 4 の場合、サイズは 16 バイト、32 バイト、48 バイト、64 バイトです。
memorysetup-profiler-bucket-allocator-bucket-count
8
バケットアロケーターブロックサイズバケットに使用されるメモリブロックのサイズ。
memorysetup-profiler-bucket-allocator-block-size
Editor:
33554432
bytes
プレイヤー:
4194304
bytes
バケットアロケーターブロック数割り当てられるブロックの最大数
memorysetup-profiler-bucket-allocator-block-count
エディター:
8

"Player",

追加リソース