Table of Contents

Player 設定

この記事では、Unity で EasyAR Sense Unity Plugin を使用してアプリをパッケージ化するときに注意する必要がある Player 設定項目について説明します。

プラットフォーム別の設定説明

Unity でビルドするときは、以下の設定を確認する必要があります。

Unity メニューの File -> Build Settings-> Player Settings を順に開き、Android アイコンをクリックして Android プラットフォームの対応する設定を表示します。

switchtoandroid

通常、以下のオプションを設定する必要があります。

  • Package Name Android アプリの Package Name を設定します。Package Name は License Key 作成時に入力したものと必ず一致している必要があります。

    androidPackageName

  • Minimum API Level EasyAR がサポートする Minimum API level は、使用する variant によって異なります。Full variant を使用する場合は Android API Level 24 以上が必要です。他の variant を使用する場合、EasyAR Sense は Android API Level 21 以上を必要とします。

    androidAPILevel

    ヒント

    Full variant は通常、Mega Go の端末側 localization 機能および 5DoF camera 機能で使用されます。Mega cloud localization service を使用する場合も、5DoF camera サポートはデフォルトで有効になります。

    対象プラットフォームで使用する EasyAR Sense variant は、Unity メニュー Project Settings > EasyAR > SenseLib Variants オプションで確認できます。

  • Target Architecture Google ARCore を使用する必要がある場合、またはその他の理由で ARM64 サポートを含めてコンパイルする必要がある場合は、IL2CPP でコンパイルし、ARM64 サポート を選択する必要があります。ARM64 アーキテクチャのサポートが不要な場合、設定は不要です。

    androidarm64

  • 動画録画機能の特殊設定

    動画録画機能を使用する場合は、Graphics APIOpenGLES3 または OpenGLES2 に設定し、Multithreaded Rendering のチェックを外す必要があります。さらに EasyAR 設定で Lib Variants > AndroidVideoRecording に設定する必要があります。

    androidvideorecord

よくある問題

以下は Player 設定に関連するよくあるエラーと解決方法です。

  • License Key 異常のエラー

    License Key に異常がある場合、例えば Package Name が一致しない場合、アプリをパッケージ化するときに is not a valid EasyAR Sense license key or it does not match package name のようなメッセージが表示されます。この時点でパッケージ化を続行すると、生成されたアプリは正常に使用できません。ウィンドウの表示をよく確認し、問題を修正してからパッケージ化を続行してください。

  • パッケージ化時のライセンスチェックを無効にする

    特別な場合として、EasyAR の API を使用して手動で初期化し、Setttings ファイル内の License Key を使用しない場合は、Continue and don't warn me again を選択するか、EasyAR 設定の EasyAR Sense License > Verify When Build オプションを無効にできます。これにより、パッケージ化時のチェックが無効になります。

  • 非 ARM アーキテクチャの Android device サポート

    EasyAR Sense は x86 および x86-64 アーキテクチャの Android システムを直接サポートしていませんが、一般に x86 アーキテクチャの device チップは ARM プログラムと互換的に実行できます。そのため、x86 アーキテクチャの選択を外すように設定する必要があり、これにより一部の x86 device で正常に使用できます。