Table of Contents

Unity-Kompatibilität

In diesem Artikel werden die kompatiblen Unity-Versionen und die Konfigurationsanforderungen des EasyAR Sense Unity Plugins beschrieben.

Unity-Version

Das EasyAR Sense Unity Plugin unterstützt Unity 2021.3 oder höhere Versionen.

Das für die Entwicklung von Mega-Funktionen erforderliche EasyAR Mega Support-Paket unterstützt Unity 2021.3.30 oder höhere Versionen.

Tipp

Im Allgemeinen hängt EasyAR nicht von vielen sich ändernden Unity-APIs ab. Wenn also eine neue Unity-Version veröffentlicht wird, kann das EasyAR Sense Unity Plugin in der Regel normal verwendet werden.

Ab Version 4.6.4 unterstützt das EasyAR Sense Unity Plugin das URP 17+ Render Graph von Unity 6.

Entwicklungsplattform

Betriebssystem Betriebssystemversion CPU-Architektur Zusätzliche Informationen
Windows Version 7 und höher (7/8.1/10/11) x86, x86_64 Die Windows N/KN-Versionen müssen das Media Feature Pack installieren, um verwendet werden zu können.
macOS Version 11.0 und höher x86_64, arm64

Darüber hinaus müssen die Systemanforderungen für die Unity-Entwicklung der entsprechenden Version erfüllt werden.

Veröffentlichungsplattform

Betriebssystem Betriebssystemversion CPU-Architektur Zusätzliche Informationen
Windows Version 7 und höher (7/8.1/10/11) x86, x86_64 Die Windows N/KN-Versionen müssen das Media Feature Pack installieren, um verwendet werden zu können.
Die EasyAR-Screenaufnahmefunktion wird nicht unterstützt.
macOS Version 11.0 und höher x86_64, arm64 Die EasyAR-Screenaufnahmefunktion wird nicht unterstützt.
Android Version 5.0 und höher armv7a, arm64-v8a Die Unterstützung für arm64-v8a erfordert die Aktivierung von IL2CPP.
Die EasyAR-Screenaufnahmefunktion kann nur verwendet werden, wenn die Graphics API OpenGLES2 oder OpenGLES3 ist.
HarmonyOS (Mobilgeräte) Native Unterstützung von 1.0 – 4.x
Ab Version 5 über die Android-Anwendungs-Kompatibilitätsebene unterstützt1		 arm64-v8a
iOS Version 15.0 und höher arm64 Die Architektur muss auf ARM64 konfiguriert werden. Die Konfiguration als Universal wird nicht unterstützt.
Die EasyAR-Screenaufnahmefunktion wird nicht unterstützt.
visionOS Version 2.0 und höher arm64 Die EasyAR-Screenaufnahmefunktion wird nicht unterstützt.

Darüber hinaus müssen die Veröffentlichungsplattformanforderungen von Unity für die entsprechende Version erfüllt werden:

Zusätzliche Informationen zur macOS-Plattform

Apple silicon

Ab Version 4.6.0 unterstützt das EasyAR Sense Unity Plugin die native Ausführung auf Apple silicon-Geräten und kann auch im Unity-Editor normal verwendet werden.

Anmerkung

Aufgrund eines Bugs in der Unterstützung von nativen Plug-ins durch Unity kann in einigen Unity-Versionen die für "Apple silicon" oder "Intel 64-bit + Apple silicon" erstellte App möglicherweise nicht ordnungsgemäß funktionieren. Wenn Sie feststellen, dass die App auf einem Mac nicht funktioniert und Fehler wie "Fail to load EasyAR library" oder "DllNotFoundException: EasyAR assembly" angezeigt werden, wird empfohlen, eine neuere Version von Unity zu verwenden oder an die Unity-Support und die Unity-Community zu wenden.

Zusätzliche Informationen zur Android-Plattform

Unterstützung für Android-Geräte mit 16 KB Arbeitsspeicher-Seitengröße

Ab Version 4000 unterstützt das EasyAR Sense Unity Plugin Geräte mit einer Arbeitsspeicher-Seitengröße von 16 KB.

Tipp

Dies ist eine Funktion, die in Android 15 eingeführt wurde. Weitere Informationen zu dieser Funktion finden Sie in der Android-Dokumentation unter Unterstützung für 16-KB-Seitengrößen.

Google Play-Warnung: libhuawei_arengine_jni.so kann dazu führen, dass die App auf 16-KB-Geräten abstürzt

Bei der Standardkonfiguration verwendet das EasyAR Sense Unity Plugin auf der Android-Plattform das AR Engine SDK 3.7.0.3 (einschließlich libhuawei_arengine_jni.so), um die Huawei AR Engine zu unterstützen. Da diese Bibliothek von Huawei mit einer früheren Version des Android NDK kompiliert wurde, kann Google Play eine Warnung ausgeben, dies hat jedoch keine tatsächlichen Auswirkungen.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Informationen zum AR Engine SDK:

  • Die Version 3.7.0.3 wurde von Huawei mit einer früheren Version des Android NDK kompiliert, was der Grund für die Google Play-Warnung ist. Weitere Informationen finden Sie in der Google-Dokumentation unter Kompilieren von Apps mit Android NDK r27 und niedrigeren Versionen.
  • Die Version 3.7.0.3 unterstützt das Laden auf Android-Geräten mit einer Arbeitsspeicher-Seitengröße von 16 KB, was der Grund ist, warum Google Play die App-Veröffentlichung nicht verbietet.
  • Die Version 4.0.0.5 unterstützt das Laden auf Android-Geräten mit einer Arbeitsspeicher-Seitengröße von 16 KB nicht. Dies ist die neueste öffentlich verfügbare Version des AR Engine SDK in der Android-Ökosystem, daher verwendet das EasyAR Sense Unity Plugin weiterhin die Version 3.7.0.3.

Die Verwendung des AR Engine SDK 3.7.0.3 durch das EasyAR Sense Unity Plugin beeinträchtigt die Veröffentlichung der App in Google Play nicht und führt auch nicht tatsächlich zu Abstürzen:

  • Huawei-Geräte gehören nicht zu den Android-Geräten mit 16 KB.
  • EasyAR Sense verwendet ein Whitelist-System, um die Ausführung des AR Engine SDK auf Nicht-Huawei-Geräten zu vermeiden.

So behandeln Sie diese Warnung:

  • Wenn Sie die AR Engine-Funktionen auf Huawei-Geräten verwenden müssen, wird empfohlen, diese Warnung zu ignorieren.

  • Wenn Sie keine Unterstützung für Huawei-Geräte benötigen oder die AR Engine-Funktionen nicht verwenden müssen, können Sie das AR Engine SDK in der EasyAR-Konfiguration deaktivieren.

    Anmerkung

    Auf Huawei-Geräten können auch andere EasyAR-Funktionen normal funktionieren, wenn die AR Engine deaktiviert ist. Der Bewegungstracking-Effekt unterscheidet sich jedoch von dem der AR Engine, und auch andere Funktionen, die Bewegungstracking verwenden werden beeinträchtigt.

Zusätzliche Informationen zur HarmonyOS-Plattform

HarmonyOS, das mit Android kompatibel ist

Das EasyAR Sense Unity Plugin unterstützt HarmonyOS 1.0 – 4.x vollständig.

Native HarmonyOS/HarmonyOS NEXT

Das EasyAR Sense Unity Plugin wird in Kürze die native HarmonyOS 5.0+ unterstützen. Die aktuelle Version unterstützt noch nicht die native HarmonyOS/HarmonyOS NEXT und kann nur über die Android-Anwendungs-Kompatibilitätsebene verwendet werden.

Tipp

Die internationale Version von Unity unterstützt die native HarmonyOS nicht. Sie müssen Tuanjie Engine verwenden.

WebGL

Das EasyAR Sense Unity Plugin unterstützt die WebGL-Funktion von Unity nicht.

Tipp

Funktionen, die direkt mit den EasyAR Cloud-Service-Schnittstellen (z. B. der CRS-Service-Schnittstelle) entwickelt wurden, können auf Web-Plattformen veröffentlicht werden.

Graphics API

Das EasyAR Sense Unity Plugin verwendet direkt die Rendering-Pipeline von Unity und unterstützt alle Grafik-APIs, die in Unity verwendet werden können.

Scriptable Render Pipeline

Das EasyAR Sense Unity Plugin unterstützt die Universal Render Pipeline (URP) 7.0.0 oder neuere Versionen.

Das EasyAR Sense Unity Plugin unterstützt die High Definition Render Pipeline (HDRP) nicht.

Anmerkung

Erklärung zur Unterstützung des Unity 6 URP 17+ Render Graphs

EasyAR unterstützt den Unity 6 URP 17+ Render Graph, aber es gibt noch einige ungelöste Probleme in Unity selbst. Wenn Sie auf Probleme stoßen, können Sie die URP-Kompatibilitätsmodus von Unity versuchen.

Einige Probleme wurden in der neuesten Version von Unity behoben. Es wird empfohlen, Version 6.2 oder höher zu verwenden.

Bekannte Probleme außerhalb des Kompatibilitätsmodus:

  1. [Ungelöst] Wenn die Kameratexur von EasyAR abgerufen wird (ähnlich wie in der ImageTracking_Coloring3D-Beispielanwendung und der ARSession-Arbeitsweise (CameraDevice)), können auf iOS-/Mac-Geräten visuelle Störungen und Artefakte beobachtet werden. Wir haben dieses Problem in einem reinen Unity-Paket reproduziert und an Unity gemeldet: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph) . Der Fortschritt des Problems kann anhand der Aktualisierungen von Unity Issue UUM-87787 und den Veröffentlichungsprotokollen zukünftiger Unity-Versionen verfolgt werden.

    Für alle Versionen von Unity 6 kann die Teilumgehungsmaßnahme verwendet werden, die standardmäßig aktiviert ist.

    Für Unity 6.2 und neuere Versionen können Sie den Render Scale in der Universal Render Pipeline Asset auf einen Wert außerhalb von 0.96 - 1.05 setzen, um dieses Problem zu umgehen.

  2. [In Unity 6.2 behoben] Auf Windows DX11 kann das Kamerabild die Rendering-Effekte von Objekten in der Szene unvorhersehbar machen. In den Unity-Versionen 6.0 - 6.1 bietet EasyAR die Umgehungsoption, die standardmäßig aktiviert ist.

  1. Die aktuelle Version unterstützt noch nicht das native HarmonyOS/HarmonyOS NEXT 5.0.↩