Table of Contents

EasyAR プロジェクトで AR Foundation を有効化する

AR Foundation の EasyAR サポートを有効にする必要がある場合、または AR Foundation の他の機能を使用する場合、AR Foundation を正しくインストールおよび設定する必要があります。以下の内容は、これらの操作を完了する方法を説明します。

始める前に

AR Foundation バージョン互換性

EasyAR は AR Foundation 5 以降をサポートします。

重要

AR Foundation のサポートは、カスタムカメラを通じて実現されます。

カスタムカメラやヘッドマウントディスプレイ上で試供品（個人版ライセンス、試供版XRライセンス、試供版Megaサービスなど）を使用する場合、EasyAR Senseは起動毎に100秒後（MegaユーザーはEasyARビジネスを通じて承認後、時間長を調整可能）に応答を停止します。有償版のEasyAR Senseおよび有償のEasyAR Megaサービスを使用する場合、この制限はありません。

AR Foundation のインストール

AR Foundation のインストールについては、AR Foundation 公式ドキュメント を参照することをお勧めします。読む前に、対応するドキュメントのバージョンを選択してください。

Unity 2022 以降

プロジェクトに XR 関連プラグインがインストールされていない場合、Project Settings > XR Plug-in Management で、Install XR Plugin Management ボタンをクリックして XR Plug-in Management をインストールし、インストールが完了するまで待ちます。

代替テキスト

Android プラットフォームで AR Foundation を使用する必要がある場合、Android タブで Google ARCore にチェックを入れ、インストールが完了するまで待ちます。

代替テキスト

iOS プラットフォームで AR Foundation を使用する必要がある場合、iOS タブで Apple ARKit にチェックを入れ、インストールが完了するまで待ちます。

代替テキスト

visionOS プラットフォームで AR Foundation を使用する必要がある場合、Vision Pro プロジェクト設定 を読む必要があります。

ヒント

AR Foundation がデフォルトのタイミングで初期化されることを保証するために、Initialize XR On Startup がチェックされた状態を維持することをお勧めします。

インストールが完了したら、Package Manager ウィンドウを開き、AR Foundation および対応するプラットフォームのプラグインがインストール済みパッケージのリストに表示されていることを確認します。これらのパッケージのバージョン番号は完全に一致している必要があります。

代替テキスト

重要

AR Foundation のインストールおよび更新時には、Google ARCore XR Plugin と Apple ARKit XR Plugin のバージョンが AR Foundation のバージョンと完全に一致していることを確認する必要があります。バージョンの不一致は、実行時エラーや機能異常を引き起こす可能性があります。

Unity 2021

Unity 2021 バージョンでは、バージョンを指定するために Packages/manifest.json ファイルを手動で編集する必要があります。公式ドキュメント を参照してください。

例えば、AR Foundation バージョン 5.2.0 をインストールし、Android および iOS プラットフォームで使用する必要がある場合、Packages/manifest.json ファイルに以下の内容が含まれていることを確認します:

{
  "dependencies": {
    ...
    "com.unity.xr.arcore": "5.2.0",
    "com.unity.xr.arfoundation": "5.2.0",
    "com.unity.xr.arkit": "5.2.0",
    ...
  }
}

XR Plug-in の設定

EasyAR を使用する場合、通常 ARCore の存在は必須ではありません。したがって、ARCore をオプションとして設定し、ARCore をサポートしていないデバイスでアプリケーションが正常に動作しないことを避ける必要があります。

Project Settings > XR Plug-in Management > ARCore で、Requirement と Depth の両方を Optional に設定します。

代替テキスト

注意

Requirement を Required に設定し、ARCore をサポートしていないデバイスにビルドされたアプリケーションをインストールすると、デバイスは誤って ARCore が利用可能であると報告し、ARCore で実行します。これは、これらのデバイスが ARCore を実行しているように見え（黒い画面やその他の異常）、正常に動作していないという誤った印象を与えます。

この現象が発生する理由は、Google Play ストアが ARCore を必須としてマークされたアプリケーションのサポート対象外デバイスへのインストールをブロックするため、これらのアプリケーションは常にサポート対象デバイス上で実行されていると仮定するからです。

正しく設定された場合、これらのデバイスはセッションの組み立て時に ARCore がサポートされていないと判断し、EasyAR の機能を使用します。

必要に応じて、ARCore と ARKit をさらに設定するために以下の公式ドキュメントを参照することもできます。読む前に、対応するドキュメントのバージョンを選択してください。

Universal Render Pipeline の設定

現在のプロジェクトで URP を使用している場合、URP アセットを設定する必要があります。正しく設定されていないと、AR Foundation のカメラ背景画像が正しくレンダリングされない可能性があります。

まず、EasyAR の URP Renderer Feature が正しく設定されていることを確認します。EasyAR の Universal Render Pipeline 設定 を参照してください。

次に、Renderer Features リストに ARBackgroundRendererFeature を追加します。

代替テキスト

EasyAR の URP Renderer Feature 設定と同様に、Project Settings > Quality での異なるプラットフォームの設定に注意を払い、AR Foundation を使用する必要のあるすべてのプラットフォームで、ARBackgroundRendererFeature が正しく設定された URP アセットが使用されていることを確認する必要があります。

また、AR Foundation 公式の URP 設定ドキュメント を参照して設定することもできます（読む前に、対応するドキュメントのバージョンを選択してください）。

注記

EasyAR の Universal Render Pipeline 設定 は引き続き必要です。これにより、AR Foundation をサポートしていないデバイスで EasyAR インターフェースに関連する機能のレンダリングが正常に行われることが保証されます。

EasyAR AR Foundation サポートの有効化

Project Settings > EasyAR > Sense で、Unity XR > AR Foundation Support オプションが有効になっていることを確認します。このオプションはデフォルトで有効になっています。

代替テキスト

このオプションを変更するとスクリプトの再コンパイルがトリガーされ、変更が有効になるまでスクリプトのコンパイルが完了するのを待つ必要があります。何らかの理由で Unity が正常にコンパイルをトリガーしない場合は、Unity を閉じ、Library/ScriptAssemblies フォルダを削除して Unity にスクリプトを強制的に再コンパイルさせることができます。

ヒント

EasyAR がプロジェクト内の AR Foundation と互換性がなく、EasyAR と AR Foundation を同時に使用する必要がない場合は、このオプションをオフにすることができます。

次のステップ

関連トピック