EasyARプロジェクトでヘッドマウントディスプレイのサポートを有効化
このドキュメントでは、既存のEasyAR Unityシーンでヘッドマウントディスプレイのサポートを有効化する方法について説明します。
開始する前に
- EasyARのヘッドマウントディスプレイサポート を読み、EasyARがサポートするヘッドマウントディスプレイの種類と、そこで動作するEasyAR機能を理解してください。
- UnityでのEasyARヘッドマウントディスプレイサポート を読み、UnityにおけるEasyARヘッドマウントディスプレイサポートの全体的なアーキテクチャを理解してください。
この記事では、すでにEasyARを使用可能なシーンがあることを前提としています。そのようなシーンを作成する必要がある場合、またはヘッドマウントディスプレイシーンにEasyARコンポーネントを追加する場合は、以下のドキュメントを参照してください:
シーンにヘッドマウントディスプレイコンポーネントを追加
シーンにヘッドマウントディスプレイコンポーネントを追加する前に、通常、既存のカメラとXR Originを削除する必要があります。
カメラとXR Originの削除
シーン内の既存のカメラを削除します。
シーン内に XR Origin が既に存在する場合、それがEasyAR由来かUnity XRフレームワーク由来かを問わず、ほとんどの場合削除する必要があります。
ヒント
高度な使用方法では、必要に応じて削除するかどうかを判断できます。
ヘッドマウントディスプレイコンポーネントの追加
ヘッドマウントディスプレイの公式手順に従ってコンポーネントを追加します。ここではPicoヘッドマウントディスプレイを例とします。公式手順と矛盾する場合は公式手順を優先してください。
メニューを使用して XR Interaction Manager を追加します:
メニューを使用して XR Origin を追加します:
実行する前に、ヘッドマウントディスプレイSDKが含まれるシーンをどのように設定・実行すべきかについて、ヘッドマウントディスプレイの公式手順を必ず確認してください。
frame sourceの設定
ビルトインサポートデバイス
AR Session (EasyAR) を選択し右クリックし、メニュー EasyAR Sense > Head Mounted Display (Built-in) > Frame Source : [Name] (keep it only) をクリックして、[Name] のframe sourceを作成し、それを唯一のものとして保持します。
例: Apple Vision Pro用のframe sourceを設定:
操作後、セッション内のframe sourceは以下のようになります:
ヒント
セッションにデバイスに対応するframe sourceが含まれており、そのデバイスで最初に利用可能なframe sourceである場合（上記図のように、visionOSシステムではVisionOS ARKitが最初に利用可能なframe source）、変更は不要です。メニューから作成する一部のデフォルトセッションはこのケースに該当します。
拡張サポートデバイス
AR Session (EasyAR) を選択し右クリックし、メニュー EasyAR Sense > Extensions > Frame Source : [Name] (keep it only) をクリックして、[Name] のframe sourceを作成し、それを唯一のものとして保持します。
例: Picoヘッドマウントディスプレイ用のframe sourceを設定:
操作後、セッション内のframe sourceは以下のようになります:
クロスデバイスサポート
異なるデバイスでシーンを実行できるようにする必要がある場合は、他のframe sourceを保持し、デバイスで現在のframe sourceが選択可能であることを確認する必要があります。
(keep it only) を含まないメニュー項目を使用すると、frame sourceを追加するだけで他のframe sourceは削除されません。例えば、EasyAR Sense > Extensions > Frame Source : Pico は、セッションのすべてのframe sourceの最後にPico用のframe sourceを作成します。一般的に、この方法でframe sourceを追加した後は、適切な位置に移動させる必要があります。
ヒント
高度な使用方法では、必要に応じてframe sourceの位置を調整したり、コードで変更したりできます。