メモリ使用量 | 文書 - Roblox クリエーターハブ

エクスペリエンスに追加するすべての建物やスクリプトコンポーネントは、メモリを消費します。メモリ使用量がエンジンの制限に達すると、ユーザーのデバイスやサーバーがクラッシュする可能性があるため、使用量を積極的に監視する必要があります。

デベロッパーコンソールでは、メモリ使用量を監視するための2つのツールを提供しています。

メモリ — カスタムコンポーネントおよびエンジンの内部プロセスを含む、使用カテゴリごとのリアルタイムメモリ消費を表示します。
Luauヒープ — スクリプトのメモリ割り当てを指すヒープメモリのスナップショットを作成します。このツールは、オブジェクトタイプやエンジンクラスなどのさまざまな視点から現在のメモリ割り当てと問題を特定するのを助けるために、いくつかのビューを提供します。また、時間の経過に伴うメモリ使用の違いを比較するために、複数のスナップショットを作成することもできます。

You can open the console during a testing or live game session using any of the following ways:

Press F9.
Type /console into the chat.
Use the in-game menu:
1. Open the in-game Roblox Menu.
2. Select the Settings tab.
3. Scroll down to Developer Console and click Open.

メモリ

メモリツールは、リアルタイムのメモリ使用量をカテゴリ別に分類して表示します。各カテゴリのメモリ使用量をMB単位で表示し、時間の経過に伴う使用量の変化に関するチャートを生成します。

メモリ割り当てを表示するには：

デベロッパーコンソールを開きます。
ツールのドロップダウンを展開してメモリを選択します。
クライアント-サーバードロップダウンを展開してクライアントまたはサーバーを選択します。

メモリ使用量カテゴリやアイテムを参照します。時間の経過に伴う使用量を見たい場合は、カテゴリを展開してチャートを表示します。

CoreMemory — ネットワーク、アバター、あなたが直接制御できないGUI要素を含む、エンジンのコア構築プロセスによるメモリ使用量。

PlaceMemory — モデル、地形、パーツ、スクリプト、およびあなたがエクスペリエンスに追加する他のすべてのカスタム要素を含む、エクスペリエンスの構築に基づくメモリ使用量。

PlaceMemory参照

カテゴリ	説明
HttpCache	Robloxサーバーからロードされ、現在メモリ内のキャッシュに保持されているアセット（画像、メッシュなど）。
Instances	Instancesのプレイス内。
Signals	インスタンス間で発生するシグナル（1つのインスタンスで発生したイベントが別のインスタンスのイベントをトリガーする）。
LuaHeap	コアスクリプト（Robloxクライアントに同梱されているスクリプト）およびカスタムスクリプト用のヒープメモリ。
Script	Luauスクリプト。
PhysicsCollision	物理シミュレーション用の衝突データ。
PhysicsParts	物理ジオメトリと運動力学。
GraphicsSolidModels	ソリッドモデルをレンダリングするためのグラフィックスデータ。
GraphicsMeshParts	MeshPartオブジェクトのためのグラフィックス。
GraphicsParticles	パーティクルシステム用のグラフィックス。
GraphicsParts	パーツ用のグラフィックス。
GraphicsSpatialHash	一般的なレンダリング。
GraphicsTerrain	地形用のグラフィックス。
GraphicsTexture	テクスチャメモリ。
GraphicsTextureCharacter	キャラクター用のテクスチャメモリ。
Sounds	メモリ内のサウンド。
StreamingSounds	ストリーミングサウンド。
TerrainVoxels	地形ボクセル。
TerrainPhysics	地形の物理。
Gui	一般的なGUI要素によって使用されるメモリ。
Animation	ポーズやKeyframeSequenceキャッシュデータなど、アニメーションデータに使用されるメモリ。
Navigation	PathfindingServiceのためのサポート構造によって使用されるメモリ。

UntrackedMemory — システムが特定のソースに簡単に帰属させられないメモリ割り当て。
PlaceScriptMemory — あなたのスクリプトのメモリ使用量で、個々のスクリプトやカスタムメモリタグが全体のメモリ使用量にどのように寄与しているかについての洞察を提供します。
CoreScriptMemory — あなたが直接制御できない内部エンジンスクリプトによるメモリ使用量。

これらのカテゴリの中で、PlaceMemoryとPlaceScriptMemoryはパフォーマンスの最適化に最も重要であり、あなたの構築とスクリプトの選択がメモリ消費にどのように影響するか、最適化の可能な領域を理解するのに役立ちます。PlaceScriptMemoryに関する詳細を確認するには、Luauヒープツールを使用してスナップショットを作成し、さまざまなメトリクスによるメモリ割り当てを分析します。

一般的なメモリ使用問題およびベストプラクティスに関する詳細については、パフォーマンス最適化を参照してください。

Luauヒープ

Luauヒープツールは、変数、テーブル、関数、およびその他のランタイムデータ構造を格納するためにLuauスクリプトが使用するヒープメモリの現在の割り当てのスナップショットを作成することを可能にします。このツールは、オブジェクトタイプやエンジンクラスなど、さまざまな視点から問題を特定するのを助けるために、いくつかのビューを提供します。また、時間の経過に伴うメモリ使用の違いを比較するために、複数のスナップショットを作成することもできます。

スナップショットを作成する

メモリ割り当てのスナップショットを作成するには：

デベロッパーコンソールを開きます。
ツールのドロップダウンを展開してLuauHeapを選択します。
クライアント-サーバードロップダウンを展開してクライアントまたはサーバーを選択します。
スナップショットを作成ボタンをクリックします。

メモリ使用量を分析する

このツールは、Luauメモリ使用量について多くのビューを提供します：

グラフ — 集計されたメモリ使用量ツリーを表示し、各ノードはメモリが割り当てられたオブジェクトを表します。
オブジェクトタグ — ランタイムタイプ（例：function、table、およびthread）ごとのメモリサイズとカウントを表示します。
メモリカテゴリ — エンジンが割り当てたメモリカテゴリに基づくメモリサイズとカウントを表示します。エンジンは、割り当て時にオブジェクトにメモリカテゴリを割り当てます。
オブジェクトクラス — スクリプトで使用され、そのインスタンスを保存するエンジンクラスに基づくメモリサイズとカウントを表示します（例：EnumItem、Animation、CFrame）。重要なことに、このビューはエンジン内でのメモリ使用量を示さず、Luau VMのもののみを表示します。
ユニーク参照と親なしインスタンス — データモデルに親がなく、スクリプトからのみ到達可能なユニーク参照または残りのすべての参照のインスタンスのカウントと合計数を表示します。また、インスタンスオブジェクトを固定するすべてのパスも表示します。

グラフ

グラフビューは、すべてのLuauヒープビューの中で最も詳細で複雑なビューです。集計されたメモリ使用量ツリーを示し、各ノードはメモリが割り当てられたオブジェクトを表します。ツリーはオブジェクト間の接続方法を示し、オブジェクト参照間の最短経路を導き出します。以下のメモリサイズの列があります：

サイズ — 自身のメモリ使用量にデータ構造内の内容によるメモリ使用量を加えたもの。
自身 — データ構造自体に対して直接割り当てられたメモリ、含まれた内容によるメモリ使用量は除外。

グラフビューは、2 KB未満の要素を単一の…ノードとして表示します。

ツリーグラフのルートはregistryであり、すべてのエンジンおよびLuau参照（シグナルに接続された関数、タスクライブラリ、モジュールスクリプトによって返されたテーブル、グローバル関数、テーブル、およびクラスなど）を格納します。通常、次の一般的なエントリを親に持ちます：

Module @Path.To.Module はモジュールスクリプトによって返されるテーブルです。
name:123 =Path.To.Module は指定されたスクリプト内の関数です。匿名関数には名前がありません。最上位のノードは通常、グローバルスクリプト関数を指します。例：:1= Workspace.[ユーザー名].アニメート。
upvalue は捕捉した関数の参照です。詳細についてはローカルスコープを捕捉を参照してください。
env は関数の環境を指します。ほとんどのケースでは、スクリプトのグローバルスコープを表すテーブルです。
globals はスレッドの環境を指します。
[key] はテーブルキーとして機能するオブジェクトを表します。
array は配列を表します。
stack はすべての関数ローカルを格納する配列を指します。
constants は関数が使用するすべての定数値を表します。

メモリカテゴリ

メモリカテゴリビューは、エンジンが割り当て時にオブジェクトに割り当てるメモリカテゴリごとのメモリサイズとカウントを示します。デフォルトでは、メモリカテゴリはスクリプトと同じ名前を持ちますが、debug.setmemorycategory関数を使用してカスタムメモリカテゴリ名を割り当てることもできます。

ユニーク参照と親なしインスタンス

ユニーク参照および親なしインスタンスのビューは関連しています。どちらも、データモデルに親がなく、スクリプトからのみ到達可能なインスタンスのメモリ使用量を表示し、インスタンスオブジェクトを固定するすべてのパスを示します。インスタンスがLuauスクリプト内でのみ参照されている場合、それはユニーク参照の下に表示されます。そうでない場合、Robloxシステムによっても使用され、親なしインスタンスの下にも表示されます。両方のビューでは、次の2つのメトリクスが表示されます：

カウント — 同じパスから到達可能な同じ名前のインスタンスの数（例：同じテーブル内の複数のDragonという名前のインスタンス）。
総インスタンス — それらのルート内のオブジェクトの総数（例：Dragonインスタンスを構成するすべてのパーツ、スクリプト、音声オブジェクト）。

これらのビューは、不要な接続インスタンスを特定するのに役立ちます。それらをもはや必要としないときは切り離す必要があります。このビューで予期しないインスタンスが多数表示された場合は、それらを保持するパスをチェックし、それらが必要かどうかを評価してください。