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 サポートパッケージをインポート （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 機能設定。

InertialCameraDevice 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 の Gizmos 設定。

これらのオプションをオンにすると Unity Editor で対応する gizmo が表示されます。シーン内にこの種のターゲットが多数ある場合、エディターの起動パフォーマンスに影響する可能性があります。デバイス上でのランタイムパフォーマンスには影響しません。

Cloud recognition (CRS) > Service access [Global]

グローバルクラウド認識サーバー設定。

Object tracking

EasyAR オブジェクトトラッキング機能設定。

Target gizmo

エディター下での ObjectTarget の Gizmos 設定。

  • Enable：Gizmos を有効化。

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