hz-xr-simulator-setup

Meta XR Simulator のセットアップ

このスキルを使用する場面

• 物理ヘッドセットを接続せずに、Quest の VR または MR アプリケーションをテストする必要がある場合
• 毎回デバイスにデプロイせずに、開発中の反復作業を迅速化したい場合
• Quest アプリの自動テストが必要な CI/CD パイプラインをセットアップする場合
• ハードウェアにデプロイする前に、コアとなるインタラクション、UI、ロコモーションを検証したい場合

Meta XR Simulator とは

Meta XR Simulator は、開発マシン上で Meta Quest 環境をシミュレートするデスクトップツールです。アプリケーションが実行する OpenXR ランタイム呼び出しをインターセプトし、ヘッドセットのトラッキング、コントローラー入力、ハンドトラッキング、環境データをシミュレートすることで、エンジンのエディター内またはスタンドアロンのデスクトップビルドとして VR/MR アプリケーションを直接実行してテストできます。

シミュレーターは Quest ハードウェアのパフォーマンスを再現するものではありません。デスクトップの GPU と CPU で動作します。目的は機能テストであり、パフォーマンスのプロファイリングではありません。

対応プラットフォーム

プラットフォーム	サポートレベル
Windows 10/11（64-bit）	完全サポート
macOS	限定的なサポート

対応エンジン

• Unity（Meta XR SDK（com.meta.xr.sdk.core および関連パッケージ）経由）
• Unreal Engine（Meta XR Plugin（旧 Oculus VR Plugin）経由）

主な機能

• ヘッドセットのトラッキングをシミュレート：マウスとキーボードで頭の位置と回転を操作します。ヘッドセットを装着せずに、仮想シーン内を移動できます。
• コントローラー入力をシミュレート：キーボードのキーを Quest Touch コントローラーのボタン、サムスティック、トリガーに割り当てます。物理コントローラーを持っているかのようにインタラクションをテストできます。
• ハンドトラッキングをシミュレート：あらかじめ定義された手のポーズやジェスチャーのシーケンスを実行します。実際のハンドトラッキングなしで、ピンチ、グラブ、ポーク、カスタムジェスチャーをテストできます。
• ルーム設定とガーディアンのシミュレーション：設定可能な部屋の寸法、家具の配置、ガーディアンの境界を使って、仮想のプレイスペースを定義します。境界を考慮した動作をテストできます。
• パススルーのシミュレーション：複合現実アプリケーションのテスト用に、合成パススルーカメラ映像を提供します。シーン理解と平面検出のロジックを検証できます。
• スクリプト可能なテストシナリオ：入力シーケンスを自動化し、セッションを記録して再生し、回帰テストのために CI/CD と統合します。

クイックスタート

1. Meta Quest Developer Hub（MQDH）の Tools から、または Meta の開発者向けダウンロードページから XR Simulator をダウンロードします。
2. Windows ではインストーラーを実行し、macOS ではアーカイブを展開して、インストールして設定します。
3. エンジンで XR Simulator を有効にします：
   • Unity：Edit > Project Settings > XR Plug-in Management を開き、Meta XR Simulator をアクティブなランタイムとして有効にします。
   • Unreal：Project Settings > Plugins > Meta XR を開き、XR Simulator オプションを有効にします。
4. エディターで Play を押します。接続されたヘッドセットを必要とせず、アプリケーションがシミュレーターで実行されます。

詳しい手順については、インストールガイドを参照してください。

コントロールの概要

操作	入力
周囲を見回す	マウスの右ボタンを押しながらマウスを動かす
前／後／左／右に移動	W / S / A / D
上／下に移動	E / Q
コントローラーのボタンをシミュレート	割り当てられたキーボードのキー（設定を参照）
手のポーズを実行	数字キーまたは設定したショートカット

入力の割り当ての詳細については、設定ガイドを参照してください。

テストのワークフロー

シミュレーターは、次のような複数のテストパターンに対応しています。

• インタラクティブテスト：シーン内を手動で移動し、インタラクションをテストする
• 自動テスト：回帰テスト用の入力シーケンスをスクリプト化する
• CI/CD 統合：自動化されたパイプラインでヘッドレスのシミュレータービルドを実行する

詳しいワークフローについては、テストのワークフローを参照してください。

注意点

Meta XR Simulator のセットアップ時や使用時によくある落とし穴です。

• OpenXR ランタイムの競合 -- 別の OpenXR ランタイムがシステムのデフォルト（SteamVR、Windows Mixed Reality、Oculus PC app）に設定されていると、シミュレーターはアプリの OpenXR 呼び出しを横取りしません。Meta XR Simulator を、グローバルまたはエンジンごとにアクティブな OpenXR ランタイムとして設定する必要があります。Windows では、HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenXR\1\ActiveRuntime を確認すると、アクティブなランタイムを確認できます。
• Unity XR Plug-in Management に関する混乱 -- Unity で XR Plug-in Management の「Meta XR Simulator」を有効にしても、「Oculus」や「OpenXR」のローダーは自動的に無効になりません。複数のローダーが有効になっていると、Unity が誤ったローダーを選択する場合があります。シミュレーターを有効にする前に、ほかの XR ローダーをすべて無効にしてください。
• シミュレーターで動作しても、デバイスと同等とは限らない -- シミュレーターは、デスクトップ GPU とデスクトップドライバーを使ってレンダリングします。デスクトップでは問題なくコンパイルできるシェーダーでも、Quest の Adreno GPU では失敗したり、動作が異なったりすることがあります。「シミュレーターで動作する」ことを「デバイスで動作する」ことと決して同一視しないでください。
• ハンドトラッキングのポーズは連続的ではなく、あらかじめ定義されています -- シミュレーターでは、連続した指のトラッキングではなく、キーボードショートカットで呼び出す個別のハンドポーズを使用します。そのため、ピンチ距離の細かな閾値、把持の物理挙動、ジェスチャー認識の品質はテストできません。ハンドトラッキングの検証には実機を使用してください。
• パススルーは合成環境であり、カメラベースではありません -- シミュレーターは、パススルーのテスト用に合成環境を提供します。シーン理解の結果（平面、メッシュ、セマンティックラベル）は、実際のセンサーデータではなく、設定された部屋に基づきます。反射面、透明な物体、低照度環境などのエッジケースは再現されません。
• 熱やパフォーマンスのプロファイリングはできません -- シミュレーターでは、Quest の熱によるスロットリング、CPU／GPU の周波数スケーリング、メモリ負荷時の動作を再現できません。シミュレーターでのパフォーマンステストは、実機のパフォーマンス検証には意味がありません。
• ファイアウォールやウイルス対策ソフトウェアの干渉 -- 一部の企業向けウイルス対策ソフトウェアは、シミュレーターのローカル IPC をブロックします。シミュレーターへの接続後すぐに切断される場合や、XR セッションの開始に失敗する場合は、シミュレーターの実行ファイルに対するファイアウォールのルールを確認してください。
• macOS のサポートは限定的です -- macOS では、一部の機能のみ利用できます。コントローラーのシミュレーションは動作しますが、ハンドトラッキング、パススルー、ルーム設定は完全にはサポートされていません。シミュレーターのすべての機能を利用するには Windows を使用してください。

制限事項

• GPU パフォーマンスのプロファイリングはできません：デスクトップ GPU の特性は、Quest のモバイル GPU とは異なります。フレームタイミング、シェーダーのパフォーマンス、フィルレートは、デバイスの動作と一致しません。
• 実際のセンサーデータはありません：IMU、カメラ、深度センサーのデータは合成されています。トラッキングのエッジケースは再現されない場合があります。
• API の動作に違いがあります：一部のプラットフォーム API（システムキーボード、ソーシャル機能、IAP など）は、シミュレーターでモックデータまたはスタブデータを返します。
• 触覚フィードバックはありません：シミュレーターではコントローラーの触覚フィードバックを感じることはできません。
• 熱によるスロットリングはありません：Quest の熱管理動作はシミュレーションされません。
• レンダリングに違いがあります：解像度、フォービエイテッドレンダリング、ディスプレイのリフレッシュレートは Quest のハードウェアと一致しません。

提出またはリリースの前に、必ず Quest の実機で最終検証を行ってください。

参考資料

• インストールガイド -- システム要件、ダウンロード、エンジンごとのセットアップ
• 設定ガイド -- 環境、入力マッピング、機能フラグ、JSON 設定
• テストワークフロー -- テストパターン、スクリプト作成、デバッグ、CI/CD との統合