開発

Oculusデバッグツール

更新日時: 2026/09/28
LINK PC-VR DOCUMENTATION
このトピックでは、PC SDKを利用した開発について説明します。Meta Questアプリのパフォーマンスの最適化については、使用する開発プラットフォームに応じて、次のトピックのいずれかをご覧ください。
Oculusデバッグツール(ODT)を使用すると、ゲームまたはゲーム体験内でパフォーマンスやデバッグに関する情報を表示できます。また、VR体験のミラーリングされた平面画面ビューの視野(FOV)サイズなど、関連するパラメーターを調整したり、設定したりすることもできます(これにより、さらに快適な表示形式でVR体験をオーディエンスにストリーミングできます)。

ODTの起動

Oculusデバッグツールには管理者権限が必要です。そのアクセス権を持つアカウントでサインインし、Meta Horizonのインストールから実行可能ファイルを実行します。
Program Files\Meta Horizon\Support\oculus-diagnostics\OculusDebugTool.exe
この場所からOculusデバッグツールを実行します。そうすれば、ツールのバージョンがMeta Horizonディストリビューションと一致します。他の場所に配置されたコピーは、アップデート後に動作が停止することがあります。
次のスクリーンショットは、第1レベルのリスト見出しがすべて展開された状態のメインウィンドウを示しています。
Oculus Debug Tool main window with all settings categories expanded.
ODTのユーザーインターフェイスについては、以下のセクションで説明します。

File (ファイル)メニュー

Oculus Debug Tool File menu.
  • [Launch App... (アプリの起動...)]: VRアプリの実行可能ファイルとそのコマンドライン引数を選択し、起動するためのダイアログを開きます。
  • [Validate App... (アプリの検証...)]: 検証テストのリストが表示された同じダイアログが開きます。これはアプリを起動し、選択されたテストの結果を別の検証ウィンドウに表示します。
  • Restart as administrator (管理者として再起動): 管理者のアクセス許可でOculusデバッグツールを再起動します。このエントリーは、Windowsがユーザーアカウントコントロールアイコンを提供している場合にのみ表示されます。
  • Exit (終了): Oculusデバッグツールを終了します。

ツールメニュー

Oculus Debug Tool Tools menu with Performance Profiler, Lost Frame Capture, Scene View, and Mirror.
  • Performance Profiler (パフォーマンスプロファイラー): パフォーマンスプロファイラーを起動します。詳しくは、Performance Profilerをご覧ください。
  • Lost Frame Capture (ロストフレームキャプチャ): ロストフレームキャプチャツールを起動します。詳しくは、Lost Frame Capture Tool (ロストフレームキャプチャツール)をご覧ください。
  • Scene View (シーンビュー): HMDおよびコントローラーの位置を視覚化します。
  • Mirror (ミラーリング): HMDにレンダリングされているコンテンツをPCのモニターに表示します。詳しくは、コンポジターミラーをご覧ください。

サービスメニュー

Oculus Debug Tool Service menu with options to restart, start, or stop the Oculus service.
  • Restart Oculus Service (Oculusサービスの再開): ローカルコンピューターでOculusサービスを再開します。
  • Start Oculus Service (Oculusサービスの開始): ローカルコンピューターでOculusサービスを開始します。
  • Stop Oculus Service (Oculusサービスの停止): ローカルコンピューターでOculusサービスを停止します。
  • Toggle console window visibility (コンソールウィンドウの表示/非表示の切り替え): コンソールアウトプットウィンドウの表示をオンまたはオフにします。コンソールウィンドウには、ODTを使用しているときに背後で実行されているすべてのスクリプトおよびアプリの詳細が表示されます。ほとんどのユーザーは、このオプションを有効にする必要はありません。
  • Logs (ログ): ODTの使用時に背後で実行されているすべてのスクリプトおよびアプリの詳細をトラッキングするログウィンドウを開きます。ほとんどのユーザーは、このオプションを有効にする必要はありません。

ヘルプメニュー

  • 概要: Oculusデバッグツールのバージョンと著作権通知が表示されます。
  • Show Version Info (バージョン情報を表示): OculusデバッグツールのバージョンとOVR SDKランタイムのバージョンを表示します。ヘッドセットが接続されている場合は、ヘッドセットのモデル、シリアル番号、ファームウェアバージョンに加えて、各センサーのシリアル番号とファームウェアバージョンも表示されます。

ODTの使用

  1. 非同期スペースワープ(ASW)をオフに設定して、ASWなしでのアプリのパフォーマンスを判断できるようにします。[Service (サービス)]カテゴリで、(PC) Asynchronous SpacewarpをDisabledに設定します。コントロールはDisabled、Force 45fps, ASW disabled、Force 45fps, ASW enabled、Autoの4つの値を提供します。
    Oculus Debug Tool with the Asynchronous Spacewarp setting set to Disabled.
  2. [HUDs (ヘッドセットの表示)]カテゴリで、ヘッドセットに表示するデバッグオーバーレイに[Visible HUD (表示するHUD)]を設定します。値はNone、Performance、Stereo Debug、Layerです。
  3. [Visible HUD (可視HUD)]がPerformanceになっている場合は、[Performance HUD (パフォーマンスHUD)]を展開して[Mode (モード)]を設定します。値はPerformance Summary、Latency Timing、App Render Timing、Compositor Render Timing、Async-SpaceWarp Stats、Oculus Link、Oculus Link Detail、Network Guardian Infoです。詳しくは、パフォーマンスヘッドアップディスプレイをご覧ください。HUDを使用すると、開発者またはユーザーは、SDKでビルドされたアプリのパフォーマンス情報を確認できます。バージョン詳細はHUDモードではありません。代わりに、ヘルプメニューの[Show Version Info (バージョン情報を表示)]を使用してください。次のスクリーンショットに、パフォーマンスHUDの例を示します。
    Performance HUD overlay showing frame rate and latency timing graphs in VR.
  4. [Visible HUD (可視HUD)]がStereo Debugの場合は、ステレオデバッグHUDのオプションからモード、サイズ、位置、および色を構成します。次のスクリーンショットは、ステレオデバッグHUDの例を示しています。
    Stereo Debug HUD overlay showing stereo rendering debug information in VR.
  5. [Visible HUD (可視HUD)]がLayerの場合、情報を表示するレイヤーを選択するか、[Show All (すべて表示)]チェックボックスを選択します。次のスクリーンショットに、レイヤーHUDの例を示します。
    Layer HUD overlay showing layer information for a VR scene.
  6. [File (ファイル)]メニューから[Launch App (アプリの起動)]を選択し、アプリの実行可能ファイルを選択します。
  7. ヘッドセットを装着し、結果を確認します。

サービス設定リファレンス

サービスカテゴリには、Oculusランタイムがフレームをレンダリング、合成、ストリーミングする方法を制御する設定があります。以下の表に、設定項目とそれぞれに指定できる値を示します。
設定値説明
Pixels Per Display Pixel Override
小数値、0以上
表示ピクセルあたりのピクセル数をオーバーライドして、アプリが表示より高い解像度または低い解像度でレンダリングされるようにします。
すべてのレイヤーでミップマップの生成を強制する
Off, On
合成されるレイヤーごとにミップマップ生成をオンにします。
全レイヤーでMipmapバイアスをオフセットする
小数値、-20.0~20.0
合成されるレイヤーごとに、ミップマップバイアスをオフセットします。
FOV-Tangent Multiplier
小数点2桁、Horizontal;Verticalと入力
デフォルトのレンダリング視野をオーバーライドします。この設定については、ゲームプレイのストリーミングでのより広いFOVのセクションで詳しく説明しています。
FOVステンシルの使用
Off, Auto
ランタイムが視野ステンシルを適用するかどうかを制御します。
近接センサーチェックの回避
Off, On
ヘッドセットを装着していない状態でも、ディスプレイをオンのままにします。
Adaptive GPU Performance Scale
Off, Default
アプリでサポートされているアダプティブ解像度スケーリングオプションを無効にします。GPUにヘッドルームがある場合にはよりよい視覚的忠実度を実現するために使用し、フレームロスを検出するために使用します。
(PC)非同期スペースワープ
Disabled, Force 45fps, ASW disabled, Force 45fps, ASW enabled, Auto
PC非同期スペースワープモードを設定します。
フレームドロップインジケーター
Disabled, Enabled
フレームドロップHUDのオンとオフを切り替えます。
デバッグHMDタイプ
Disabled, CV1
選択したタイプのヘッドセットをシミュレートします。Disabled以外の値を指定すると、デバッグミラーウィンドウが開きます。
ポーズインジェクション
Disabled, Enabled
ポーズのインジェクションをオンまたはオフにします。
Oculus Linkグループは、[Service (サービス)]カテゴリ内にあります。このグループのいずれかの設定を変更した場合、OVRServerを再起動すると変更内容が有効になります。
設定値説明
Distortion Curvature (歪みの曲率)
Default, Low, High
歪みの曲率をオーバーライドします。曲率を高くすると中心部のピクセル密度が高くなります。
動画コーデック
Default, H.264, H.265
動画コーデックを設定します。
スライスエンコーディング
Default, On, Off
スライスエンコーディングのオンとオフを切り替えます。
エンコードする解像度の幅
整数、0~15360
フレームのエンコード解像度の幅をピクセルでオーバーライドし、アスペクト比を保持します。
ダイナミックビットレートをエンコードする
Default, Disabled, Enabled
エンコーダーがビットレートをターゲットの制限内で調整できるようにします。
Dynamic Bitrate Max (動的なビットレートの最大値)
整数
最大ダイナミックビットレートをオーバーライドします。
Encode Bitrate (Mbps) (エンコードビットレート(Mbps))
整数、1~2000
エンコーディングビットレートをMbpsでオーバーライドします。値を高くすると、動作が不安定になる場合があります。
Dynamic Bitrate Offset (Mbps) (ダイナミックビットレートオフセット(Mbps))
整数
動的ビットレートに固定オフセットを加えます。これは、動的ビットレートが控え目になり過ぎている場合に役立ちます。オフセットが大きいほど、基本的な視覚品質が向上し、遅延や停滞が目立つようになります。そのため、ソフトウェアのアップデート後にこの設定を確認してください。この設定は最大ビットレート設定をオーバーライドします。
Linkの鮮明度
Disabled, Normal, Quality
Linkのシャープネスレベルを設定するか、シャープネスをオフにします。
ローカルディミング
Disabled, Enabled
ヘッドセットのローカルディミングのオンとオフを切り替えます。

ゲームプレイのストリーミングの際のFOVの拡大

Oculusデバッグツールには、[FOV-Tangent Multiplier (FOV-正接乗数)]という設定が用意されています(下のスクリーンショットをご覧ください)。この設定を使用して、ゲームプレイをオーディエンスにストリーミングする際の視聴エクスペリエンスを向上させることができます。この機能では、ヘッドセット内に表示されている視野(FOV)に対して、ミラーリングされた平面画面に表示されたときのFOVのサイズを拡大することができます。ヘッドセット内で使用されているFOVは平面画面では極度に収縮して表示されるため、見ているオーディエンスの一部が酔うことがありますが、この機能を使用すると、ストリーミングされたゲームプレイや録画されたゲームプレイをより快適に見ることができます。[FOV-Tangent Multiplier (FOV-正接乗数)]機能には、[Horizontal (水平)]と[Vertical (垂直)]の2つの設定があります。これらの値をFOVの目的の乗数に設定します。例えば、[Horizontal (水平)]を1.2、[Vertical (垂直)]を1.1に設定すると、ヘッドセット内のFOVと比べて、ストリーミングされたFOVは水平方向に20%大きく、垂直方向に10%大きくなります。ODTには、[Horizontal (水平)]設定、セミコロン、[Vertical (垂直)]設定という形式で表示されます。よって前述の例では、[FOV-Tangent Multiplier (FOV-正接乗数)]の行に「1.2;1.1」と入力されます。
Oculus Debug Tool with FOV-Tangent Multiplier setting highlighted for streaming configuration.