Unity ウェブのメモリ
ウェブでのメモリ管理方法。
読み終わるまでの所要時間 19 分最終更新 5日前
Unity ウェブのメモリ制限によって、実行するコンテンツの複雑さが制限される場合があります。
ウェブコンテンツはブラウザーで実行されます。ブラウザーは、アプリケーションによるコンテンツの実行に必要なメモリーをメモリースペースに割り当てます。使用可能なメモリの量は、以下によって異なります。
- 使用するデバイス
- 使用するオペレーティングシステム
- 使用しているブラウザーと、それが32プロセッサーと64プロセッサーのどちらで動作するか
- ブラウザーの JavaScript エンジンがコードを解析するために必要なメモリ量
- ブラウザーがタブごとに別々のプロセスを使用するか、コンテンツが開いているほかのすべてのタブとメモリースペースを共有する必要があるか。
Unity ウェブのメモリ使用量
Unity ウェブ コンテンツの以下の領域では、ブラウザーにかなりの量のメモリを割り当てる必要があります。
Unity ヒープ
Unity はメモリヒープを使用して、すべての Unity ランタイムオブジェクトを保存します。これには、マネージオブジェクトとネイティブオブジェクト、ロードされたアセット、シーン、シェーダーが含まれます。これは、他のプラットフォームで Unity Player が使用するメモリに似ています。
Unity ヒープは、割り当てられたメモリの連続したブロックです。Unity は、アプリケーションのニーズに合わせてヒープの自動サイズ変更をサポートします。ヒープサイズは、アプリケーションの実行に応じて拡大し、 Player 設定で設定された Maximum Memory Size(最大メモリサイズ) に応じて最大 4 GB まで拡張できます。Unity はこのメモリーヒープを Memory オブジェクトとして作成します。Memory オブジェクトのバッファプロパティはサイズ変更可能な ArrayBuffer で、WebAssembly コードによってアクセスされるメモリの Raw バイトを保持します。
ヒープの自動サイズ変更は、ブラウザーがアドレススペースで連続したメモリブロックの割り当てに失敗した場合に、アプリケーションがクラッシュする原因になります。このため、Unity のヒープサイズをできるだけ小さく抑えることが重要です。したがって、アプリケーションのメモリ使用を計画するときは注意してください。Unity ヒープのサイズをテストする場合は、プロファイラーを使用してメモリーブロックの内容をプロファイルできます。
ウェブプレイヤー設定の「メモリー増加モード」オプションを使用して、ヒープの初期サイズと増加をコントロールできます。デフォルトのオプションは、すべてのデスクトップのユースケースで動作するように構成されています。ただし、モバイルブラウザの場合は、上級者向けの調整オプションを使用する必要があります。モバイルブラウザの場合は、初期メモリーサイズをアプリケーションの一般的なヒープ使用量に設定することを推奨します。
アセットデータ
Unity ウェブビルドを作成すると、Unity はファイルを生成します。ここには、アプリケーションの起動に必要なすべてのシーンとアセットが含まれます。Unityウェブは実際のファイルシステムにアクセスできないため、仮想メモリファイルシステムが作成され、ブラウザーはここでファイルを解凍します。Emscripten フレームワーク (JavaScript) は、このメモリファイルシステムをブラウザーのメモリスペースに割り当てます。コンテンツの実行中、ブラウザーのメモリは非圧縮データを保持します。ダウンロード時間とメモリ使用量の両方を低く抑えるには、この非圧縮データをできるだけ小さくします。
.data.dataメモリ使用量を削減するには、アセットデータをアセットバンドルにパックします。アセットバンドルは、アセットのダウンロードを完全にコントロールできます。アプリケーションがアセットをダウンロードするタイミングとランタイムがアセットをアンロードするタイミングをコントロールできます。未使用のアセットをアンロードしてメモリを解放できます。
AssetBundlesデータ・キャッシュを有効にすると、コンテンツのアセット・データをユーザーのマシンに自動的にキャッシュできます。つまり、後の実行中にデータを再ダウンロードする必要はありません。Unity ウェブ ローダーは、IndexedDB API と Caching API を使用してデータキャッシングを実装します。このオプションを使用すると、通常はブラウザーキャッシュでは大きすぎるファイルをキャッシュできます。
データ キャッシング オプションを有効にするには、ファイル> ビルド プロファイル > []> 公開設定 を選択します。
プレイヤー設定
?
ガベージコレクション
ガベージコレクションは、使用されていないメモリを見つけて解放するプロセスです。Unity ガベージコレクションの仕組みの概要は、『 自動メモリ管理 』を参照してください。ガベージコレクションプロセスをデバッグするには、Unity プロファイラーを使用します。
WebAssembly のセキュリティ制限により、ユーザープログラムは悪用を防ぐためにネイティブの実行スタックを確認することができません。つまり、ウェブ プラットプラットフォームでは、ガベージコレクターはマネージコードが実行されていないときにのみ実行でき (ライブの C# オブジェクトをリファレンスする可能性があります)、各プログラムフレームの終了にのみ実行されます。この不一致は、他のプラットフォームと比較してウェブでのガベージコレクション動作に違いが生じます。
このような違いがあるため、フレームごとに多くの一時割り当てを実行するコード、特にこれらの割り当てが一連のリニアサイズの増加を示す可能性がある場合は、ガベージコレクターに一時的な 2 次メモリの増加圧力が発生する可能性があります。
例えば、長期実行ループがある場合、以下のコードはウェブで実行すると失敗する可能性があります。これは、 for ループの反復の間にガベージコレクターが実行されないためです。この場合、ガベージコレクターは中間の文字列オブジェクトが使用するメモリーを解放することができず、Unity ヒープのメモリーが不足します。
string hugeString = "";for (int i = 0; i < 100000; i++){ hugeString += "foo";}
この例では、ループ終了時のの長さは 3 * 100000 = 300000 文字です。ただし、コードは最終的な文字列を生成する前に 10 万の一時文字列を生成します。ループ全体で割り当てられた合計メモリは 3 * (1 + 2 + 3 + ... + 100000) = 3 * (100000 * 100001 / 2) = 15 GB です。
hugeStringこの問題を回避するには、 を使用して大きな文字列を作成します。ネイティブプラットフォームでは、ループの実行中にガベージコレクターが文字列の以前の一時コピーを継続的にクリーンアップします。したがって、このコードの実行に合計15 GBのRAMは必要ありません。
StringBuilderusing System.Text;var stringBuilder = new StringBuilder();for (int i = 0; i < 10000; i++){ stringBuilder.Append("foo");}string hugeString = stringBuilder.ToString();
文字列の最大長がわかっている場合は、初期化時にのを設定することをお勧めします。
StringBuilderCapacityウェブプラットフォームでは、ガベージコレクターはフレームの終了まで一時的な文字列コピーを再要求しません。その結果、コードは 15 GB の RAM を割り当てようとするとメモリ不足になります。
以下のコードは、このタイプの一時的な 2 次メモリの圧迫が発生する 2 番目の例を示しています。
byte[] データ;for (int i = 0; i < 100000; i++){ data = new byte[i]; // do something temporary with data[]}
ここで、コードは一時的に 1 + 2 + 3 + ...+ 100000 バイト = 5 GB 相当のバイトを割り当てます。ただし、最後の 100 KB 配列のみが保持されます。これにより、最終的な出力で 100 KB しか必要ないのに、ウェブ プラットフォームのメモリが不足しているように見えます。
これらの種類の問題を制限するには、一時的メモリー割り当ての量が 4 倍に増加するコード構成を避けます。代わりに、最終的に必要なデータ サイズを事前割り当てするか、または類似のデータ構造体を使用して、幾何学的に容量を増加する予約を実行し、一時的なメモリ負荷を軽減します。
List<T>例えば、データ構造体の最終的なサイズがわかっている場合は、コンテナで、必要な容量の事前割り当てを可能にする機能の使用を検討してください。同様に、以前は数 MB のメモリを保持していたコンテナのサイズを縮小する場合に、 機能の使用を検討してください。
List<T>List<T>.ReserveCapacity()List<T>.TrimExcess()一時割り当て用の NativeArray
一時割り当てにを使用して、Unityウェブのガベージコレクション制限の一部に対処します。はガベージコレクターをバイパスし、Unityヒープのメモリ負荷を軽減します。 の詳細については、スレッドセーフ型 を参照してください。
NativeArray<T>NativeArray<T>NativeArray<T>NativeArray<T>- 基本型 (例えば、byte、int、long、float) とデータとしての構造体のみをサポートします。
- メモリ リークや using ステートメントの使用を避けるために、を使用して手動で破棄する必要があります。
Dispose() - ref return は実装していません。つまり、データを変更する場合は、値を一時変数にコピーして戻す必要があります。例を次に示します。
// Updating an element in NativeArray<MyStruct> requires a temporary // copy MyStruct temp = myNativeArray[i]; temp.memberVariable = 0; myNativeArray[i] = temp; // Incrementing an element in NativeArray<int> needs to use explicit // assignment since intNativeArrayInt[0]++ won't work intNativeArrayInt[0] = intNativeArrayInt[0]++;
以下の例は、ウェブ上の一時割り当てに を使用する方法を示しています。
NativeArray<T>using Unity.Collections;for (int = 0; i < 10000; i++){ using(var data = new NativeArray<byte>(i, Allocator.Temp)) { // Do something with data[] here // data.Dispose() will be automatically called at the end of the using // scope which immediately frees the memory }}