Unity 互換性
この記事では、EasyAR Sense Unity Plugin が対応する Unity のバージョンと構成要件を紹介します。
Unity のバージョン
EasyAR Sense Unity Plugin は Unity 2021.3 以降をサポートします。
Mega 機能の開発に必要な EasyAR Mega サポートパッケージは Unity 2021.3.30 以降をサポートします。
ヒント
一般に EasyAR は頻繁に変わる Unity API にあまり依存していないため、Unity が新しいバージョンをリリースしても、EasyAR Sense Unity Plugin は通常そのまま使えます。
EasyAR Sense Unity Plugin はバージョン 4.6.4 から Unity 6 の URP 17+ Render Graph をサポートします。
開発プラットフォーム
| OS | OS バージョン | CPU アーキテクチャ | 補足 |
|---|---|---|---|
| Windows | 7 以降（7/8.1/10/11） | x86, x86_64 | Windows N/KN 版は Media Feature Pack のインストールが必要です |
| macOS | 11.0 以降 | x86_64, arm64 |
また、対応するバージョンの Unity 開発システム要件 を満たす必要があります。
リリースプラットフォーム
| OS | OS バージョン | CPU アーキテクチャ | 補足 |
|---|---|---|---|
| Windows | 7 以降（7/8.1/10/11） | x86, x86_64 | Windows N/KN 版は Media Feature Pack のインストールが必要です。 EasyAR 画面録画機能はサポートしません。 |
| macOS | 11.0 以降 | x86_64, arm64 | EasyAR 画面録画機能はサポートしません。 |
| Android | 5.0 以降 | armv7a, arm64-v8a | arm64-v8a のサポートには IL2CPP が必要です。 EasyAR 画面録画機能は Graphics API が OpenGLES2 または OpenGLES3 のときのみサポートされます。 |
| HarmonyOS（モバイル） | 1.0 – 4.x ネイティブサポート 5 以上は Android アプリ互換レイヤーでサポート1 |
arm64-v8a | |
| iOS | 15.0 以降 | arm64 | Architecture は ARM64 に設定する必要があり、Universal はサポートしません。 EasyAR 画面録画機能はサポートしません。 |
| visionOS | 2.0 以降 | arm64 | EasyAR 画面録画機能はサポートしません。 |
また、対応するバージョンの Unity のリリースプラットフォーム要件も満たす必要があります。
macOS の追加説明
Apple silicon
EasyAR Sense Unity Plugin はバージョン 4.6.0 から Apple silicon デバイス上でのネイティブ実行をサポートし、Unity エディタでも正常に使えます。
注記
Unity のネイティブプラグイン対応の不具合により、一部の Unity バージョンでは "Apple silicon" または "Intel 64-bit + Apple silicon" 向けにビルドしたアプリが正常に動作しない場合があります。Mac でアプリが使えず、"Fail to load EasyAR library" や "DllNotFoundException: EasyAR assembly" のようなエラーが出る場合は、新しい Unity を使うか、Unity および Unity コミュニティに相談してください。
Android の追加説明
Android の 16 KB メモリページサイズ対応
EasyAR Sense Unity Plugin はバージョン 4000 から 16 KB メモリページサイズのデバイスをサポートします。
ヒント
これは Android 15 で導入された機能です。詳細は Android ドキュメントの 16 KB ページサイズのサポート を参照してください。
Google Play の libhuawei_arengine_jni.so 警告は 16 KB デバイスでクラッシュする可能性がある
既定構成では、EasyAR Sense Unity Plugin は Android で AR Engine SDK 3.7.0.3（libhuawei_arengine_jni.so を含む）を使って Huawei AR Engine をサポートします。このライブラリは Huawei が古い Android NDK でコンパイルしているため、Google Play が警告を出す場合がありますが、実際には問題ありません。
Your app could crash on 16 KB devices
base/lib/arm64-v8a/libhuawei_arengine_jni.so
AR Engine SDK について:
- 3.7.0.3 版は Huawei が古い Android NDK でコンパイルしたもので、これが Google Play の警告の理由です。Google ドキュメントの Android NDK r27 以前でアプリをコンパイルする を参照してください。
- 3.7.0.3 版は Android 16 KB メモリページサイズのデバイスでの読み込みをサポートしており、これも Google Play がアプリ公開を禁止しない理由です。
- 4.0.0.5 版は Android 16 KB メモリページサイズのデバイスでの読み込みをサポートしません。これは Android エコシステムで公開利用可能な AR Engine SDK の最新バージョンであるため、EasyAR Sense Unity Plugin は引き続き 3.7.0.3 を使用しています。
EasyAR Sense Unity Plugin で AR Engine SDK 3.7.0.3 を使っても Google Play への公開には影響せず、実際にクラッシュすることもありません。
- Huawei デバイスは Android 16 KB デバイスではありません。
- EasyAR Sense はホワイトリスト機構を使い、Huawei 以外のデバイスで AR Engine SDK が動作しないようにしています。
この警告への対処:
Huawei デバイスで AR Engine 機能を使う必要がある場合は、この警告は無視することを推奨します。
Huawei デバイスをサポートする必要がない、または AR Engine 機能を使わなくてよい場合は、EasyAR 設定 で AR Engine SDK を無効にできます。
注記
Huawei デバイスでは、AR Engine を無効にしても他の EasyAR 機能は正常に動作しますが、モーション追跡の結果は AR Engine と異なり、モーション追跡を使う他の機能 も影響を受けます。
HarmonyOS の追加説明
Android と互換性のある Harmony システム
EasyAR Sense Unity Plugin は HarmonyOS 1.0 – 4.x を完全にサポートします。
原生 HarmonyOS / 純血 HarmonyOS / HarmonyOS NEXT
EasyAR Sense Unity Plugin は近いうちに原生 HarmonyOS 5.0+ をサポート予定です。現在のバージョンはまだサポートしておらず、Android アプリ互換レイヤー経由でのみ使えます。
ヒント
Unity 国際版は原生 HarmonyOS をサポートしないため、団結エンジン を使う必要があります。
WebGL
EasyAR Sense Unity Plugin は Unity の WebGL をサポートしません。
ヒント
EasyAR のクラウドサービスインターフェース（たとえば CRS サービスインターフェース）を直接使って開発した機能は、Web プラットフォームに公開できます。
Graphics API
EasyAR Sense Unity Plugin は Unity のレンダリングパイプラインを直接使うため、Unity で利用できるすべての Graphics API をサポートします。
Scriptable Render Pipeline
EasyAR Sense Unity Plugin は Universal Render Pipeline (URP) 7.0.0 以上をサポートします。
EasyAR Sense Unity Plugin は High Definition Render Pipeline (HDRP) をサポートしません。
注記
Unity 6 URP 17+ render graph サポートに関する声明
EasyAR は Unity 6 URP 17+ render graph をサポートしますが、Unity 自体にはまだ未解決の問題が残っています。異常が起きた場合は Unity が提供する URP 互換モード を試せます。
いくつかの問題は最新の Unity ですでに修正されているため、6.2 以上の使用を推奨します。
非互換モードでの既知の問題には次が含まれます。
[未解決] 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 リリースノートで確認できます。
Unity 6 のすべてのバージョンで、部分的な緩和策 を使えます。既定で有効です。
Unity 6.2 以降では、Universal Render Pipeline Asset の Render Scale を 0.96-1.05 以外の値に設定することで回避できます。
[Unity 6.2 で修正済み] Windows DX11 ではカメラ映像がシーン内オブジェクトの描画結果を予測不能にすることがあります。Unity 6.0 - 6.1 では、EasyAR は 回避オプション を提供しており、既定で有効です。
-
現在のバージョンは原生 HarmonyOS / 純血 HarmonyOS 5.0 をまだサポートしていません。↩