XR プロバイダープラグインの選択

プロバイダープラグインは、XR デバイスとプラットフォームをサポートするために作成されたパッケージです。

Use the XR Plugin Management settings to manage which XR devices and platforms your project supports. You can also configure key settings for these XR provider plug-ins.

プロバイダープラグインとその機能については、XR プロバイダープラグインフレームワーク を参照してください。

要件

Before you can enable XR plug-ins, you must install the XR Plugin Management package. You can install the package directly from the Project Settings window:

1. Project Settings ウィンドウを開きます (メニュー: Edit > Project Settings)。

2. Select XR Plugin Management from the list of settings areas along the left side of the settings window.

   
   Before installing the XR Plugin Management package

3. If necessary, click Install XR Plugin Management.

   
   After installing the XR Plugin Management package

The XR Plugin Management settings page displays a tab for each available build target. Each tab displays the list of available XR provider plug-ins for that platform. This list contains the plug-ins officially supported by Unity or its partners as well as any third-party provider plug-ins you have installed with the Package Manager.

ヒント: Unity Hub を使用して Android や iOS などのプラットフォームモジュールをインストールすることで、他のビルドターゲットのサポートを追加できます。この手順については、Unity Hub ドキュメントの Add modules を参照してください。

プロバイダープラグインの有効化

When you enable a plugin, XR Plug-in Management installs the associated package.

プロバイダープラグインは以下の手順で有効にできます。

1. Open the Project Settings window (menu: Edit > Project Settings) and select the XR Plugin Management section.

2. ビルドのターゲットプラットフォームのタブを選択します。例えば、Android オペレーティングシステムを実行するデバイス用のプラグインを有効にする場合は、Android アイコンの表示されたタブをクリックします。

   
   Android ビルドプラットフォームで ARCore プロバイダーが有効にされた状態

3. 目的のプロバイダープラグインを有効にします。

4. プラグインを追加する場合は、上記を繰り返してください。

Note: Disabling a provider does not remove the package; to remove a provider plug-in, remove the associated package with the Package Manager.

複数のプロバイダープラグインのサポート

複数のプロバイダープラグインを有効にして、同じプロジェクトで複数の XR デバイスとプラットフォームをサポートすることができます。

ノート: 1 つのプロバイダープラグインで複数のデバイスとオペレーティングシステムをサポートできる場合もあります。例えば、OpenXR プラグインは、複数の XR デバイス、オペレーティングシステム、ビルドターゲットをサポートしています。

Unity includes all of the enabled plug-ins for the current build target when you make a build. At runtime, Unity uses the first plug-in that loads successfully. Unity attempts to load provider plug-ins in the order they are shown in the XR Plugin Management list, which is in alphabetical order by default. If you need more control over which plug-in is loaded, you can do one of the following:

• Initialize XR at startup を無効にして、ランタイムでプロバイダー選択を行うための独自のアプリケーションロジックを含めます。
• Include your own custom build script to set up the list of providers in the desired order.
• ビルド前に、必要なプロバイダーだけを手動で有効にします。

See XR loading for more information about customizing how provider plug-ins are loaded and initialized.

Some provider plug-ins, such as the Mock HMD Loader plug-in, only work in the Unity Editor and do not affect builds. Editor plug-ins are used in the Editor Play mode while the primary provider is used on the device.

プロバイダープラグインのオプションの設定

After you enable a provider plugin and Unity installs the associated package, any settings for the provider are displayed as subsections under the XR Plugin Management settings.

Oculus provider plug-in settings under XR Plugin Management

複数のビルドターゲットをサポートするプラグインの場合、設定ページ内にタブが表示され、ターゲットごとに個別の設定が行えます。

プロバイダープラグインの設定は、以下の手順で行えます。

1. Project Settings ウィンドウを開きます (メニュー: Edit > Project Settings)。
2. XR Pug-in Management の下で、プロバイダープラグインの名前を選択します。
3. (タブがある場合は) ビルドのターゲットプラットフォームのタブを選択します。例えば、Android デバイス用の設定を行うには Android アイコンの表示されたタブをクリックします。(タブは、プラグインが複数のビルドターゲットをサポートしている場合にのみ表示されます)。
4. 必要に応じて設定を行ってください。

プラグインの設定に関する情報は、各プラグインのドキュメントで確認してください。Package Manager の View documentation リンクからドキュメントにアクセスできます。

View documentation リンクで、プラグインのドキュメントにアクセスできます。

XR Plug-in Management settings

XR Plug-in Management 設定

設定	説明
ビルドターゲットタブ	現在の Unity エディターにインストールされているビルドターゲットプラットフォームごとに、タブが表示されます。Unity Hub で、他のプラットフォームのサポートモジュールを追加できます。
Initialize XR on Startup	Whether the game or application should start in XR mode immediately. If disabled, then your application logic is responsible for initializing XR at the appropriate time. For example, your app could start with a normal desktop display and then switch to XR on demand. See Automatic XR loading for more information.
Plug-in Providers	The list of known XR provider plugins. This list contains the plug-ins officially supported by Unity or its strategic partners as well as any third-party provider plug-ins you have installed with the Package Manager. When you enable a provider plug-in, Unity adds the associated package to the project if it is not already installed. Disabling a plug-in does not remove the package. (You can remove packages with the Package Manager.)