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 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 ビルドプロセスの後にパッケージ名を変更する必要がある場合は、このオプションを無効にすることができます。

Permissions

アプリケーションの権限設定です。通常はデフォルト設定を維持することをおすすめします。

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

権限 変更可能か 有効化条件 権限の説明
Camera はい カメラ権限、カメラデバイスを使用するために必要な権限
AndroidMicrophone いいえ Variant が VideoRecording の場合 マイク権限、録画機能を使用するために必要な権限
Location いいえ Mega サポートパッケージをインポートした場合 （高精度）位置情報権限、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 の Gizmo 設定です。

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

Cloud Recognition (CRS) > Service Access [Global]

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

Object Tracking

EasyAR 物体追跡機能の設定です。

Target Gizmo

エディタでの ObjectTarget の Gizmo 設定です。

  • Enable：Gizmo を有効にします。

Third-Party Libraries

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

ARCore sdkの設定

ARCore SDK 設定。

ARCoreは一部のAndroidデバイスでモーション追跡機能を提供します。EasyAR機能とモーション追跡の関係、およびARCoreの必要性と使用タイミングについては、モーション追跡とEasyAR機能を参照してください。

  • 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 Storeアプリ公開に必要なその他の設定については、Googleの説明を参照してください（中国本土、国際）。

注記

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

利用可能なARCore SDKには3つの異なるソースがあります:

  • プラグイン同梱の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機能とモーション追跡の関係、およびAR Engineの必要性と使用タイミングについては、モーション追跡とEasyAR機能を参照してください。

  • AREngineInterop: AREngineInteropが利用可能。EasyARと一緒に配布されるAR Engine SDKがアプリに含まれます。
  • External: AREngineInteropが利用可能。EasyARと一緒に配布されるAR Engine SDKは使用されません。
  • Disabled: AREngineInteropが利用不可。EasyARと一緒に配布されるAR Engine SDKは使用されません。AR Engine関連の全機能が無効化されます。

ONNX ランタイム (同梱)

同梱の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 の将来のバージョンのリリースノートをフォローしてください。