Table of Contents

EasyAR サンプルを XR ヘッドセットまたはメガネで使用する

EasyAR はすべてのヘッドセット向けに統一されたサンプルを提供します。サンプルにはコードが一切含まれておらず、シーン内の設定で完全に実現されています。機能自体の使用方法は、Android/iOS スマートフォン向けサンプルの実装を参照してください。

ヘッドセット向けサンプルの名称は Combination_BasedOn_* です（例：Pico 向けは Combination_BasedOn_Pico）。このサンプルは1つのシーンで EasyAR のほとんどの機能をデモし、動的にオン/オフ切り替えが可能です。個別に使用することも、同時に複数開くこともできます。

準備作業

  • お使いのヘッドセットまたはメガネが EasyAR サポートリスト に含まれていることを確認してください
  • EasyAR Unity プラグインパッケージ をダウンロードしてインポートしてください
  • EasyAR Unity XR デバイス拡張パッケージ をダウンロードしてインポートしてください
  • XR ヘッドセットまたはメガネ用の EasyAR ライセンスを取得してください。利用可能なライセンスタイプは以下の通りです：
    • EasyAR Sense 4.x XR License トライアル版（トライアル、EasyAR ウェブサイトで自己開通）
    • EasyAR Sense 4.x XR License 正式版（有償購入後使用、営業担当に連絡して購入開通）
    • EasyAR Sense 4.x XR License エンタープライズ版（エンタープライズ版 SDK 使用）
注意

ヘッドセットとメガネでは XR License のみの使用が許可されています。通常の License では EasyAR 機能は使用できません。

公式サンプルをインポートする

  1. 組み込みサポートデバイスのサンプルは EasyAR Unity プラグインパッケージ内にあり、必要なサンプルを個別にインポートします。 xr-samples-location

  2. 拡張サポートデバイスのサンプルは、対応するヘッドセット拡張と一緒に配布されます。Unity を使用してプロジェクトにサンプルをインポートできます。Pico を例にします。 xr-pico-extension

サンプルをビルドして実行する

それぞれのヘッドセット向けプロジェクト設定とサンプルの使用方法を完了します。

  • 対応するヘッドセットの公式ドキュメントと説明に厳密に従って必要な設定を行ってください。EasyAR ドキュメントではこれらの内容はカバーされません。

  • EasyAR ドキュメントの各プラットフォームの説明に従って設定を行います。

    Android: Android プロジェクト設定 を参照

    visionOS: visionOS プロジェクト設定 を参照

    XREAL は Android プラットフォーム設定に加え、追加で XREAL プロジェクト設定 が必要です

  • サンプルをビルド Unity でサンプルをビルドして使用し、デバイスにデプロイして実行します。詳細な方法は Unity でサンプルを実行する を参照してください。

使用方法

サンプルには複数のボタンが組み込まれており、その具体的な機能は以下の通りです。 xr-sample-usage-7

  • ボタン1 HUD：UI 表示モードを切り替えます。初期状態では UI は現実世界に固定表示されます。HUD をオンにすると、UI は常に目の前に表示されます。
  • ボタン2 Record：EIF 録画をオン/オフします。オンにした後は、必ずオフにしないと正常な EIF ファイルが録画されません。そうしないと録画されたファイルは使用できなくなります。
  • ボタン3 Image：画像トラッキングをオン/オフします。
  • ボタン4 Image Fusion：画像トラッキング＋モーションフュージョンモードをオン/オフします。
  • ボタン5 Dense：高密度空間マッピングをオン/オフします。
  • ボタン6 Sparse：疎空間マッピングをオン/オフします。
  • ボタン7 Mega：Mega をオン/オフします。

機能の詳細説明

  • デフォルトの機能スイッチ

    すべての機能は起動時、デフォルトでオフになっています。これはエディター上で対応するスクリプトを無効にすることで実現されています。ボタン操作は対応するスクリプトの有効化/無効化を操作します。実際に実行するサンプルに応じて、デフォルトで有効にする機能を設定できます。

    hmd-default-disable

  • 座標系原点参照

    サンプルではモーショントラッキングの座標系原点に、モーショントラッキング状態を確認するための静止したパンダモデルを配置しています。このモデルは問題の切り分けに役立ちます。例えば Mega を実行中に高速ドリフトが発生する場合、それはデバイスのモーショントラッキング（つまりデバイス自身の欠陥）によるものであることがあります。この場合、このモデルも一緒にドリフトします。必要に応じて、このパンダモデルを調整または削除できます。

  • 埋め込み画像トラッキング用ターゲット画像の使用

    • サンプルでは平面画像トラッキングで使用する画像のサイズがプリセットされています。A4 用紙に namecard.jpg を印刷して使用する必要があります。画像の比率を維持し、伸縮や切り抜きを行わず、できるだけ用紙いっぱいに印刷する必要があります（下図）。 namecard

    • 印刷した用紙上の名刺パターンの長さを測定します。測定結果に基づき、Unity シーン内の Image Target の Scale を実際の物理サイズと一致するように設定する必要があります（単位はメートル）。 set-the-actual-size

    • EasyAR モーションフュージョン がオンの場合、固定位置（移動不可）の画像のみをトラッキングできます。モーションフュージョンがオフの場合、画像が視野外に出るとトラッキングできなくなります。

    • メガネの視野角ではカメラ画像のサイズが十分に反映されないことがあり、認識できない場合はメガネカメラを画像に近づけてみてください。実際の使用時には、5m×5m サイズなど、より大きな画像のトラッキングをお勧めします。

注記

ヘッドセット上では、EasyAR モーションフュージョン機能のオン/オフにかかわらず、image target の Scale パラメータは必ず実際の物理サイズに設定する必要があります。そうしないと表示位置が誤ってなります。