VRChat
ku6draku6dra

UdonProfiler

VRChat のワールドに配置する、簡易的なプロファイラーです。 （上級者向け） アクティブ状態で、画面の下部にプロファイラーをオーバーレイ表示します。 ワールドの特定の方向を向いたとき、Udon の処理が実行されるとき などのシチュエーションにおいて、CPU/GPU 負荷の状況を確認しやすくなります。 ワールドのパフォーマンス最適化にご活用ください。

「ギフトとして贈る」とは

UdonProfiler
UdonProfiler
UdonProfiler
UdonProfiler
VRChat のワールドに配置する、簡易的なプロファイラーです。 （上級者向け） アクティブ状態で、画面の下部にプロファイラーをオーバーレイ表示します。 ワールドの特定の方向を向いたとき、Udon の処理が実行されるとき などのシチュエーションにおいて、CPU/GPU 負荷の状況を確認しやすくなります。 ワールドのパフォーマンス最適化にご活用ください。

注意

本プロファイラーは U# スクリプトとして制作されています。 エディター上に限らず、ワールドのビルド後も動作することができますが、 Udon の制約内で動作しているため、各種の情報には正確でない箇所（推測）が含まれることをご了承ください。

セットアップ

OverlayCamera_Depth99.prefab をワールドの原点近くかつ、ユーザーから見えない位置（例：地面の中）に配置してください。 ワールドの原点より離れていると、オーバーレイ表示が乱れる可能性があります。 オーバーレイ表示のオン/オフ機能は付属しておりません。 スイッチ等と組み合わせて、OverlayCamera_Depth99 の GameObject の有効、無効を切り替えることでご対応ください。

表示の説明

■オーバーレイ上部: ビジュアル表示 1フレームの処理の流れを視覚化します。 【一番上の横長線】 全体の処理時間です。 中央より左がGPUの待機（黄色）、中央より右がCPUの処理（白色）です。 CPU処理（白色）の途中には、GPUの待機をしていると推測される時間（黄土色）が含まれます。 GPU待機（黄色）は、デスクトップモードの場合に伸びやすくなります。 GPU待機（黄土色）は、VRモードやドライバーによるFPS制限が有効の場合に伸びやすくなります。 【縦線】 黒い縦線は10ms間隔の目盛りとなっています。 ・緑色の縦線: 前フレームの終了時間 ・赤色の縦線: 現在フレームの開始時間 赤色の縦線はTime.UnscaledTimeです。基本的に中央に位置しますが、垂直同期が有効の場合などには中央より左右（過去や未来）に移動します。 【下側の細い線】 各種処理です。 ・ピンク: FixedUpdate() ・緑色: Update() ・黄色: LateUpdate() ・水色: PostLateUpdate() ・オレンジ: Camera.Render（レンダースレッドの処理時間） オレンジの途中にある青色より左がRenderTextureへの描画時間、右が画面への描画時間です。 ・青色: ReflectionProbe（リアルタイム設定）の更新や、エディター上で再生している場合はEditorLoop（エディターの処理）が含まれます。 ■オーバーレイ下部: 数値表示 フレームレート等を表示します。 【現在のフレーム】 ・Frame: Time.frameCount（起動してからのフレーム数）の下4桁。 【フレームレート】 ・PFPS: 過去1秒間に表示されたフレームの数。 1秒に1回更新され、FPSより正確です。 （Pushed Frames Per Second の略） ・FPS: Unity上での一般的なフレームレート、Time.deltaTimeの逆数に相当。 （本プロファイラーではシェーダー上のunity_DeltaTime.wを表示しており、下限10～上限200FPSにクランプされています。） 【フレームタイム】 1フレームの処理にかかった時間をミリ秒で表示します。 CPU/GPUの負荷の傾向を確認できます。 ・Total: 合計時間。 ・CPU: CPUの処理推測時間。 ・GPU: GPUの待機推測時間。 （GPU時間には、ゲーム内、ゲーム外のフレームレート制限やVBlankの待機時間が含まれます。）

動作環境

[v1.0.0] 動作確認済み VRChat バージョン: ・2023.4.2p2 Build 1390 (2023-12-06) SDK: ・Unity 2022.3.6f1 ・VRChat SDK - Base v3.5.0 ・VRChat SDK - Worlds v3.5.0 Unity 2019.4.31f1 では動作しません。 （Time.realtimeSinceStartupAsDouble などの使用しているメソッドが存在しないため） 将来のアップデートでの動作を保証しません。

アップデート履歴

[2023-12-29: v1.0.0] リリース

ライセンス

本ソフトウェアは MIT ライセンスを用いてリリースされます。 https://github.com/ku6dra/udon-profiler/blob/master/LICENSE

リンク

GitHub: https://github.com/ku6dra/udon-profiler