Unity-Kompatibilitat
In diesem Artikel werden die mit EasyAR Sense Unity Plugin kompatiblen Unity-Versionen und Konfigurationsanforderungen beschrieben.
Unity-Versionen
EasyAR Sense Unity Plugin unterstutzt Unity 2021.3 oder hoher.
Das fur die Entwicklung von Mega-Funktionen benotigte EasyAR Mega Support-Paket unterstutzt Unity 2021.3.30 oder hoher.
Tipp
Im Allgemeinen hangt EasyAR nicht stark von sich andern den Unity-APIs ab. Wenn Unity also eine neue Version veroffentlicht, kann EasyAR Sense Unity Plugin in der Regel weiterhin normal verwendet werden.
EasyAR Sense Unity Plugin unterstutzt ab Version 4.6.4 den Render Graph von Unity 6 URP 17+.
Entwicklungsplattformen
| Betriebssystem | Betriebssystemversion | CPU-Architektur | Zusatzhinweis |
|---|---|---|---|
| Windows | Version 7 oder neuer (7/8.1/10/11) | x86, x86_64 | Fur Windows-N/KN-Versionen muss das Media Feature Pack installiert sein. |
| macOS | 11.0 oder neuer | x86_64, arm64 |
Außerdem mussen die jeweiligen Unity-Systemanforderungen fur die Entwicklung erfullt sein.
Verteilungsplattformen
| Betriebssystem | Betriebssystemversion | CPU-Architektur | Zusatzhinweis |
|---|---|---|---|
| Windows | Version 7 oder neuer (7/8.1/10/11) | x86, x86_64 | Fur Windows-N/KN-Versionen muss das Media Feature Pack installiert sein. EasyAR Screen Recording wird nicht unterstutzt. |
| macOS | 11.0 oder neuer | x86_64, arm64 | EasyAR Screen Recording wird nicht unterstutzt. |
| Android | 5.0 oder neuer | armv7a, arm64-v8a | arm64-v8a-Unterstutzung erfordert IL2CPP. EasyAR Screen Recording wird nur unterstutzt, wenn die Graphics API OpenGLES2 oder OpenGLES3 ist. |
| HarmonyOS (Mobilgerate) | 1.0 bis 4.x nativ unterstutzt Version 5 und neuer uber Android-App-Kompatibilitatsschicht unterstutzt1 |
arm64-v8a | |
| iOS | 15.0 oder neuer | arm64 | Die Architektur muss auf ARM64 gesetzt werden; Universal wird nicht unterstutzt. EasyAR Screen Recording wird nicht unterstutzt. |
| visionOS | 2.0 oder neuer | arm64 | EasyAR Screen Recording wird nicht unterstutzt. |
Außerdem mussen die jeweiligen Unity-Anforderungen fur die Verteilungsplattformen erfullt sein:
Zusatzhinweis fur macOS
Apple silicon
EasyAR Sense Unity Plugin unterstutzt ab Version 4.6.0 die native Ausfuhrung auf Apple-silicon-Geraten und kann auch im Unity-Editor normal verwendet werden.
Anmerkung
Aufgrund eines Bugs in der nativen Plugin-Unterstutzung von Unity konnen Anwendungen, die fur "Apple silicon" oder "Intel 64-bit + Apple silicon" erstellt wurden, in einigen Unity-Versionen nicht korrekt funktionieren. Wenn eine App auf dem Mac nicht lauft und Fehler wie "Fail to load EasyAR library" oder "DllNotFoundException: EasyAR assembly" anzeigt, empfiehlt es sich, eine neuere Unity-Version zu verwenden oder Hilfe bei Unity bzw. der Unity-Community zu suchen.
Zusatzhinweis fur Android
Unterstutzung fur Android-Gerate mit 16-KB-Speicherseitengroße
EasyAR Sense Unity Plugin unterstutzt seit Version 4000 Gerate mit 16-KB-Speicherseitengroße.
Tipp
Diese Funktion wurde in Android 15 eingefuhrt. Weitere Informationen finden Sie in der Android-Dokumentation zu 16-KB-Seitengroßen.
Google-Play-Warnung: libhuawei_arengine_jni.so kann zu einem Absturz auf 16-KB-Geraten fuhren
In der Standardkonfiguration verwendet EasyAR Sense Unity Plugin auf Android AR Engine SDK 3.7.0.3 (einschließlich libhuawei_arengine_jni.so), um Huawei AR Engine zu unterstutzen. Da diese Bibliothek von Huawei mit einem fruheren Android NDK kompiliert wurde, kann Google Play eine Warnung anzeigen. Das fuhrt jedoch nicht zu einem tatsachlichen Problem.
Your app could crash on 16 KB devices
base/lib/arm64-v8a/libhuawei_arengine_jni.so
Zu AR Engine SDK:
- Version 3.7.0.3 wurde von Huawei mit einem fruheren Android NDK kompiliert. Das ist der Grund fur die Google-Play-Warnung. Siehe die Google-Dokumentation zu mit Android NDK r27 und fruher kompilierte Apps.
- Version 3.7.0.3 kann auf Android-Geraten mit 16-KB-Speicherseitengroße geladen werden. Deshalb verhindert Google Play die Veroffentlichung der App nicht.
- Version 4.0.0.5 kann auf Android-Geraten mit 16-KB-Speicherseitengroße nicht geladen werden. Da dies die aktuell offentlich verfugbare Version von AR Engine SDK im Android-Okosystem ist, verwendet EasyAR Sense Unity Plugin weiterhin Version 3.7.0.3.
Die Verwendung von AR Engine SDK 3.7.0.3 durch EasyAR Sense Unity Plugin beeintrachtigt die Veroffentlichung im Google Play Store nicht und fuhrt auch nicht zu einem tatsachlichen Absturz:
- Huawei-Gerate gehoren nicht zu den Android-16-KB-Geraten.
- EasyAR Sense verwendet eine Whitelist, um zu verhindern, dass AR Engine SDK auf nicht-Huawei-Geraten ausgefuhrt wird.
Wie mit dieser Warnung umzugehen ist:
Wenn Sie die AR-Engine-Funktion auf Huawei-Geraten benotigen, konnen Sie die Warnung ignorieren.
Wenn Sie Huawei-Gerate nicht unterstutzen mussen oder die AR-Engine-Funktion nicht benotigen, konnen Sie AR Engine SDK in den EasyAR-Einstellungen deaktivieren.
Anmerkung
Auf Huawei-Geraten funktionieren auch bei deaktivierter AR Engine alle anderen EasyAR-Funktionen normal, aber das Motion-Tracking-Verhalten unterscheidet sich von AR Engine, und andere Funktionen mit Motion Tracking sind ebenfalls betroffen.
Zusatzhinweis fur HarmonyOS
Mit Android kompatibles HarmonyOS
EasyAR Sense Unity Plugin unterstutzt HarmonyOS 1.0 bis 4.x vollstandig.
Natives HarmonyOS / HarmonyOS NEXT / Full Native HarmonyOS
EasyAR Sense Unity Plugin wird in Kurze natives HarmonyOS 5.0+ unterstutzen. Die aktuelle Version unterstutzt natives HarmonyOS bzw. Full Native noch nicht und kann nur uber die Android-App-Kompatibilitatsschicht verwendet werden.
Tipp
Die internationale Unity-Version unterstutzt natives HarmonyOS nicht. Verwenden Sie dafur die Tuanjie-Engine.
WebGL
EasyAR Sense Unity Plugin unterstutzt Unity WebGL nicht.
Tipp
Funktionen, die direkt uber die EasyAR-Cloud-Service-API entwickelt werden (zum Beispiel CRS-Service-API), konnen fur die Web-Plattform veroffentlicht werden.
Graphics API
EasyAR Sense Unity Plugin verwendet direkt die Rendering-Pipeline von Unity. Alle in Unity nutzbaren Grafik-APIs werden unterstutzt.
Scriptable Render Pipeline
EasyAR Sense Unity Plugin unterstützt Universal Render Pipeline (URP) 7.0.0 oder neuere Versionen.
EasyAR Sense Unity Plugin unterstützt High Definition Render Pipeline (HDRP) nicht.
Anmerkung
Hinweis zur Unterstützung von Unity 6 URP 17+ render graph
EasyAR unterstützt Unity 6 URP 17+ render graph, aber in Unity selbst bestehen weiterhin einige ungelöste Probleme. Bei ungewöhnlichen Situationen können Sie versuchen, den von Unity bereitgestellten URP-Kompatibilitätsmodus zu verwenden.
Einige Probleme wurden in den neuesten Unity-Versionen bereits behoben. Es wird empfohlen, Version 6.2 oder höher zu verwenden.
Bekannte Probleme im Nicht-Kompatibilitätsmodus umfassen:
[Nicht gelöst] Wenn Kameratexturen von EasyAR abgerufen werden (ähnlich wie im Beispiel ImageTracking_Coloring3D und im Beispiel ARSession-Workflow (CameraDevice)), können auf iOS/Mac-Geräten visuelle Fehler 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). Den Fortschritt des Problems können Sie über Unity Issue UUM-87787 sowie über die Release Notes zukünftiger Unity-Versionen verfolgen.
Für alle Versionen von Unity 6 kann die teilweise Abhilfemaßnahme verwendet werden; sie ist standardmäßig aktiviert.
Für Unity 6.2 und neuere Versionen kann dieses Problem umgangen werden, indem Render Scale im Universal Render Pipeline Asset auf einen Wert außerhalb von 0.96-1.05 gesetzt wird.
[In Unity 6.2 behoben] Unter Windows DX11 kann das Kamerabild dazu führen, dass das Rendering von Objekten in der Szene unvorhersehbar wird. In Unity 6.0 - 6.1 stellt EasyAR eine Umgehungsoption bereit, die standardmäßig aktiviert ist.
-
Die aktuelle Version unterstutzt noch kein natives HarmonyOS bzw. HarmonyOS 5.0 Full Native.↩