Oculus Quest へのデプロイ - MRTK2

Oculus Quest が必要です。

MRTK による Oculus Quest のサポートは、Unity の XR SDK パイプラインと Oculus Integration Unity パッケージという 2 つの異なるソースを介して提供されます。 Oculus XRSDK Data Provider によって、両方のソースが使えるようになり、Oculus Quest に MRTK をデプロイするために使用する必要があります。

Unity XR SDK パイプラインによって、Oculus Quest で Oculus Touch コントローラーとヘッド トラッキングを使用できます。 このパイプラインは、Unity 2019.3 以降で XR アプリケーションを開発するための標準です。 このパイプラインを使用するには、Unity 2019.3 以降を使用していることをご確認ください。 これは、MRTK アプリケーションを Oculus Quest にデプロイするために必要です

Oculus Integration Unity パッケージでは、Oculus Quest を使ったハンド トラッキングとコントローラー モデルの使用が可能です。

Oculus Quest 用にプロジェクトを設定する

  1. こちらの手順に従って、ご自分のプロジェクトが Oculus Quest にデプロイする準備ができていることを確認します。

  2. デバイスで開発者モードが有効になっていることを確認します。 Oculus ADB ドライバーのインストールは省略可能です。

Oculus Quest 用の XR SDK パイプラインを設定する

  1. Oculus XR プラグイン が、[Window] --> [Package Manager] の下にインストールされていることを確認します

    Oculus XR Plugin Package

  2. [編集] --> [プロジェクトの設定] --> [XR プラグインの管理] --> [プラグイン プロバイダー] に移動して、Oculus プラグイン プロバイダーがプロジェクトに含まれていることを確認します

    Oculus Plugin Provider

重要

OpenXR プラグイン を使用して、MRTK アプリケーションを Oculus Quest にデプロイできます。 ただし、コントローラーの視覚化とハンドトラッキングは、OpenXR では現在サポートされていません。

Oculus Integration パッケージによる完全なサポートが利用可能になるまで、Oculus XR プラグインを使うことをお勧めします。

Oculus Integration Unity パッケージを設定してハンドトラッキングを有効にする

  1. Unity アセット ストアから Oculus Integration をダウンロードしてインポートします。 動作するようにテストされた最新バージョンは 39.0.0 です。 Oculus API の変更により、以前のバージョンは機能しません。 Oculus 統合パッケージのすべてのバージョンは、この アーカイブから見つけることができます。

  2. [Mixed Reality Toolkit] > [ユーティリティ] > [Oculus] > [Oculus Integration Unity モジュールの統合] の順に移動します。 これにより、関連する Oculus Quest コードが機能するために必要な定義と参照で asmdef が更新されます。 また、Oculus Integration アセットによって生成される古い警告をフィルター処理する csc ファイルも更新されます。 MRTK リポジトリには、警告をエラーに変換する csc ファイルが含まれています。この変換により、MRTK-Quest の構成プロセスが停止します。

    Oculus Integration Asmdef

  3. インポートされた Oculus フォルダー (Assets/Oculus にあります) には、OculusProjectConfig というスクリプト可能なオブジェクトがあります。 その構成ファイルで、[HandTrackingSupport] を [コントローラーと手] に設定する必要があります。

    Oculus Integration Controller And Hands

シーンを設定する

  1. 新しい Unity シーンを作成するか、HandInteractionExamples のような既存のシーンを開きます。
  2. [Mixed Reality Toolkit]>[シーンに追加して構成する] の順に移動して、MRTK をシーンに追加します。

Oculus XR SDK Data Provider を使用する

  1. Oculus XR SDK Data Provider を使用するために、ご自分のプロファイルを構成します
    • 構成プロファイルを変更しない場合

    • それ以外の場合は、以下に従います。

      • 階層内の MixedRealityToolkit ゲーム オブジェクトを選択し、[コピーしてカスタマイズ] を選択して、既定の Mixed Reality プロファイルを複製します。

      Clone Profile

      • [入力] 構成プロファイルを選択します。

      Input Configuration Profile

      • 入力システム プロファイルで [複製] を選択して、変更を有効にします。

      Clone Input System Profile

      • [入力データ プロバイダー] セクションを開き、上部にある [データ プロバイダーの追加] を選択すると、新しいデータ プロバイダーがリストの最後に追加されます。 新しいデータ プロバイダーを開き、[種類][Microsoft.MixedReality.Toolkit.XRSDK.Oculus] > [OculusXRSDKDeviceManager] に設定します。

      Oculus Add XRSDK Data Provider

  1. Oculus XR SDK Data Provider を使用するために、ご自分のプロファイルを構成します
    • 構成プロファイルを変更しない場合

    • それ以外の場合は、以下に従います。

      • 階層内の MixedRealityToolkit ゲーム オブジェクトを選択し、[コピーしてカスタマイズ] を選択して、既定の Mixed Reality プロファイルを複製します。

      Clone Profile

      • [入力] 構成プロファイルを選択します。

      Input Configuration Profile

      • 入力システム プロファイルで [複製] を選択して、変更を有効にします。

      Clone Input System Profile

      • [入力データ プロバイダー] セクションを開き、上部にある [データ プロバイダーの追加] を選択すると、新しいデータ プロバイダーがリストの最後に追加されます。 新しいデータ プロバイダーを開き、[種類][Microsoft.MixedReality.Toolkit.XRSDK.Oculus] > [OculusXRSDKDeviceManager] に設定します。

      Oculus Add XRSDK Data Provider

  1. Oculus XR SDK Data Provider には、OVR Camera Rig Prefab が含まれており、OVR Camera Rig と OVR Hands を含むようにプロジェクトが自動的に構成され、入力が適切にルーティングされます。 シーンに OVR Camera Rig を手動で追加するには、設定と入力を手動で構成する必要があります。

プロジェクトをビルドして Oculus Quest にデプロイする

  1. USB 3.0 -> USB C ケーブルを使用して Oculus Quest を接続します

  2. [ファイル] > [ビルド設定] に移動します

  3. デプロイを [Android] に変更します

  4. 該当する実行デバイスとして [Oculus Quest] が選択されていることを確認します

    Oculus Run Device

  5. [ビルドして実行] を選択します

    • [ビルドして実行] を初めて選択すると、次のような一連のビルド エラーが発生するおそれがあります。 [ビルドして実行] を再び選択すると、正常にデプロイできます。

    Oculus Expected Build Errors

  6. Quest の内部からの [USB デバッグを許可] というプロンプトを受け入れます

  7. Oculus Quest 内のシーンを確認します

プロジェクトから Oculus Integration を削除する

  1. Mixed Reality Toolkit > Oculus Separate Oculus > Integration Unity モジュールに移動しますOculus Separation Asmdef
  2. Unity によって Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef で参照として更新されるようにします。他のファイルは、この手順で変更されます
  3. Unity を閉じます
  4. Visual Studio が開いている場合は閉じます
  5. エクスプローラーを開いて、MRTK Unity プロジェクトのルートに移動します
  6. UnityProjectName/Library ディレクトリを削除します
  7. UnityProjectName/Assets/Oculus directory ディレクトリを削除します
  8. UnityProjectName/Assets/Oculus.meta ファイルを削除します
  9. 再び Unity を開きます

一般的なエラー

Unity で Quest が認識されない

Android のパスが正しく構成されていることを確認します。 引き続き問題が発生する場合は、こちらのガイドに従ってください

[編集] > [設定] > [外部ツール] > [Android]

Android Tools Config