はじめに

Mixed Reality Toolkit for Unity ( 以下、MRTK ) を使った開発をしている方であれば、必ずどこから設定するのか調べるであろう Diagnostics System ( 診断システム ) について、個人的に調査した内容を備忘録として残しておきます。

Diagnostics System ってなに？

MixedReality Toolkit Profile ( プロファイル ) から設定可能なプラグイン診断機能です。プロジェクトの実行中に診断を行うシステムが用意されています。

一番身近な例で言うと、Visual Profiler ( 下図 ) が診断システムの一部の機能です。

Visual Profiler に表示されている情報について整理してみたいと思います。

項目	解説
Frame Rate ( フレームレート )	フレームレートの単位は fps ( frame per second ) です。1秒間あたりのフレーム数です。HoloLens では 60 fps が最適とされています。
Frame Time ( フレーム時間 )	1フレームを処理するためにCPUで費やした時間 ( ms : ミリ秒単位 ) 目標フレームレート : 60 fps を達成するためには、フレーム時間 16.6 ms を実現する必要があります。
Frame Graph ( フレームグラフ )	フレームレートの履歴をグラフィカルに表示します。
Memory Utilization ( メモリ利用率 )	メモリ使用率を表示します。

※ パフォーマンス診断は Unity Editor ( PC ) から実行した場合、実際のアプリケーションパフォーマンスを正確に反映しない場合があります。

Diagnostic System ( 診断システム ) はプロダクト開発サイクル全体を通して有効にし、最終バージョンのリリースをする際の直前の変更として無効化することが推奨されています。

設定方法

MixedReality Toolkit 標準プロファイルでは、各システムプロファイルの設定を変更することはできません。自分好みにプロファイルの内容を編集したい場合は、標準プロファイルを複製&編集するか、新規作成することになります。今回は、標準の HoloLens 2 用プロファイルを元に修正を加えていきたいと思います。

DefaultHoloLens2ConfigurationProfile を標準プロファイルとして選択した状態

Copy & Customize (複製&編集) ボタンをクリックし、新しいプロファイルをクローンします。
作成後のプロファイルは、以下ディレクトリ配下に保存されます (標準)

Assets/MixedRealityToolkit.Generated/CustomProfiles

MixedRealityToolkit 全体プロファイルをさきほど作成したカスタムプロファイルに切り替えることで、Diagonostics ( 診断 ) タブの編集が可能となります。

項目	内容
Enable Verbose Logging (bool)	MRTK Componet 全体の詳細ログを記録します
Enable Diagnostics System (bool)	診断システムを有効にします
Diagnostic System Type	診断システムタイプを選択します

Diagnostic Settings

Diagnostic Settings を編集するためには、さらに DiagnosticsProfile をクローンする必要があります。

項目	内容
General Settings	---
Show Diagnostics	構成された診断オプションを診断システムが表示するかどうかを示します。無効にすると、構成済みの診断オプションはすべて非表示になります。
Profiler Settings	---
Show Profiler	Visual Profiler を表示するかどうかを示します。
Frame Sample Rate	フレームレート計算のフレームを収集する時間 (秒)。範囲は 0 ~ 5 秒です。
Window Anchor	プロファイラーウィンドウを固定するビューポートの部分。既定値は Lower Center です。
Window Offset	ビジュアルプロファイラーを配置するビューポートの中心からのオフセット。オフセットは、ウィンドウアンカープロパティの方向になります。
Window Scale	プロファイラーウィンドウに適用されたサイズの乗数。たとえば、値を2に設定すると、ウィンドウのサイズが2倍になります。
Window Follow Speed	ビューポート内の可視性を維持するためにプロファイラーウィンドウを移動する速度。

Refs