Table of Contents

EasyAR 設定

EasyAR 設定ページは、Unity メニューの EasyAR > Sense > Configuration または Edit > Project Settings > EasyAR からアクセスできます。

alt text

ここには、EasyAR Sense Unity Plugin のすべてのグローバル設定が含まれています。

alt text

Initialize On Startup

起動時に EasyAR を初期化します。通常はこのオプションをオンにすることをおすすめします。

このオプションをオフにした場合、EasyAR Sense を手動で初期化する必要があります。具体的な方法は EasyAR Sense の初期化 を参照してください。

EasyAR Sense License

EasyAR Sense License に関連する設定。

License key

EasyAR Sense ライセンスキー。EasyAR の機能を使用するには、有効なライセンスを入力する必要があります。

インターフェースを介して EasyAR Sense を手動で初期化する場合にのみ、空にすることができます。

注記

ヘッドマウントディスプレイデバイス（Vision Pro、XREAL、Pico、Rokid など）で使用する場合、EasyAR XR License が必要です。

注記

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

Verify when build

Unity プロジェクトをビルドする際にライセンスキーを検証します。

このオプションが有効になっている場合、Unity プロジェクトのビルドプロセスでライセンスキーが検証されます。ライセンスがビルドプラットフォームで無効であるか、Unity プレイヤー設定で設定されたパッケージ名を含んでいない場合、ビルドプロセスは失敗します。別の場所で設定されたライセンスキーを使用する必要がある場合、または Unity ビルドプロセスの後にパッケージ名を変更する必要がある場合は、このオプションを無効にすることができます。

Lib Variants

EasyAR Sense ライブラリのバリアント設定。

EasyAR Sense は通常、複数のバリアントがあり、それぞれのバリアントの機能には差異があります。ここでは、プラグインに統合されているライブラリのバリアントの比較を示します。

Variant EasyAR Sense バリアント名 機能差異 その他の特殊性
Normal Community/Enterprise 録画および慣性航法を含まない
Full CommunityFull/EnterpriseFull 慣性航法とその他のいくつかの Mega 機能を含む ライブラリファイルのサイズが大きい
VideoRecording CommunityR 録画機能を含む（Android のみ）
ヒント

Unity で使用できないいくつかのバリアントは、ここには含まれていません。たとえば、iOS の CommunityR バリアントです。

デフォルト値：

  • EasyAR Mega サポートパッケージをインポートしていない場合：Normal
  • EasyAR Mega サポートパッケージをインポートしている場合：Full

推奨設定：

  • Full ：EasyAR Mega を使用する場合、または慣性航法機能を使用する場合
  • Normal ：最小のパッケージサイズを追求し、EasyAR Mega または慣性航法サポートを使用しない場合
  • VideoRecording ：録画機能を使用する必要がある場合（Android のみ）

Permissions

アプリの権限設定。通常はデフォルトのままにすることをおすすめします。

カメラ権限以外の権限設定は変更できず、他の機能設定によって決まります。

権限 是否可改 启用条件 权限说明
Camera 是 カメラ権限、カメラデバイスを使用するために必要な権限
AndroidMicrophone 否 Variant 为 VideoRecording マイク権限、録画機能を使用するために必要な権限
Location 否 导入 Mega 支持包 （fine）位置情報権限、EasyAR Mega を使用するために必要な権限

Unity XR

Unity XR フレームワーク（AR Foundation など）に関連する設定。

AR Foundation Support

AR Foundation のサポートのオン/オフスイッチ。オンにすることをおすすめします。

極稀なケースで、AR Foundation 4 を使用する必要がある場合や、AR Foundation の更新によりコンパイルエラーが発生する場合、このオプションをオフにすることができますが、プラグイン内のすべての AR Foundation 関連機能が同時に無効になります。

注記

このオプションを変更した後、スクリプトが自動的に再コンパイルされます。

Unity XR Auto Switch

Unity XR（AR Foundation など）のオブジェクトを自動的に切り替える機能の設定。

  • Editor ：エディタモードのオプション
    • Disable AR Session ：ARSession が存在する場合、編集時に AR Foundation の ARSession を無効にします。
  • Player ：実行モードのオプション
    • Enable ：実行時の制御を有効にします。注意：このオプションをオフにすると、エディタモードで無効にされたコンポーネントは実行時に復元されません。
    • Enable If Desktop ：Windows/Mac で有効にします。
    • Enable If Mobile AR On Startup ：切り替え機能が起動したときに、モバイル AR（ARKit/ARCore）のローダーがアクティブな場合、有効にします。通常、このオプションは XR Plug-in Management の Initialize XR on Startup が選択されている必要があります。
    • Disable If Non Mobile AR Post Startup ：切り替え機能が起動したときに、モバイル AR（ARKit/ARCore）以外のローダーが存在するが、いずれのローダーもアクティブでない場合、無効にします。通常、このオプションは XR Plug-in Management の Initialize XR on Startup が選択されていない場合に使用されます。
    • Restore AR Session When Disabled ：機能が無効になったときに、すべての無効にされた AR Foundation の ARSession を復元（有効に）します（EasyAR によって無効にされたかどうかに関係なく）。このオプションは通常、編集時に無効にされたコンポーネントを復元するために使用されます。

詳細な機能説明は Unity XR 自動切り替え を参照してください。

Mega

EasyAR Mega 機能の設定。

Mega Block/Landmark Support

Mega Block/Landmark のサポートを有効にするかどうか。

このオプションは、com.easyar.mega をインポートした後にデフォルトでオンになり、インポートしていない場合はデフォルトでオフになります。

InertialCameraDevice Support

読み取り専用オプションで、現在の設定で慣性センサー機能が使用可能かどうかを表示します。

表示される情報が必要に応じていない場合は、Lib Variants オプションを適宜変更する必要があります。

ONNX Support

読み取り専用オプションで、現在の設定で ONNX ランタイム情報を表示します。

表示される情報が必要に応じていない場合は、Lib Variants および ONNX Runtime (Bundled) オプションを適宜変更する必要があります。

Mega Block > Localization Service Access [Global]

グローバルな Mega Block 位置決めサービスの設定。

Mega Landmark > Localization Service Access [Global]

グローバルな Mega Landmark 位置決めサービスの設定。

Spatial Map

EasyAR 空間マップ機能の設定。

Service Access [Global]

グローバルな疎マップサービスの設定。

Image Tracking

EasyAR 画像追跡機能の設定。

Target Gizmo

エディタでの ImageTarget のギズモ設定。

これらのオプションをオンにすると、Unity Editor で対応するギズモが表示されます。シーン内のこの種のターゲットが多い場合、エディタの起動性能に影響する可能性があります。デバイスでの実行時の性能には影響しません。

Cloud Recognition (CRS) > Service Access [Global]

グローバルなクラウド認識サービスの設定。

Object Tracking

EasyAR 物体追跡機能の設定。

Target Gizmo

エディタでの ObjectTarget のギズモ設定。

  • Enable：ギズモを有効にします。

Third-Party Libraries

サードパーティライブラリの設定。

Arcore SDK

ARCore SDK の設定。

ARCore は一部の Android デバイスでのモーショントラッキング機能を提供します。モーショントラッキングと EasyAR の機能を読んで、EasyAR の機能とモーショントラッキングの関係、および ARCore を使用する必要性やタイミングを理解することができます。

  • AR Foundation Or Optional: EasyAR または AR Foundation とともに配布される ARCore SDK は、アプリケーションに含まれます。これは ARCore XR Plugin の設定によって決まります。一般的にはこのオプションを使用することをおすすめします。これにより、AR Foundation の状況が自動的に処理されます。
  • Optional: ARCore 機能は、ARCore をサポートし、Google Play Services for AR をインストールしているデバイスで使用できます。
  • Required: アプリケーションは、ARCore をサポートし、Google Play Services for AR をインストールしているデバイスでのみ実行できます。
  • External: AR Foundation またはその他の ARCore SDK 配布を使用する場合は、このオプションを使用できます。これにより、EasyAR とともに配布される ARCore SDK は使用されません。また、このオプションを使用して、アプリケーションでの ARCore SDK の使用を完全に除外することもできます。
注意

ARCore SDK を Required に設定するか、AR Foundation の ARCore 設定で Requirement を Required に設定し、ARCore をサポートしていないデバイスにパッケージ化されたアプリケーションをインストールすると、デバイスは誤って ARCore が使用可能であると報告し、ARCore で実行します。これは、これらのデバイスが ARCore を実行していて、正常に動作していない（画面が黒くなるなどの異常）ように見せかけますが、これは誤りです。

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

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

Optional と Required の詳細な説明、および Google Play ストアにアプリケーションを公開するために必要なその他の設定については、Google の説明（中国本土、国際）を参照してください。

注記

EasyAR Sense Unity Plugin では、ARCore のサポートに必要なライブラリファイルと設定はプラグインパッケージに含まれていますが、携帯電話で実行するには、携帯電話に Google Play Services for AR をインストールする必要があります。

3 つの異なるソースの ARCore SDK を使用できます。

  • プラグインとともに配布される ARCore SDK を使用する

    プラグインには ARCore SDK のバージョンが統合されています。詳細については、ARCore、AR Engine のバージョン互換性を参照してください。EasyAR の ARCore ラッパーを使用する場合は、AR Foundation を別途インポートする必要はありません。

  • AR Foundation の ARCore SDK を使用する

    AR Foundation の ARCore SDK を使用する場合は、Google の説明（中国本土、国際）に従って設定します。この場合、ARCore SDK オプションで AR Foundation Or Optional または External を選択する必要があります。

  • その他の ARCore SDK を使用する

    その他のサードパーティプラグインまたはプロジェクト内に ARCore SDK が配布されている場合は、これらの ARCore SDK を使用することもできます。この場合、ARCore SDK オプションで External を選択し、具体的なプラグインまたはプロジェクトの要件に従って設定します。

Warn 32-bit-only ARCore-enabled build

Google の説明によると、arm64 のデバイスで armv7 のライブラリファイルのみのプログラムを実行すると、ARCore は正常に動作しません。パッケージング時に ARM64 を選択しない場合は、警告が表示されます。

alt text

この場合は、プロジェクトの設定を変更し、IL2CPP でコンパイルし、ARM64 サポートを選択する必要があります。

alt text

注意

必要に応じて、Continue and don't warn me again を選択するか、このオプションを無効にすることができます。これにより、パッケージング時のチェックが無効になります。チェックを無効にすると、パッケージング時に警告が表示されなくなりますが、一部のデバイスで実行時に異常が発生する可能性があります。これには、クラッシュや画面が黒くなるなどが含まれます。

AR Engine SDK

AR Engine SDK の設定。

AR Engine は一部の Android デバイスでのモーショントラッキング機能を提供します。モーショントラッキングと EasyAR の機能を読んで、EasyAR の機能とモーショントラッキングの関係、および AR Engine を使用する必要性やタイミングを理解することができます。

  • AREngineInterop ：AREngineInterop が使用可能です。EasyAR とともに配布される AR Engine SDK は、アプリケーションに含まれます。
  • External ：AREngineInterop が使用可能です。EasyAR とともに配布される AR Engine SDK は使用されません。
  • Disabled ：AREngineInterop は使用できません。EasyAR とともに配布される AR Engine SDK は使用されません。AR Engine に関連するすべての機能が無効になります。

ONNX Runtime (Bundled)

バンドルされた ONNX ランタイムを使用するかどうか。Lib Variant が Full の場合にのみ有効です。

別のバージョンの ONNX を使用する場合は、ONNX 公式サイトから最新バージョンを入手し、このオプションを無効にしてください。独自にコンパイルしたバイナリ互換性のない ONNX を使用すると、未知のエラーが発生する可能性があります。

Workaround For Unity

Unity のバグや不合理な動作に対する対策。

GenerateXMLDoc

スクリプトの再読み込み時に XML ドキュメントを生成し、API ドキュメントの IntelliSense が機能するようにします。

URP17RG_DX11_RuinedScene

URP 17 Render Graph DX11 シーン レンダリングが破損する問題の回避策。このオプションは Unity 6.2 以降でオフになっています。

URP17RG_IOS_Glitches_Partial

部分的な回避 Unity Issue UUM-87787。

問題の概要: EasyAR からカメラテクスチャを取得する場合（ImageTracking_Coloring3D サンプルや ARSession ワークフロー（CameraDevice） サンプルでの使用と同様）、iOS/Mac デバイスで視覚的な故障やアーティファクトが観察されます。私たちは純粋な Unity パッケージでこの問題を再現し、Unity に報告しました: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph) 。問題の進捗は、Unity Issue UUM-87787 の更新と Unity の将来のバージョンのリリースノートをフォローしてください。