Table of Contents

Compatibilità Unity

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

Versioni di Unity

EasyAR Sense Unity Plugin supporta Unity 2021.3 o versioni successive.

Il package di supporto EasyAR Mega necessario per sviluppare le funzioni Mega supporta Unity 2021.3.30 o versioni successive.

Consiglio

In generale, EasyAR non dipende da molte API Unity soggette a cambiamenti, quindi se Unity rilascia una nuova versione, EasyAR Sense Unity Plugin di solito può continuare a essere usato senza problemi.

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

Piattaforme di sviluppo

Sistema operativo Versione sistema Architettura CPU Nota
Windows 7 e versioni successive (7/8.1/10/11) x86, x86_64 Le versioni Windows N/KN richiedono l’installazione di Media Feature Pack
macOS 11.0 e versioni successive x86_64, arm64

Inoltre, devi soddisfare i requisiti di sistema di sviluppo Unity della versione corrispondente.

Piattaforme di rilascio

Sistema operativo Versione sistema Architettura CPU Nota
Windows 7 e versioni successive (7/8.1/10/11) x86, x86_64 Le versioni Windows N/KN richiedono l’installazione di Media Feature Pack.
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 arm64-v8a richiede IL2CPP.
La funzione di registrazione schermo EasyAR è supportata solo quando Graphics API è OpenGLES2 o OpenGLES3.
HarmonyOS (mobile) 1.0 – 4.x supporto nativo
5 e superiori tramite il layer di compatibilità delle app Android1		 arm64-v8a
iOS 15.0 e versioni successive arm64 Architecture deve essere impostata su ARM64; Universal non è supportato.
La funzione di registrazione schermo EasyAR non è supportata.
visionOS 2.0 e versioni successive arm64 La funzione di registrazione schermo EasyAR non è supportata.

Inoltre, devi soddisfare i requisiti di piattaforma di rilascio di Unity per la versione corrispondente:

Note aggiuntive per macOS

Apple silicon

EasyAR Sense Unity Plugin supporta l’esecuzione nativa sui dispositivi Apple silicon dalla versione 4.6.0, e può essere usato normalmente anche nell’editor Unity.

Nota

A causa di un bug nel supporto dei plugin nativi di Unity, in alcune versioni di Unity le applicazioni costruite per "Apple silicon" o "Intel 64-bit + Apple silicon" potrebbero non funzionare correttamente. Se l’app non funziona su Mac e mostra errori come "Fail to load EasyAR library" o "DllNotFoundException: EasyAR assembly", si consiglia di usare una versione più recente di Unity o di chiedere supporto a Unity e alla community di Unity.

Note aggiuntive per Android

Supporto per pagine di memoria da 16 KB su Android

EasyAR Sense Unity Plugin supporta dispositivi con pagine di memoria da 16 KB dalla versione 4000.

Consiglio

Questa funzione è stata introdotta in Android 15. Per maggiori informazioni, consulta la documentazione Android sul supporto alle pagine da 16 KB.

Avviso Google Play su libhuawei_arengine_jni.so che potrebbe causare crash su dispositivi da 16 KB

Con la configurazione predefinita, EasyAR Sense Unity Plugin usa AR Engine SDK 3.7.0.3 (che include libhuawei_arengine_jni.so) su Android per supportare Huawei AR Engine. Poiché questa libreria è stata compilata da Huawei con un vecchio Android NDK, Google Play può mostrare un avviso, ma in realtà non causa problemi.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Informazioni su AR Engine SDK:

  • La versione 3.7.0.3 è stata compilata da Huawei con un vecchio Android NDK, ed è per questo che Google Play mostra l’avviso. Consulta la documentazione Google su compilazione con Android NDK r27 e precedenti.
  • La versione 3.7.0.3 supporta il caricamento su dispositivi Android con pagine di memoria da 16 KB, ed è anche il motivo per cui Google Play non impedisce la pubblicazione dell’app.
  • La versione 4.0.0.5 non supporta il caricamento su dispositivi Android con pagine di memoria da 16 KB. Poiché è l’ultima versione pubblicamente disponibile nell’ecosistema Android, EasyAR Sense Unity Plugin continua a usare la versione 3.7.0.3.

Usare AR Engine SDK 3.7.0.3 con EasyAR Sense Unity Plugin non impedisce la pubblicazione su Google Play e non causa crash reali:

  • I dispositivi Huawei non fanno parte dei dispositivi Android da 16 KB.
  • EasyAR Sense usa una whitelist per evitare di eseguire AR Engine SDK su dispositivi non Huawei.

Come gestire questo avviso:

  • Se hai bisogno di usare la funzione AR Engine sui dispositivi Huawei, si consiglia di ignorare l’avviso.

  • Se non hai bisogno di supportare dispositivi Huawei o puoi fare a meno di AR Engine, puoi disattivare AR Engine SDK in Configurazione EasyAR.

    Nota

    Sui dispositivi Huawei, anche se disattivi AR Engine, le altre funzioni EasyAR continueranno a funzionare normalmente, ma il risultato del tracking del movimento sarà diverso da quello di AR Engine, e anche le altre funzioni che usano il tracking del movimento saranno interessate.

Note aggiuntive per HarmonyOS

Sistema Harmony compatibile con Android

EasyAR Sense Unity Plugin supporta completamente HarmonyOS 1.0 – 4.x.

HarmonyOS nativo / HarmonyOS puro / HarmonyOS NEXT

EasyAR Sense Unity Plugin supporterà a breve HarmonyOS nativo 5.0+; la versione attuale non lo supporta ancora e può essere usata solo tramite il layer di compatibilità delle app Android.

Consiglio

La versione internazionale di Unity non supporta HarmonyOS nativo; è necessario usare Tuanjie Engine.

WebGL

EasyAR Sense Unity Plugin non supporta WebGL di Unity.

Consiglio

Le funzioni sviluppate direttamente usando le interfacce dei servizi cloud EasyAR (per esempio l’interfaccia del servizio CRS) possono essere pubblicate sulla piattaforma Web.

Graphics API

EasyAR Sense Unity Plugin usa direttamente la render pipeline di Unity, quindi tutte le Graphics API utilizzabili in Unity sono supportate.

Scriptable Render Pipeline

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

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

Nota

Dichiarazione sul supporto di Unity 6 URP 17+ render graph

EasyAR supporta Unity 6 URP 17+ render graph, ma Unity ha ancora alcuni problemi irrisolti. In caso di comportamenti anomali, prova la modalità di compatibilità URP fornita da Unity.

Alcuni problemi sono già stati risolti nelle versioni più recenti di Unity, quindi si consiglia di usare la 6.2 o superiore.

I problemi noti in modalità non compatibile includono:

  1. [Non risolto] Quando si ottiene la texture della camera da EasyAR (come nell’esempio ImageTracking_Coloring3D e nell’esempio ARSession workflow (CameraDevice)), su dispositivi iOS/Mac possono comparire difetti visivi e artefatti. Abbiamo riprodotto il problema in un package Unity puro e lo abbiamo segnalato a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Puoi seguire l’avanzamento tramite Unity Issue UUM-87787 e i futuri changelog di Unity.

    Per tutte le versioni di Unity 6, puoi usare misure di mitigazione parziali, abilitate di default.

    Per Unity 6.2 e versioni successive, puoi impostare Render Scale nell’Universal Render Pipeline Asset su un valore diverso da 0.96-1.05 per evitare il problema.

  2. [Corretto in Unity 6.2] Su Windows DX11, l’immagine della camera può rendere imprevedibile il rendering degli oggetti nella scena. In Unity 6.0 - 6.1, EasyAR offre un’opzione di mitigazione attivata di default.

  1. La versione attuale non supporta ancora HarmonyOS nativo / HarmonyOS puro 5.0.↩