MRTK2 と XR SDK の概要

  • [アーティクル]

XR SDK は Unity の Unity 2019.3 以降の新しい XR パイプラインです。 Unity 2019 では、既存の XR パイプラインに代わるパイプラインが提供されています。 Unity 2020 では、Unity で唯一の XR パイプラインです。

XR SDK パイプライン用の Unity の構成

XR SDK パイプラインでは現在、3 つのプラットフォーム (Windows Mixed Reality、Oculus、OpenXR) がサポートされています。 以下のセクションでは、プラットフォームごとに XR SDK を構成するために必要な手順について説明します。

Windows Mixed Reality

Unity のパッケージ マネージャーにアクセスし、Windows XR プラグイン パッケージをインストールすることで、XR SDK での Windows Mixed Reality のサポートが追加されます。 これにより、いくつかの依存関係パッケージも取得されます。

  1. 以下のすべてが正常にインストールされていることを確認します。

    • XR プラグインの管理
    • Windows XR プラグイン
    • XR Legacy Input Helpers

  2. [Edit](編集) > [Project Settings](プロジェクト設定) に移動します。

  3. [プロジェクトの設定] ウィンドウで [XR プラグインの管理] タブをクリックします。

  4. ユニバーサル Windows プラットフォームの設定に移動し、[プラグイン プロバイダー] で [Windows Mixed Reality] がオンになっていることを確認します。

  5. [起動時に XR を初期化する] がオンになっていることを確認します。

  6. ("エディター内の HoloLens リモート処理では必須、それ以外の場合は省略可能") [スタンドアロン] の設定に移動し、[プラグイン プロバイダー] の下の [Windows Mixed Reality] がオンになっていることを確認します。 また、[起動時に XR を初期化する] もオンになっていることを確認します。

    [スタンドアロン] タブが選択された XR プラグイン管理

  7. ("省略可能") [XR プラグインの管理] の下にある [Windows Mixed Reality] タブをクリックし、カスタム設定プロファイルを作成して既定値を変更します。 設定の一覧が既に存在する場合は、プロファイルを作成する必要はありません。

    [Windows] タブが選択された XR プラグイン管理

Oculus

  1. XR SDK パイプラインを使用して、MRTK で Oculus Quest を構成する方法に関するガイドの手順に従います。 このガイドでは、Unity と MRTK の両方を構成して、Oculus Quest で XR SDK パイプラインを使用できるようにするために必要な手順が説明されています。

OpenXR

重要

Unity の OpenXR は、Unity 2020.2 以上でのみサポートされます。 また、x64、ARM、ARM64 のビルドのみをサポートします。

  1. 「MRTK を使用して新しい OpenXR プロジェクトをセットアップする」の手順に従って、OpenXR プラグインをプロジェクトに追加します。 以下が正常にインストールされていることを確認します。

    1. XR プラグインの管理
    2. OpenXR プラグイン
    3. [Mixed Reality OpenXR Plugin](Mixed Reality OpenXR プラグイン)

  2. [編集] > [プロジェクトの設定] に移動します。

  3. [プロジェクトの設定] ウィンドウで [XR プラグインの管理] タブをクリックします。

  4. [起動時に XR を初期化する] がオンになっていることを確認します。

  5. (省略可能)ターゲットHoloLens 2場合は、UWP プラットフォーム上にあることを確認し、[Microsoft HoloLens機能グループ] を選択します。

  6. (省略可能)Quest 2 をターゲットにしている場合は、Android プラットフォームを使用していることを確認し、[ハンド トラッキング] と [メタ クエスト サポート] を選択します。

    プラグイン管理 OpenXR

Note

UPM から MRTK を使用する既存のプロジェクトがある場合は、MixedRealityToolkit.Generated フォルダーにある link.xml ファイルに次の行が含まれていることを確認してください。

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

XR SDK パイプライン用の MRTK の構成

Unity の XR パイプライン全体ですべてが構成済みになっている、既定の MRTK プロファイルのいずれかを使用します。 以前の "DefaultOpenXRConfigurationProfile" および "DefaultXRSDKConfigurationProfile" には非推奨のラベルが付きました。

OpenXR を使用する場合は、アクティブなプロファイルとして [DefaultOpenXRConfigurationProfile] を選択するか、これを複製してカスタマイズします。

[XR プラグインの管理] の構成で他の XR ランタイム (Windows Mixed Reality や Oculus など) を使用している場合は、アクティブなプロファイルとして [DefaultXRSDKConfigurationProfile] を選択するか、これを複製してカスタマイズします。

これらのプロファイルは、必要に応じて適切なシステムとプロバイダーを使用して設定します。 XR SDK でのプロファイルおよびサンプルのサポートの詳細については、プロファイルに関するドキュメントを参照してください。

既存のプロファイルを XR SDK に移行するには、次のサービスおよびデータ プロバイダーを更新する必要があります。

Unity 2019 では、[XR SDK] タブに新しいデータ プロバイダーが表示されます。また、Unity 2020 以降では、レガシ XR が存在しないため、唯一のメイン ビューとして新しいデータ プロバイダーが表示されます。

[XR SDK] タブ

カメラ

次のデータ プロバイダーを追加します

XR SDK カメラの設定

入力

次のデータ プロバイダーを追加します

OpenXR プラグイン Windows XR プラグイン
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

OpenXR 入力設定

Windows Mixed Reality:

XR SDK の入力設定

限界値

次のデータ プロバイダーを追加します

OpenXR プラグイン Windows XR プラグイン
XRSDKBoundarySystem XRSDKBoundarySystem

XR SDK の境界設定

空間認識

次のデータ プロバイダーを追加します

OpenXR プラグイン Windows XR プラグイン
XRSDK.OpenXR.OpenXRSpatialAwarenessMeshObserver (UWP の場合) XRSDK.WindowsMixedReality.WindowsMixedRealitySpatialMeshObserver (UWP の場合)
XRSDK.GenericXRSDKSpatialMeshObserver (非 UWP の場合)

XR SDK の空間認識設定

コントローラー マッピング

カスタム コントローラー マッピング プロファイルを使用している場合は、そのうちの 1 つを開き、Mixed Reality Toolkit - Utilities -> Update ->> Controller Mapping Profiles メニュー項目を実行して、新しい XR SDK コントローラーの種類が定義されていることを確認します。

関連項目