使用例で始める easyar mega unity 開発
このチュートリアルでは、EasyAR Mega Unity サンプルを設定して実行し、EasyAR Mega 開発を素早く始める方法を紹介します。
開始前に
このドキュメントを読む前に、以下が完了していることを確認してください：
- 有効なクラウド位置情報ライブラリ があること。
- Unity (2021.3.30 LTS 以降) がインストールされていること。Unity 2022.3 または Unity 6.3 の最新バージョンの使用を推奨します。
- Mega を有効にする の方法に従って
com.easyar.sense-**.tgzおよびcom.easyar.mega-**.tgzパッケージをインポートしていること。
サンプルの使い方（六つのステップ）
以下では、EasyAR Mega のコアサンプル MegaBlock_Basic の設定と実行方法を6つのステップで説明します。
ステップ1: サンプルのインポート
注記
**すべてのサンプル** をインポートした場合は、このステップをスキップしてください。
- メニュー
Window>Package Managerを開き、EasyAR Sense Unity Pluginを選択します。右側の Samples で全てのサンプルを展開します。 - サンプル（例:
MegaBlock_Basic）を選択し、Import をクリックします。
注記
- このチュートリアルはヘッドマウントデバイスに直接適用できませんが、ヘッドマウントデバイス開発の前には、モバイル開発でプロセスを理解する必要があります。
- 以前に旧バージョンのSDKサンプルをインポートしたことがある場合、SDKをアップグレード後は旧サンプルを削除してから再インポートしてください。
ステップ2：ライセンスキーの入力とMegaクラウド位置特定サービスの設定
- メニューバーから
EasyAR>Sense>Configurationを選択；
- 開いた Project Settings パネルにライセンスキーを貼り付け；
ヒント
EasyAR Senseライセンスは EasyAR開発センター で作成できます。初回利用時は以下の手順で作成：
EasyAR Sense 4.x 個人版を作成- 疎空間マップは
いいえを選択 - アプリ名は任意入力、Bundle IDとPackage Nameには
com.mycompany.myprojectを入力 - 作成したライセンスを選択し、右側のコピーボタンをクリック
注記
Bundle IDとPackage Nameは後から変更可能ですが回数制限があります。明確なアプリパッケージ名がある場合は独自の名前を入力することも可能です。
個人版の作成に制限はなく、その他のタイプは正式利用時に必要に応じて作成してください。
- Megaクラウド位置特定ライブラリの情報を Project Settings パネルの
Mega Block項目に設定；
ヒント
Megaクラウド位置特定設定はEasyAR開発センターで取得可能です。
使用する API Key に Mega Block の権限があることを確認してください。ない場合は変更または再作成が必要です。
ステップ3: 3dコンテンツを配置
Hierachyパネルの空白部分を右クリックし、Block閲覧ツール（Unity開発）を追加；
Megaローカライゼーションサービスにアクセス；
EasyAR.Mega.BlockViewer (Dev)ノードを選択し、InspectorパネルでEasyARアカウント情報を入力してログイン；
- Mega Cloud Serviceの右側ボタンをクリック；
- 使用する
Megaローカライゼーションサービスを選択し、決定をクリック。
Blockのロード
サービス選択後、現在のライブラリ内のBlockリストが
MegaBlocksノード下に表示され、ツールパネルに表示されます。選択したBlockのロードをクリック：
ロード完了後、Blockは
Sceneウィンドウに表示されます。Sceneウィンドウで操作し、視点や位置を調整できます。同時にBlockファイルが使用可能か確認してください（例: Block座標系が正常か、階層化が存在するか、位置情報の配置にARリソースを見つけられないほど不明瞭・欠損していないか等）。
3dコンテンツの配置
この時、Blockを参照して3dオブジェクトを配置できます。
注記
- 3dオブジェクトは、ツールが自動生成した
MegaBlocks>Block_*ノードの下に配置する必要があります。これにより実行時に仮想コンテンツのレンダリング位置が正確になります。 Block_*ノードの名前やlocal transformは変更しないでください。これらはツールによって自動管理されます。
- 3dオブジェクトは、ツールが自動生成した
Step four: configuring megatracker
Configure Block Root;
AR Sessionを展開し、Mega Block Trackerを選択し、Block Rootをツールが生成したMegaBlocksノードに設定します。
ステップ5: Player設定の変更
Unityメニュー File > Build Settings > Player Settings の順に移動し、AndroidアイコンをクリックしてAndroidプラットフォームの設定を表示します。
Package Name をLicense Keyページに表示されているPackage Nameに変更
ヒント
例: License Key作成時にPackage Nameを
com.mycompany.myprojectと入力した場合、ここでは必ずcom.mycompany.myprojectと設定してください。そうしないと実行に失敗します。Minimum API Level を
API Level 21以上に変更
Scripting Backend を
IL2CPPに変更し、Target ArchitectureでARM64をチェック
ステップ6: ビルドと実行
- 現在のシーンを
File>Build SettingsまたはBuild Profiles>Scene Listに追加； - ターゲットプラットフォーム（例: Android / iOS）に切り替え、パッケージ名（Bundle ID）とライセンスキーが一致していることを確認；
- Build And Run をクリック；
実写の実行効果は以下の通り：
画面上の黄色い文字について
実行時に、画面上に2箇所の黄色い文字が表示されることがあります。
シミュレーション実行の警告メッセージ
画面下部に表示されます：
この警告は、デフォルト設定ではアプリがオンサイトでなくとも実行可能であることに起因します。アプリの動作にわずかな影響を与えます。オンサイトで使用する場合は、ビルド前に MegaTracker の設定を変更 できます。
診断情報
画面上部に表示され、セッションの実行状態や問題を把握するために使用されます。開発およびテスト段階では表示を維持することを推奨します：
これらの診断情報の設定・使用方法については、シーン内の診断情報 を参照して概要を把握できます。
Next steps: from getting started to mastery
おめでとうございます！上記の手順により、10分以内で EasyAR Mega のコアサンプルを実行し、空間位置認識と ARコンテンツオーバーレイの魅力を実際に体験できました。
これで基礎は習得しました。以下のようなことを目指す場合：
- より安定し、効率的な AR アプリケーションを構築する
- 複雑な現実と仮想のオクルージョンやコンテンツアライメントなどの効果を実現する
- デバイスがない場合や現場に行けない場合にデバッグを行う
開発中に直面する実際の問題を解決するのに役立つ以下の詳細ガイドを参照してください。
開発の次のステップ
完全なエンジニアリング設定について知りたい場合は、以下の内容を参照してください：
EasyAR の使用方法をさらに理解したい場合は、ここから始めてください：
同時に、開発とデバッグに役立つ以下の内容を読むことをお勧めします：
Fine control of mega functions
以下のコンテンツは、アプリケーションでMegaをより効果的に使用するのに役立ちます：
- オンプレミスおよびシミュレーションの実行
- ARSession ベストプラクティス
- トラッキングターゲットの追加
- 実世界と連動する3Dコンテンツの作成
- 環境オクルージョン (Occlusion)
- トラッキングプロセスの制御
以下のコンテンツは、現場に行かずにMegaの機能を検証するのに役立ちます：
上級トピック
以下の内容は、EasyAR の使用経験がある程度ある方向けです。
ヘッドマウントディスプレイ上で EasyAR Mega を実行したい場合は、以下を参照してください：
AR Foundation を使用したい場合は、ここから始めてください：