Table of Contents

Compatibilità con Unity

Questo articolo presenta le versioni di Unity e i requisiti di configurazione compatibili con il plugin EasyAR Sense Unity.

Versioni di Unity

Il plugin EasyAR Sense Unity supporta Unity 2021.3 o versioni successive.

Il pacchetto di supporto EasyAR Mega necessario per lo sviluppo delle funzionalità Mega supporta Unity 2021.3.30 o versioni successive.

Consiglio

In genere, EasyAR non dipende da molte API di Unity che cambiano spesso, quindi se viene pubblicata una nuova versione di Unity, il plugin EasyAR Sense Unity può generalmente essere utilizzato normalmente.

Il plugin EasyAR Sense Unity supporta URP 17+ Render Graph di Unity 6 a partire dalla versione 4.6.4.

Piattaforme di sviluppo

Sistema operativo Versione del sistema operativo Architettura CPU Note aggiuntive
Windows 7 e versioni successive (7/8.1/10/11) x86, x86_64 Le versioni Windows N/KN richiedono l'installazione del Media Feature Pack per essere utilizzate
macOS 11.0 e versioni successive x86_64, arm64

Inoltre, è necessario soddisfare i requisiti del sistema di sviluppo di Unity corrispondenti https://docs.unity3d.com/Manual/system-requirements.html.

Piattaforme di pubblicazione

Sistema operativo Versione del sistema operativo Architettura CPU Note aggiuntive
Windows 7 e versioni successive (7/8.1/10/11) x86, x86_64 Le versioni Windows N/KN richiedono l'installazione del Media Feature Pack per essere utilizzate.
La funzione di registrazione schermo EasyAR non è supportata.
macOS 11.0 e versioni successive x86_64, arm64 La funzione di registrazione schermo EasyAR non è supportata.
Android 5.0 e versioni successive armv7a, arm64-v8a Il supporto per arm64-v8a richiede l'attivazione di IL2CPP.
La funzione di registrazione schermo EasyAR è supportata solo quando l'API grafica è OpenGLES2 o OpenGLES3.
Hongmeng (su dispositivi mobili) Supporto nativo per 1.0 – 4.x
Sospeso tramite il livello di compatibilità delle applicazioni Android per 5 e successive1		 arm64-v8a
iOS 15.0 e versioni successive arm64 L'architettura deve essere configurata come ARM64, non è supportata la configurazione come Universal.
La funzione di registrazione schermo EasyAR non è supportata.
visionOS 2.0 e versioni successive arm64 La funzione di registrazione schermo EasyAR non è supportata.

Inoltre, è necessario soddisfare i requisiti delle piattaforme di pubblicazione di Unity corrispondenti:

Note aggiuntive per la piattaforma macOS

Apple silicon

Il plugin EasyAR Sense Unity supporta l'esecuzione nativa su dispositivi Apple silicon a partire dalla versione 4.6.0 e può essere utilizzato normalmente nell'editor di Unity.

Nota

A causa di un bug nel supporto delle librerie native di Unity, in alcune versioni di Unity, l'applicazione compilata per "Apple silicon" o "Intel 64-bit + Apple silicon" potrebbe non funzionare correttamente. Se si verifica che l'app non è utilizzabile su Mac e si visualizzano errori come "Fail to load EasyAR library" o "DllNotFoundException: EasyAR assembly", è consigliabile utilizzare una nuova versione di Unity o chiedere assistenza a Unity e alla comunità di Unity.

Note aggiuntive per la piattaforma Android

Supporto per la dimensione della pagina di memoria di 16 KB su Android

Il plugin EasyAR Sense Unity supporta dispositivi con una dimensione della pagina di memoria di 16 KB a partire dalla versione 4000.

Consiglio

Questa è una funzione introdotta in Android 15. Per ulteriori informazioni su questa funzione, si veda la documentazione Android sulla supporto per la dimensione della pagina di 16 KB.

Avviso di Google Play: libhuawei_arengine_jni.so potrebbe causare il crash dell'app su dispositivi a 16 KB

In configurazione predefinita, il plugin EasyAR Sense Unity utilizzerà AR Engine SDK 3.7.0.3 (che include libhuawei_arengine_jni.so) sulla piattaforma Android per supportare Huawei AR Engine. Poiché questa libreria è stata compilata da Huawei utilizzando una versione precedente dell'Android NDK, Google Play potrebbe emettere un avviso, ma ciò non ha effetti reali.

alt text

La tua app potrebbe crashare su dispositivi a 16 KB

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Informazioni sull'AR Engine SDK:

  • La versione 3.7.0.3 è stata compilata da Huawei utilizzando una versione precedente dell'Android NDK, motivo per cui Google Play emette l'avviso. Vedere la documentazione di Google sulla compilazione di applicazioni utilizzando Android NDK r27 e versioni inferiori per ulteriori dettagli.
  • La versione 3.7.0.3 supporta il caricamento su dispositivi con una dimensione della pagina di memoria di 16 KB su Android, motivo per cui Google Play non vieta la pubblicazione dell'app.
  • La versione 4.0.0.5 non supporta il caricamento su dispositivi con una dimensione della pagina di memoria di 16 KB su Android. Questa è l'ultima versione disponibile pubblicamente dell'AR Engine SDK nell'ecosistema Android, quindi il plugin EasyAR Sense Unity continua a utilizzare la versione 3.7.0.3.

L'utilizzo del plugin EasyAR Sense Unity con l'AR Engine SDK 3.7.0.3 non influisce sulla pubblicazione dell'app su Google Play e non causa effettivamente crashi:

  • I dispositivi Huawei non appartengono a quelli Android a 16 KB.
  • EasyAR Sense utilizza un meccanismo di whitelist per evitare di eseguire l'AR Engine SDK su dispositivi non Huawei.

Come gestire questo avviso:

  • Se si desidera utilizzare le funzionalità di AR Engine su dispositivi Huawei, è consigliabile ignorare l'avviso.

  • Se non è necessario supportare dispositivi Huawei o se è possibile non utilizzare le funzionalità di AR Engine, è possibile disattivare l'AR Engine SDK in Configurazione EasyAR.

    Nota

    Su dispositivi Huawei, anche se si disattiva AR Engine, le altre funzionalità di EasyAR possono funzionare normalmente, ma l'effetto del tracciamento del movimento sarà diverso da quello di AR Engine e le altre funzionalità che utilizzano il tracciamento del movimento saranno influenzate.

Note aggiuntive per la piattaforma Hongmeng

Hongmeng compatibile con Android

Il plugin EasyAR Sense Unity supporta completamente Hongmeng 1.0 – 4.x.

Hongmeng nativo/Hongmeng pulito/HarmonyOS NEXT

Il plugin EasyAR Sense Unity supporta Hongmeng nativo 5.0+ in un futuro prossimo. La versione corrente non supporta Hongmeng nativo/Hongmeng pulito e può essere utilizzato solo tramite il livello di compatibilità delle applicazioni Android.

Consiglio

L'edizione internazionale di Unity non supporta Hongmeng nativo. È necessario utilizzare Unity Engine.

WebGL

Il plugin EasyAR Sense Unity non supporta WebGL di Unity.

Consiglio

Le funzionalità sviluppate utilizzando direttamente le interfacce di servizio cloud EasyAR (ad esempio interfaccia di servizio CRS) possono essere pubblicate sulla piattaforma Web.

API grafica

Il plugin EasyAR Sense Unity utilizza direttamente la pipeline di rendering di Unity e supporta tutte le API grafiche utilizzabili in Unity.

Scriptable Render Pipeline

Il plugin EasyAR Sense Unity supporta Universal Render Pipeline (URP) 7.0.0 o versioni successive.

Il plugin EasyAR Sense Unity non supporta High Definition Render Pipeline (HDRP).

Nota

Dichiarazione sulla supporto per Unity 6 URP 17+ render graph

EasyAR supporta Unity 6 URP 17+ render graph, ma Unity stesso presenta alcuni problemi ancora non risolti. In caso di situazioni eccezionali, è possibile provare ad utilizzare la modalità di compatibilità URP fornita da Unity.

Alcuni problemi sono stati risolti nella versione più recente di Unity. È consigliabile utilizzare la versione 6.2 e successive.

I problemi noti in modalità non compatibile includono:

  1. [Non risolto] Quando si ottiene la texture della telecamera da EasyAR (come nell'esempio ImageTracking_Coloring3D e nell'esempio Flusso di lavoro ARSession (CameraDevice)), è possibile osservare guasti visivi e artefatti su dispositivi iOS/Mac. Abbiamo riprodotto questo problema nel pacchetto Unity puro e abbiamo segnalato il problema a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). È possibile seguire l'evoluzione del problema seguendo l'aggiornamento di Unity Issue UUM-87787 e il diario delle versioni future di Unity.

    Per tutte le versioni di Unity 6, è possibile utilizzare una misura di mitigazione parziale, attivata per impostazione predefinita.

    Per Unity 6.2 e versioni successive, è possibile evitare questo problema impostando la scala di rendering nell'Asset Universal Render Pipeline su un valore diverso da 0.96-1.05.

  2. [Risolto in Unity 6.2] La visualizzazione della telecamera su Windows DX11 rende l'effetto di rendering degli oggetti nella scena imprevedibile. In Unity 6.0 - 6.1, EasyAR fornisce una opzione di risoluzione] e è attivata per impostazione predefinita.

  1. La versione corrente non supporta Hongmeng nativo/Hongmeng pulito 5.0.↩