Table of Contents

Using AllSamplesLauncher to quickly experience EasyAR samples

AllSamplesLauncher は統合されたサンプルランチャーであり、EasyAR SDKのさまざまな機能を素早く理解するのに役立ちます。このランチャーを使用すると、単一のUnityプロジェクト内で公式のすべてのサンプルシーンをワンクリックで切り替えて実行でき、複数の独立したプロジェクトを手動で設定する必要がありません。

準備作業

開始する前に、以下の準備作業が完了していることを確認してください：

  1. Unity HubとUnityエディタがインストールされている
  2. 新しいUnityプロジェクトを作成している
  3. EasyAR Sense Unity Pluginをインポートし、すべてのSamplesをインポートしている

手順については、クイックスタートの説明を参照してください。

詳細な手順

  1. Samples内のすべてのシーンを開きます。
    All Sample Scenes
  2. メニューバーの File > Build Settings または Build Profiles > Scene List をクリックします。
  3. すべてのシーンを Scene List にドラッグします。
  4. AllSamplesLauncherがすべてのシーンの最初にあることを確認します。そうでない場合は、ウィンドウ内でドラッグして移動できます。
    Scene List Order
  5. メニューバーの File > Build And Run をクリックしてビルドと実行を行います。
注記

スマートフォン向けにビルドする場合、ヘッドセット関連のシーンを追加しないでください：

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Donot Load Headset

ビルド中に発生する問題

コンパイルやビルド中にいくつかのエラーが発生する可能性があります。一般的な問題は以下の通りです：

エラーメッセージ 原因 解決方法
FileNotFoundException:EasyAR Settings Asset ライセンスが入力されていない メニューバーの EasyAR > Sense > Configuration をクリックし、EasyAR Sense License にライセンスキーを入力します
Missing Prefab Asset: 'XR Interaction Setup' ヘッドセット関連ファイルが不足している ビルドシーンリストからヘッドセット関連シーンを削除します。ヘッドセット向けビルドが必要な場合は、ヘッドセットサンプルの使用の手順に従ってください

ランチャーの使用方法

実行すると、シンプルなランチャーインターフェースが表示されます。

Lanucher Homepage

インターフェース下部中央の Samples ボタンをクリックすると、すべての機能のサンプルにアクセスできます。

Lanucher Samplepage

左側には機能カテゴリ、右側には各機能のサンプルシーンリストが表示されます。異なるサンプルシーンをクリックすると、EasyARが提供するすべての機能を体験できます。

また、インターフェース下部には EasyAR Sense と EasyAR Mega のデモ動画が用意されており、EasyARが提供する機能と効果をより深く理解するのに役立ちます。

サンプル実行前の必読事項

特定のサンプルを実行する前に、以下の重要な設定を必ず完了してください。そうでない場合、サンプルは正常に動作しません：

  1. API Keyの設定

    • 一部のサンプル（特にクラウド認識、Megaクラウドローカライゼーションなど）では有効なAPI Keyが必要です。
    • メニューバーの EasyAR > Sense > Configuration で、該当サンプルに必要な項目を入力します。
    • EasyAR開発者センターから申請した App ID、API Key、API Secret を入力します。
      Key Configuration
    • 重要: API Keyをお持ちでない場合、ローカル機能のサンプル（画像トラッキングなど）は動作する可能性がありますが、クラウド機能は失敗します。EasyAR開発者センターでアプリケーションを作成しKeyを取得してください。

  2. XR/プラットフォームサポートの設定：

    • ヘッドセット関連のサンプルを実行する場合は、ヘッドセットサンプルの使用の手順に従ってください。
    • デバイス（スマートフォンやヘッドセット）が正しく接続され、開発者モードになっていることを確認してください。

サンプルの詳細な探索

サンプルランチャーは学習に最適な出発点です。以下のことを強くお勧めします：

  • まず実行し、その後調査する: ランチャーで各サンプルの効果を素早く体験し、EasyARの能力を直感的に理解します。
  • シーンソースファイルを開く: 各サンプルは独立したUnityシーンファイルであり、Assets/Samples/EasyAR Sense Unity Plugin/[バージョン番号]/__All Samples__/[機能名]/[サンプル名]/Scenes ディレクトリにあります。
  • スクリプトコードを調査・読む: サンプルシーンで、特定の機能を実現するためにEasyAR APIをどのように呼び出しているかを確認できます。これはAPIの使用方法を学ぶ最良の方法です。

サンプルランチャーを通じて、EasyAR SDKの機能を迅速に理解できます。探索をお楽しみください！