Table of Contents

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をサポートしています。

開発プラットフォーム

オペレーティングシステム オペレーティングシステムバージョン CPUアーキテクチャ 補足説明
Windows 7以降（7/8.1/10/11） x86、x86_64 Windows N/KNバージョンでは、Media Feature Packをインストールする必要があります。
macOS 11.0以降 x86_64、arm６4

また、対応するバージョンのUnity開発システム要件を満たす必要があります。

配布プラットフォーム

オペレーティングシステム オペレーティングシステムバージョン CPUアーキテクチャ 補足説明
Windows 7以降（7/8.1/10/11） x86、x86_64 Windows N/KNバージョンでは、Media Feature Packをインストールする必要があります。
EasyARの録画機能はサポートされていません。
macOS 11.0以降 x86_64、arm６4 EasyARの録画機能はサポートされていません。
Android 5.0以降 armv7a、arm64-v8a arm64-v8aのサポートにはIL2CPPを有効にする必要があります。
EasyARの録画機能は、Graphics APIがOpenGLES2またはOpenGLES3の場合のみサポートされます。
ホンワン（モバイル端末） 1.0 – 4.xではネイティブサポート
5以上はAndroidアプリ互換層を通じたサポート1		 arm64-v8a
iOS 15.0以降 arm64 アーキテクチャをARM6４に設定する必要があり、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でアプリが使用できない場合、"EasyARライブラリの読み込みに失敗しました" または "DllNotFoundException: EasyARアセンブリ" のようなエラーが表示される場合は、新しいバージョンの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で警告が表示される場合がありますが、実際の影響はありません。

alt text

アプリが16 KBデバイスでクラッシュする可能性があります

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のメモリページサイズを持つデバイスでの読み込みをサポートしておらず、これがAR Engine SDKがAndroid生態系で公開されている最新バージョンであるため、EasyAR Sense Unity Pluginはまだ3.7.0.3バージョンを使用しています。

EasyAR Sense Unity PluginがAR Engine SDK 3.7.0.3を使用しても、アプリをGoogle Playに公開する際の支障はありませんし、実際にクラッシュすることもありません。

  • 華為のデバイスはAndroid 16 KBのデバイスではありません。
  • EasyAR Senseは、非華為のデバイスでAR Engine SDKを実行しないようにホワイトリスト機制を使用しています。

この警告の対処方法：

  • 華為のデバイスでAR Engine機能を使用する必要がある場合は、この警告を無視することをお勧めします。
  • 華為のデバイスをサポートする必要がない場合、またはAR Engine機能を使用しなくてもよい場合は、EasyARの設定でAR Engine SDKを無効にすることができます。
注記

華為のデバイスでは、AR Engineを無効にしても、EasyARの他の機能は正常に動作しますが、モーショントラッキングの効果はAR Engineとは異なり、モーショントラッキングの他の機能も影響を受けます。

ホンワンプラットフォームの追加説明

Android互換のホンワンシステム

EasyAR Sense Unity Pluginは、ホンワン1.0 – 4.xを完全にサポートしています。

ネイティブホンワン/純粋なホンワン/HarmonyOS NEXT

EasyAR Sense Unity Pluginは、近日中にネイティブホンワン5.0+をサポートする予定で、現在のバージョンではネイティブホンワン/純粋なホンワンはサポートされておらず、Androidアプリ互換層を通じてのみ使用できます。

ヒント

Unity国際版はネイティブホンワンをサポートしていません。团结合作エンジンを使用する必要があります。

WebGL

EasyAR Sense Unity PluginはUnityのWebGLをサポートしていません。

ヒント

直接EasyARクラウドサービスインターフェイス（例えばCRSサービスインターフェイス）を使用して開発した機能は、Webプラットフォームに配布できます。

Graphics API

EasyAR Sense Unity PluginはUnityのレンダリングパイプラインを直接使用しており、Unityで使用できるすべてのグラフィックス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以上を使用することをお勧めします。

非互換モードでの既知の問題は以下の通りです。

  1. [未解決] EasyARからカメラテクスチャを取得する場合（ImageTracking_Coloring3DサンプルやARSessionワークフロー（CameraDevice）サンプルのような使用方法）、iOS/Macデバイスで視覚障害や偽像が観察されます。私たちは純粋なUnityパッケージでこの問題を再現し、Unityに報告しました：iOSでのARカメラ画像レンダリング（URP 17 render graph）のグリッチ。問題の進捗状況は、Unity Issue UUM-87787の更新とUnityの将来のバージョンのリリースログを参照して確認できます。

    Unity 6のすべてのバージョンでは、一部の軽減策を使用できます。これはデフォルトで有効になっています。

    Unity 6.2以上では、Universal Render Pipeline AssetのRender Scaleを0.96-1.05以外の値に設定することでこの問題を回避できます。

  2. [Unity 6.2で修正済み] Windows DX11上でのカメラ画面は、シーン内のオブジェクトのレンダリング結果を予測不可能にします。Unity 6.0 - 6.1バージョンでは、EasyARが[回避オプション](xref:u:easyar.EasyARSettings.Workaround.URP17RG_DX

  1. 現在のバージョンでは、ネイティブホンワン/純粋なホンワン5.0はサポートされていません。↩