Table of Contents

EasyAR Mega Unity開発のクイックスタート：サンプルの使用

このチュートリアルでは、EasyAR Mega Unityサンプルを構成して実行する方法を紹介し、EasyAR Mega開発のクイックスタートを目指します。

始める前に

この記事を読む前に、以下のことが完了していることを確認してください。

注記

このチュートリアルは、バージョン >= 4003 の Unity プラグインにのみ適用されます。もし古いバージョンをダウンロードしてしまったが、入門ドキュメントを読んでいる場合は、最新バージョンのプラグインをダウンロードする必要があります。

サンプルの使い方（六つのステップ）

以下では、EasyAR Mega のコアサンプル MegaBlock_Basic の設定と実行方法を6つのステップで説明します。

ステップ1: サンプルのインポート

注記

**すべてのサンプル** をインポートした場合は、このステップをスキップしてください。

  1. メニュー Window > Package Manager を開き、EasyAR Sense Unity Plugin を選択します。右側の Samples で全てのサンプルを展開します。
  2. サンプル（例: MegaBlock_Basic）を選択し、Import をクリックします。

サンプルのインポート

注記
  • このチュートリアルはヘッドマウントデバイスに直接適用できませんが、ヘッドマウントデバイス開発の前には、モバイル開発でプロセスを理解する必要があります。
  • 以前に旧バージョンのSDKサンプルをインポートしたことがある場合、SDKをアップグレード後は旧サンプルを削除してから再インポートしてください。

第二步：SDK とMegaクラウド位置決めサービスを設定する

  1. メニューバーから EasyAR > Sense > Configuration を選択します。
    License Guide

  2. 開いた Project Settings パネルに、あなたの License Key を貼り付けます。
    Fill License

    ヒント

    EasyAR Sense License は EasyAR 開発センター から作成できます。初めて使用する場合は、以下の手順で作成します。

    • EasyAR Sense 4.x 個人版 を作成します。
    • 疎空間マップは いいえ を選択します。
    • アプリケーション名は任意に入力し、Bundle ID と Package Name は com.mycompany.myproject を入力します。
    • 新しく作成した License を選択し、入った後に右側のコピーボタンをクリックします。

    copykey

    注記

    Bundle ID と Package Name は後で変更できますが、回数に制限があります。明確なアプリケーションパッケージ名がある場合は、自分のパッケージ名を入力することもできます。

    個人版の作成には個数制限がありません。他のタイプは本番使用時に必要に応じて作成してください。

  3. Project Settings パネルの Mega > Mega Block/Landmark support オプションを確認して開きます。

  4. あなたの Mega クラウド位置決めライブラリの各情報を Project Settings パネルの Mega Block 項目に設定します。
    Mega Config Guide

    ヒント

    Mega クラウド位置決めライブラリの設定は EasyAR 開発センターから取得できます。
    Mega Config Detail
    あなたの API Key が Mega Block と SpatialMap の権限を持っていることを確認してください。持っていない場合は、変更または再作成する必要があります。
    API Key Auth
    位置決めライブラリが見つからない場合は、まず 位置決めライブラリを正しく設定 し、再度 クラウド位置決めライブラリが有効であることを確認 してください。

第三步：Mega Blockの設定

  1. Mega Blockを設定する；

    Mega Block を選択し、BlockのIDとNameを入力します。

    ヒント

    Block IDとNameは、EasyAR開発センターの対応する定位ライブラリから取得できます。

    定位ライブラリにBlockデータがない場合は、定位ライブラリに必要なBlockを追加 し、再度 クラウド定位ライブラリが有効であることを確認 してください。

第四步：3Dコンテンツの配置

  1. Mega Block を選択してエディタツールを作成します；

  2. サービス情報を確認し、サービスに接続します；

    ヒント

    他に変更がなければ、サービス情報は Project Settings に記入したものと同じになります。

    サービスに正常に接続した後、更新時間とBlockエディタデータの制御画面が表示されるはずです。

  3. Blockエディタデータを読み込みます；

    Blockデータの下にある最初の選択ボックスをクリックすると、Blockエディタデータの読み込みプロセスが開始され、読み込み後にSceneウィンドウに現在のBlockのメッシュが表示されます：

    ヒント

    Blockメッシュはカメラの位置に応じてLODが切り替わり、インターネット接続が必要です。

  4. 3Dコンテンツを配置します

    この時点で、Blockメッシュを参考に3Dオブジェクトを配置することができます。

    注記
    • 3DオブジェクトはBlockノードの下に配置しなければならず、実行時に仮想コンテンツのレンダリング位置が正しくなるようにします。
    • 3Dオブジェクトは EasyAR.Mega.EditorTool ノードの下に配置してはなりません。このノードはエディタツール専用で、一部の場合に自動的に削除または再構築されることがあります。

第五步：Player設定の変更

UnityメニューのFile > Build Settings > Player Settingsを順に選択し、Androidアイコンをクリックして、Androidプラットフォームに対応する設定を表示します。

switchtoandroid

  • Package NameをLicense Keyページに表示されているPackage Nameに変更します。

    androidPackageName

    ヒント

    たとえば、License Keyを作成する際に入力したPackage Nameがcom.mycompany.myprojectの場合、ここにもcom.mycompany.myprojectを入力する必要があります。そうしないと、実行に失敗します。

  • Minimum API LevelをAPI Level 24以上に変更します。

    androidAPILevel

  • Scripting BackendをIL2CPPに変更し、Target ArchitectureでARM64を選択します。

    androidarm64

第六歩：ビルドと実行

  1. 現在のシーンを File > Build Settings または Build Profiles > Scene List に追加します。
  2. ターゲットプラットフォーム（例：Android / iOS）に切り替え、バンドルID（Bundle ID）とライセンスキー（License Key）が一致していることを確認します。
    Switch Platform
  3. Build And Run をクリックします。
    Build And Run

実際の撮影での実行結果は以下の通りです。

画面上の黄色い文字について

実行時に、画面上に2箇所の黄色い文字が表示されることがあります。

  1. シミュレーション実行の警告メッセージ

    画面下部に表示されます：

    この警告は、デフォルト設定ではアプリがオンサイトでなくとも実行可能であることに起因します。アプリの動作にわずかな影響を与えます。オンサイトで使用する場合は、ビルド前に MegaTracker の設定を変更 できます。

  2. 診断情報

    画面上部に表示され、セッションの実行状態や問題を把握するために使用されます。開発およびテスト段階では表示を維持することを推奨します：

    これらの診断情報の設定・使用方法については、シーン内の診断情報 を参照して概要を把握できます。

Next steps: from getting started to mastery

おめでとうございます！上記の手順により、10分以内で EasyAR Mega のコアサンプルを実行し、空間位置認識と ARコンテンツオーバーレイの魅力を実際に体験できました。

これで基礎は習得しました。以下のようなことを目指す場合：

  • より安定し、効率的な AR アプリケーションを構築する
  • 複雑な現実と仮想のオクルージョンやコンテンツアライメントなどの効果を実現する
  • デバイスがない場合や現場に行けない場合にデバッグを行う

開発中に直面する実際の問題を解決するのに役立つ以下の詳細ガイドを参照してください。

開発の次のステップ

完全なエンジニアリング設定について知りたい場合は、以下の内容を参照してください：

EasyAR の使用方法をさらに理解したい場合は、ここから始めてください：

同時に、開発とデバッグに役立つ以下の内容を読むことをお勧めします：

Fine control of mega functions

以下のコンテンツは、アプリケーションでMegaをより効果的に使用するのに役立ちます：

以下のコンテンツは、現場に行かずにMegaの機能を検証するのに役立ちます：

上級トピック

以下の内容は、EasyAR の使用経験がある程度ある方向けです。

ヘッドマウントディスプレイ上で EasyAR Mega を実行したい場合は、以下を参照してください：

AR Foundation を使用したい場合は、ここから始めてください：