File Access プロファイラーモジュールリファレンス
File Accessモジュールのリファレンス。アプリケーションのファイル・アクティビティに関するデータを収集します。
読み終わるまでの所要時間 16 分最終更新 5日前
File Access プロファイラーモジュールは、Unity が実行する読み取りまたは書き込み操作の数や開いているファイルハンドルの数など、アプリケーションのファイルアクティビティに関する情報を表示します。モジュールは、この情報を特定のフレームまたはキャプチャ内のすべてのフレームでディスプレイできます。この情報を使用して、アプリケーションがファイル操作をどれだけ効率的に実行するかを確認できます。
File Access モジュールは、ビルドされたアプリケーションのフォルダー構造体内、または Unity Unity エディターでプロファイラーを実行する場合は Unity プロジェクトフォルダー内のファイル操作に関する情報をキャプチャできます。このモジュールは、失敗したファイル操作に関する情報を収集しません。ファイル操作が失敗すると、Unity はエラーを表示します。
このモジュールはデフォルトでは有効になっていません。File Access プロファイラーモジュールを有効にするには、プロファイラーモジュールのアクティブ化 を参照してください。
グラフのカテゴリ
プロファイラー ウィンドウの上半分には、以下のカテゴリのファイルアクセスチャートが表示されます。
グラフ | 説明 |
|---|---|
| 開かれたファイル | このフレームでローカル ファイル システムで正常に開かれたファイルの総数。 |
| 閉じられたファイル | このフレームでローカル ファイル システムで正常に閉じられたファイルの総数。 |
| ファイルシーク | このフレームにローカル ファイル システムで実行されたファイル シーク操作の数。ファイルシーク操作には、ファイルのコンテンツ内の検索が含まれます。 |
| 飛行中の読み取り | このフレームで進行中の読み取り操作の総数。 |
| 開いているファイルハンドル | このフレーム中の任意の時点で開いているファイルハンドルの総数。Unity が同じフレーム内で開いたり閉じたりするファイルも含まれます。 |
モジュール詳細ペイン ツールバー
File Access プロファイラーモジュールでフレームを選択すると、モジュールの詳細ペインにキャプチャ中に Unity がアクセスしたファイルに関する詳細情報が表示されます。ツールバーを使用して、以下の機能にアクセスします。
プロパティ | 説明 |
|---|---|
| View ドロップダウン | ドロップダウンを使用して、データのビューを変更します。
|
| フレームドロップダウン | ドロップダウンから、ファイル情報をディスプレイするフレーム数を選択します。
|
| マーカーの分析 | このモジュールは、詳細ペインに自動的に入力しません。[Analyze Markers] ボタンを選択して、詳細ペインにデータを入力します。 |
ファイル サマリー ビュー
File サマリービューには、キャプチャ中に各ファイルに発生したすべてのファイル・アクセス操作のサマリーが表示されます。テーブル内の 1 つのエントリーは、1 つのファイルの完全なサマリーを表します。
以下の表は、[File サマリー] ビューの表でディスプレイできるすべての統計情報を示しています。すべての統計カラムがデフォルトで有効になっているわけではありません。列を有効または使用不可にするには、列ヘッダーを含む行の任意の場所を右クリックしてメニューを開きます。このメニューを使用して、各列のビューを有効または使用不可にします。
値 | 説明 |
|---|---|
| ファイル名 | アクセスされたファイルの名前 |
| Total Bytes Read (読み取り合計バイト数) | 選択されたフレーム中に Unity がこのファイルから読み取った情報の合計バイト数。 |
| 読み取りアクセス時間 (ミリ秒) | 選択されたフレーム中に Unity がこのファイルからの読み取りに費やした合計時間。 |
| アクセス数 | 選択されたフレーム中の、このファイルへのあらゆるタイプのアクセスの合計数。 |
| 最初のフレーム | Unity がこのファイルにアクセスした最初のフレーム。 |
| フレーム数 | Unity がこのファイルにアクセスしたフレームの総数。 |
| ID | ファイルアクセスマーカーの実行順序を表すインデックス。 |
| 読み取り帯域幅 (MBps) | 選択されたフレームにおける、このファイルに対する読み取り操作の平均帯域幅 (MB/秒)。 |
| Open Count | 選択されたフレーム中の、このファイルを開く操作の総数。 |
| Close Count (終了数) | 選択されたフレーム中の、このファイルのクローズ操作の総数。 |
| 読み取り回数 | 選択されたフレーム中のこのファイルに対する読み込み操作の合計数。 |
| 書き込み数 | 選択されたフレーム中の、このファイルに対する書き込み操作の総数。 |
| シーク数 | 選択されたフレーム中の、このファイルに対するファイルシーク操作の総数。 |
| Total Bytes Written (書き込まれた合計バイト数) | 選択されたフレーム中に Unity がこのファイルに書き込んだ合計バイト数。 |
| 書き込み帯域幅 (MBps) | 選択されたフレームにおける、このファイルに対する書き込み操作の平均帯域幅(単位:メガバイト/秒)。 |
| オープンアクセス時間 (ミリ秒) | 選択されたフレーム中に Unity がこのファイルを開く操作に費やした合計時間(ミリ秒)。 |
| クローズアクセス時間 (ミリ秒) | 選択されたフレーム中に Unity がこのファイルに対してクローズ操作に費やした合計時間(ミリ秒)。 |
| 書き込みアクセス時間 (ミリ秒) | 選択されたフレーム中に Unity がこのファイルへの書き込み操作に費やした合計時間(ミリ秒)。 |
| Total Access Time (ms) (合計アクセス時間 (ミリ秒)) | 選択されたフレーム中に Unity がこのファイルへのアクセスに費やした合計時間(ミリ秒)。 |
Accesses ビュー
Accessesビューには、キャプチャ内の各ファイル・アクセス操作に関する詳細情報が表示されます。プロファイラーの詳細ペインの表内の各エントリーは、1 つのファイルへの 1 つのファイルアクセス操作を表します。以下の表は、Accesses ビューでディスプレイできるすべての列を示しています。
値 | 説明 |
|---|---|
| 索引 | Unity がアクセス操作を実行した順序を表す ID 番号。 |
| ファイル名 | この操作中にアクセスされたファイルの名前ファイル パス全体を表示するには、ファイル名エントリーの上にカーソルを置きます。 |
| Type (タイプ) | 実行されたアクセス操作のタイプ。Open、Close、Seek、Read、Write のいずれかになります。 |
| アクセスサイズ | アクセス中に転送されたバイト数。アクセスは読み取りまたは書き込みでした。アクセスがファイル シークであった場合、サイズはデスティネーションのオフセットです。 |
| offset | ファイル アクセスの(開始)オフセット。 |
| 継続時間 (ミリ秒) | このアクセスの実行に要した時間 (ミリ秒)。 |
| 平均帯域幅 (MBps) | このアクセスの平均帯域幅(アクセス タイプが読み取りの場合)。 |
| ファーストフレームインデックス | このアクセスが開始されたフレームの ID |
| フレーム | このアクセスが発生したフレームの総数。 |
| Thread (スレッド) | アクセスが発生したスレッド。 |
| Timestamp (ms) | プロファイラーのキャプチャの開始に相対的な、アクセスが開始された時間。 |
コンテキストメニュー
任意のファイル アクセス マーカーを右クリックして、データを探る追加オプションを持つサブメニューを開きます。使用可能なオプションは以下の通りです。
値 | 説明 |
|---|---|
| Timeline ビューにマーカーを表示 | CPU Usage プロファイラーモジュールでこのマーカーを開きます。 |
| このマーカーの最初のフレームに移動します。 | マーカーがチャートに初めて表示されるフレームを選択します。マーカーが 1 つのフレームにのみ表示される場合は、このオプションは無効になります。 |
| このマーカーの最後のフレームに移動 | このマーカーがチャートに最後に表示されるフレームを選択します。マーカーが 1 つのフレームにのみ表示される場合は、このオプションは無効になります。 |
| このファイルパスへのビューのフィルター | 検索バーに「ファイル名」列の内容を入力して結果をフィルターする。 |