Table of Contents

Note di rilascio di EasyAR Sense Unity Plugin

Siamo lieti di annunciare il rilascio di EasyAR Sense Unity Plugin 4000. Questa versione segna il fatto che EasyAR possiede un API completa e un supporto per i dispositivi che si mantiene aggiornato con i tempi, mentre il rilascio delle nuove versioni sarà anche più frequente rispetto al passato.

Scarica EasyAR Sense Unity Plugin 4000 per godere di queste nuove funzionalità e miglioramenti.

Versioni precedenti

Versione 4002.0.0

Data di rilascio: 2026-05-18

  • 🐛 Risolto il problema di build Android non riuscita con Unity 6.4.4.
  • 🔧 Modificato parte del codice di esempio.
  • ⬆️ Aggiornato EasyAR Sense alla 4.9.0

Versione 4001.0.0

Data di rilascio: 2026-03-10

  • 🐛 Risolto un problema numerico nella conversione della pose da nativo a Unity. Questo problema causava salti brevi nella pose quando si utilizzava Mega su alcuni dispositivi, portando a sfarfallamento o tremolio rapido del contenuto. La correzione di questo problema potrebbe risolvere anche altri potenziali problemi simili.
  • 🔧 Modificate alcune interfacce di MegaTrackerFrameFilter per adattarsi alle modifiche delle interfacce di EasyAR Sense
  • ⬆️ Aggiornato EasyAR Sense alla 4.8.0

Versione 4000.0.1

Data di rilascio: 2025-11-14

  • 🐛 Risolto: risolto il potenziale errore di runtime AndroidJavaException attivato dalla mancanza di metodi statici (loadLibraries, setupActivity) nelle build Android con minify abilitato, che impediva a EasyAR di funzionare.

Versione 4000.0.0

Data di rilascio: 2025-10-20

A partire da questa versione, EasyAR Sense Unity Plugin seguirà il Controllo versione dei pacchetti (utilizzando Semantic Versioning) richiesto da Unity, quindi il numero di versione sarà diverso da EasyAR Sense e la frequenza di rilascio potrebbe essere diversa. Questa versione del plugin contiene la versione ufficiale EasyAR Sense 4.7.0.

EasyAR Sense Unity Plugin 4000.0.0 introduce cambiamenti significativi, concentrandosi principalmente su questi aspetti:

  1. Modifiche alla compatibilità con Unity e AR Foundation

    A partire da questa versione, EasyAR Sense Unity Plugin supporterà solo Unity 2021.3 e versioni successive, il supporto per Unity 6 è stato anche perfezionato. Allo stesso tempo, il supporto AR Foundation è stato unito nel pacchetto del plugin, questa versione supporterà solo AR Foundation 5 e versioni successive, e il suo utilizzo è stato semplificato notevolmente. Se nella scena vengono aggiunti componenti di AR Foundation, la configurazione della scena e il codice dello script possono rimanere invariati, indipendentemente dal fatto che AR Foundation venga utilizzato o meno dopo l'esecuzione.

  2. Supporto aggiornato per i visori, nuovo supporto per diversi visori OST/VST

    Dopo anni di affinamento con diverse aziende del settore, il supporto di EasyAR per i visori è stato standardizzato. Ora puoi implementare il supporto per dispositivi visore di terze parti tramite l'estensione EasyAR Sense Unity Plugin (potrebbe essere necessario che il produttore del visore fornisca alcune interfacce dati). Questa versione include il supporto integrato per Apple Vision Pro e XREAL Air2 Ultra, e supporta Pico 4 Ultra Enterprise e Rokid AR Studio tramite il pacchetto di estensione EasyAR Sense Unity Plugin. Allo stesso tempo, puoi anche ottenere pacchetti di estensione per il supporto di altri dispositivi da alcuni partner di EasyAR (come Xrany 元霓).

  3. Miglioramento delle interfacce dei componenti Unity, ottimizzazione massiccia del flusso di lavoro ARSession

    Questa versione è la prima a incapsulare completamente le funzionalità di EasyAR Sense tramite componenti Unity. ARSession è stato ampiamente ottimizzato e riscritto, ora puoi facilmente implementare il giudizio di supporto per dispositivi o funzioni, avviare o arrestare ARSession in base alla situazione specifica per realizzare il cambio runtime di ARSession o diverse funzioni AR. Allo stesso tempo, puoi anche utilizzare ARSessionFactory per creare ARSession e componenti correlati in fase di esecuzione. Questa versione aggiunge anche funzionalità di navigazione inerziale e fotocamera 3DoF, queste funzionalità sono progettate principalmente per EasyAR Mega, ma possono essere utilizzate anche separatamente.

  4. Nuovi strumenti di sviluppo e diagnostica

    Questa versione aggiunge nuove funzionalità di registrazione e riproduzione EIF, sebbene la registrazione e la riproduzione EIF fossero utilizzabili anche nelle versioni passate, l'uso di EIF non è mai stato così semplice. Ora puoi utilizzare lo strumento di diagnostica Session Validation Tool nell'editor Unity per riprodurre direttamente eif e guidare la tua scena, sia che si tratti di tracciamento di immagini, mappe spaziali o EasyAR Mega, puoi ripristinare l'effetto di esecuzione sul dispositivo sul computer. Ora puoi utilizzare il pannello di diagnostica runtime EasyAR Diagnostics Panel nell'app per attivare facilmente la funzione di registrazione eif, o attivare/disattivare la visualizzazione delle informazioni sullo stato chiave di ARSession e dei suoi componenti in qualsiasi momento. Allo stesso tempo, gli esempi di questa versione sono stati tutti riscritti, eseguendo l'esempio puoi vedere direttamente lo stato ARSession e il pulsante per registrare eif per facilitare l'uso.

  5. Rilascio completo degli strumenti EasyAR Mega

    Questa versione integra e rilascia Mega Studio 2.12. In futuro, gli aggiornamenti del plugin saranno più frequenti, gli strumenti Mega lato Unity verranno gradualmente uniti all'interno del plugin e rilasciati insieme agli aggiornamenti regolari del plugin. Oltre agli aggiornamenti nelle versioni pre-rilascio precedenti, questa versione abiliterà il supporto alla navigazione inerziale per impostazione predefinita, espandendo ulteriormente in modo massiccio il supporto dei dispositivi per EasyAR Mega. Questa versione contiene anche il supporto per l'ultima versione del servizio EasyAR Mega Landmark. È possibile richiedere l'uso di EasyAR Mega tramite la pagina web di EasyAR.

Di seguito i dettagli degli aggiornamenti:

Cambiamenti di compatibilità per unity e AR foundation:

  • 🔧 Unity: Supporta unity 2021.3 e versioni successive (incluso unity 2022.x/unity 6.x)
    • 🔥 Rimosso supporto per unity 2019/unity 2020
    • 🔥 Rimosso rilevamento versione gradle per unity 2019
    • 🔥 Rimosso opzione DisableARCoreAREngine per unity 2019
  • ✨ Unity 6: Supporto completo per unity 6
    • ✨ Supporta URP 17+ e Render Graph
    • 🐛 Risolto: Comportamento modificato di ClassLoader su unity 6 causava malfunzionamento ARCore
    • 🐛 Risolto: Rendering camera non funzionante con Render Scale non-1
    • 🐛 BUG interno unity 6: Su dispositivi iOS/Mac sono osservabili malfunzionamenti visivi e artefatti. Si verifica solo quando è necessario acquisire la texture della camera. Abbiamo aggiunto mitigazioni parziali ma non eliminabili completamente. Segnalato a Unity, vedi Unity Issue UUM-87787. Su unity 6.2+ è possibile evitare impostando Render Scale in Universal Render Pipeline Asset su valori diversi da 0.96-1.05.
    • 🐛 BUG interno unity 6: Rendering anomalo su Windows DX11. Abbiamo aggiunto mitigazioni per unity 6.0-6.1. Verificato che unity 6.2 risolve il problema.
  • ✨ AR foundation: Supporta AR foundation 5 e versioni successive, uso notevolmente semplificato
    • ✨ Il supporto AR foundation è integrato nel plugin, non è più necessario importare pacchetti separati (disattivabile tramite opzioni)
    • ✨ Supporta il riutilizzo di Unity.XR.CoreUtils.XROrigin come origine ARSession, supporta il riutilizzo della Camera di XROrigin
    • ✨ Aggiunta opzione di configurazione Unity XR Auto Switch, gestisce automaticamente l'attivazione/disattivazione degli oggetti Unity XR (incluso AR foundation)
    • ✨ Le ARSession create dal menu EasyAR includono automaticamente e abilitano per default il supporto AR foundation
    • ✨ La maggior parte degli sample include ora supporto AR foundation (AR foundation richiede importazione e configurazione manuale)
    • 🔧 ARCore e ARKit controllabili separatamente, con priorità regolabile tra le versioni integrate in EasyAR e quelle di AR foundation
    • 🔥 Rimosso supporto per AR foundation 4
    • 🔥 Rimosso supporto per ARSessionOrigin, supportato solo XROrigin
    • 🔥 Rimosso flusso di installazione ARCore tramite proxy per AR foundation
  • ✨ Piena compatibilità con Input System Package

Supporto aggiornato per headset, aggiunta compatibilità con nuovi modelli OST/VST:

  • 🚀 Interfaccia per headset stabilizzata, supporta integrazioni di terze parti
    • ✨ Supporta dispositivi di terze parti (richiede interfacce dati specifiche dal produttore)
    • ✨ Supporta XROrigin e XR Interaction Toolkit
    • ✨ Semplificati e unificati tutti gli esempi per headset, zero codice, con supporto per cambio funzioni
    • ✨ Supporto per input da fotocamera fish-eye
    • ✨ Supporto per input dati 3DOF da fotocamera personalizzata
    • ✨ Aggiunto menu: Extensions, per raccogliere tutte le voci di menu aggiuntive
    • 🐛 Risolto un problema di rendering anomalo su alcuni headset durante l'uso di DenseSpatialMap
    • 🔥 Rimossi esempi obsoleti per occhiali come ActionOne e BT350
  • ✨ Supporto nativo per Apple Vision Pro
    • ✨ Supporta Metal, RealityKit e modalità Hybrid
    • ✨ Supporta visionOS >= 2.0, supporta visionOS 26
  • ✨ Supporto nativo per XREAL Air2 Ultra (richiede XREAL SDK >= 3.1)
    • ✨ Non è più necessario importare pacchetti di supporto separati
    • ⚡ Ottimizzate le prestazioni su XREAL
    • 🔥 Rimosso supporto per XREAL Light
  • ✨ Supporto per altri dispositivi come Pico e Rokid distribuito tramite l'estensione EasyAR Sense Unity Plugin
    • ✨ Fornito template di riferimento per integrazione dispositivi di terze parti com.easyar.sense.ext.hmdtemplate
    • ✨ Supporta Pico 4 Ultra Enterprise (richiede PICO Unity Integration SDK >= 3.1)
    • ✨ Supporta Rokid AR Studio (richiede Rokid Unity OpenXR Plugin >= 3.0.3)
    • ✨ Queste estensioni supporteranno le future versioni di EasyAR Sense Unity Plugin
  • ✨ Supporto per EasyAR XR License
    • 🔧 L'uso di EasyAR su headset richiede una EasyAR XR License e una connessione internet iniziale (la versione trial richiede connessione ogni volta)

Miglioramento delle interfacce dei componenti Unity, ottimizzazione significativa del flusso di lavoro di ARSession:

  • 🚀 Perfezionamento dell'incapsulamento dello strato dei componenti Unity
    • ✨ Perfeziona i componenti di scena, fornendo tutte le funzionalità di EasyAR Sense
    • 🔥 Rimuove tutte le interfacce dello strato EasyAR Sense incapsulate tramite componenti
    • 🔥 Rimuove tutte le interfacce interne
  • ✨ ARSession: Riscritto e ottimizzato significativamente il flusso di lavoro
    • ✨ Supporta l'avvio e l'arresto della sessione in qualsiasi momento
    • ✨ Supporta il controllo dell'avvio automatico della sessione
    • ✨ Supporta il cambio delle funzionalità della sessione e della sorgente di input senza schermata nera
    • ✨ Semplifica la verifica del supporto del dispositivo, fornita tramite un'interfaccia coerente
    • ✨ Aggiorna le liste di supporto dei dispositivi per MotionTracker, ARCore, AR Engine all'avvio
    • ✨ Supporta il riavvio automatico della sessione dopo l'aggiornamento della lista dei dispositivi
    • ✨ Supporta l'ottenimento di informazioni dettagliate sul danneggiamento della sessione
    • ✨ Aggiunge l'auto-verifica dello stato interno della sessione
    • 🔥 Rimuove ARComponentPicker, le sue funzionalità sono sostituite dal resto del flusso della sessione
    • 🔥 Impedisce l'esecuzione simultanea di più ARSession
  • ✨ ARSessionFactory: Fornisce la funzionalità di creare ARSession e componenti correlati durante il runtime
    • ✨ Supporta la creazione di sessioni durante il runtime tramite ARSessionFactory identiche a quelle del menu dell'editor
    • ✨ Aggiunge la funzionalità di ordinamento della Frame Source (inclusa voce di menu)
  • ✨ FrameSource: Aggiunge il supporto per l'inerzia e 3DoF
    • ✨ Aggiunge InertialCameraDeviceFrameSource per supportare la navigazione inerziale
    • ✨ Aggiunge ThreeDofCameraDeviceFrameSource per supportare la fotocamera 3DoF
    • ✨ Aggiunge la funzionalità di menu: Frame Source by Transform Type, fornendo un elenco di tutte le FrameSource integrate
    • ⚡ Ottimizza le opzioni dell'Inspector
  • ✨ Altri aggiustamenti delle interfacce e aggiornamenti funzionali
    • ✨ Aggiunge la funzionalità di creare ImageTarget utilizzando Texture2D
    • ✨ Aggiunge ImageMaterial per il rendering di dati di tipo Image (immagine della fotocamera o immagine del Target, ecc.)
    • ✨ Aggiunge ActiveController per controllare l'active di GameObject, unificando la logica di controllo correlata
    • ✨ Aggiunge la funzionalità di simulare la rotazione dello schermo su desktop
    • ✨ Aggiunge XROriginChildController, controlla il comportamento degli oggetti sotto l'origine della Session
    • 🔥 Rimuove WorldRootController
    • 🔧 L'interfaccia della mappa spaziale sparsa è suddivisa in due componenti funzionali distinti: Builder e Tracker
    • 🔧 Modifica EasyARController, fornendo funzionalità statiche a livello di applicazione/sistema
    • 🔧 Unifica le interfacce dei componenti Target
    • 🔧 Unifica l'interfaccia di accesso ai dati dei servizi

Aggiunta di più strumenti di sviluppo e diagnostica:

  • 🚀 Aggiunto strumento diagnostico durante la modifica: Session Validation Tool
    • ✨ Semplifica la riproduzione di eif in qualsiasi scenario
    • ✨ Supporta il controllo del flusso di riproduzione eif
    • ✨ Supporta il controllo del flusso della sessione
  • 🚀 Aggiunto pannello diagnostico runtime: EasyAR Diagnostics Panel
    • ✨ Aggiunto interruttore Developer Mode, per impostazione predefinita clicca 8 volte sullo schermo per attivare/disattivare Diagnostics Panel, semplifica la registrazione eif e il feedback sui problemi per app online
    • ✨ Supporta interruttore Developer Mode personalizzabile, utilizza interazioni personalizzate per attivare/disattivare Diagnostics Panel
    • ✨ Supporta il controllo della registrazione eif
    • ✨ Supporta il controllo della visualizzazione delle informazioni della sessione
    • ✨ Supporta il controllo della registrazione eed
  • ✨ Aggiunte nuove funzionalità di registrazione e riproduzione EIF
    • ✨ FrameRecorder si assemblerà automaticamente in ARSession, non è più necessario selezionarlo manualmente
    • ✨ FrameRecorder genererà automaticamente un nome file per impostazione predefinita per supportare l'uso senza script
    • ✨ FramePlayer supporta salti di riproduzione e regolazione della velocità con i dati registrati nel nuovo formato, riducendo le dimensioni del file
    • 🔧 Supporta l'utilizzo di eif su computer per pilotare scene e funzionalità AR (non nuova funzionalità)
  • ✨ Aggiunto DiagnosticsController, unifica e ottimizza le funzionalità diagnostiche
    • ✨ Aggiunta visualizzazione e controllo gerarchico delle informazioni, per impostazione predefinita tutti i messaggi di errore e avviso vengono visualizzati tramite UI
    • ✨ Aggiunta funzionalità per visualizzare le informazioni chiave sullo stato di ARSession e dei suoi componenti, per impostazione predefinita vengono visualizzate tramite UI e aggiornate ogni frame
    • 🔧 Utilizza le funzionalità diagnostiche per semplificare l'acquisizione di informazioni per il feedback sui problemi
    • 🔥 Rimosso GUIPopup
  • 🔧 Ottimizzato il comportamento degli stati anomali e la visualizzazione dei messaggi di errore
    • 🔧 Ottimizzati i messaggi di errore quando non è disponibile una fonte frame
    • 🔧 In ambienti URP che utilizzano EasyAR anziché AR Foundation o rendering del visore per immagini della fotocamera, una configurazione errata di RendererFeature genererà un errore e interromperà l'esecuzione di ARSession
    • 🔧 Modificata la strategia di controllo Active predefinita di Origin, i contenuti aderiscono allo schermo anziché scomparire durante la perdita del tracciamento
    • 🔧 Quando si utilizzano prodotti di prova su fotocamera personalizzata o visore, al raggiungimento del limite di tempo tutti i contenuti verranno nascosti per evitare giudizi errati sull'effetto
  • 🔧 Ottimizzati contenuti e opzioni della pagina di configurazione
    • ✨ Supporta la selezione di varianti della libreria EasyAR Sense
    • 🔒 Nella sezione permessi app, tranne il permesso della fotocamera, gli altri permessi non sono più modificabili, determinati dalla variante della libreria EasyAR Sense e dall'abilitazione di Mega
    • 🔧 Configurazione funzionalità e server raggruppata per funzionalità EasyAR
    • 🔧 Gestione centralizzata della configurazione di SDK AR di terze parti
    • 🔧 Gestione centralizzata della configurazione Workaround per Unity

EasyAR Mega strumenti completamente pubblici:

  • 🚀 Pubblicazione completa, aggiornamenti sincronizzati
    • ✨ Integrata pubblicazione di Mega Studio 2.12
    • 🔧 Gli strumenti Mega lato Unity verranno gradualmente integrati nel plugin stesso. In futuro verrà fornito solo il pacchetto integrato dell'ultima versione, ma unito agli aggiornamenti regolari di EasyAR Sense Unity Plugin
    • 🔧 EasyAR Mega richiede ancora l'applicazione tramite la pagina web di EasyAR e l'approvazione per l'utilizzo
  • ✨ Nuovo supporto per EasyAR Mega Landmark
  • ✨ Nuovo supporto per 5DOF inerziale abilitato di default, ampliando significativamente la compatibilità dei dispositivi con EasyAR Mega
  • ✨ Nuovo supporto per l'accesso ai servizi Mega tramite API Token
  • 🔧 Ottimizzazioni per Mega e miglioramenti dell'esperienza di sviluppo (inclusi nelle versioni 4.7.x aggiornate in precedenza)
    • ✨ Supporto per modalità 3DOF rotazione pura e modalità 0DOF (disabilitate di default)
    • ✨ Aggiunta di EditorCameraDeviceFrameSource per la diagnostica in editor, evitando esecuzioni errate su dispositivi mobili dovute a copie incomplete di sample
    • ✨ Durante l'utilizzo di Mega per registrare dati eif di vecchie versioni, FrameRecorder genererà automaticamente un file .eif.json
    • 🔧 Sostituzione dell'opzione di fallback per il debug remoto con LocationInputMode
    • 🔧 Separazione della modalità senza tracciamento in un componente indipendente, generalmente non più necessario utilizzare o prestare attenzione
    • 🔧 Aggiunta dell'opzione BlockRootSource; in configurazione predefinita, dimenticare di impostare BlockRoot genererà un errore
    • 🔧 Regolazione del comportamento predefinito durante la localizzazione su più block, garantendo che più block non vengano utilizzati di default
    • 🔧 Adeguamento di alcuni nomi di interfaccia
    • 🔧 Generazione di eccezioni più chiare quando la Session include Mega ma non può essere utilizzata
    • 🔧 Regolazione del livello minimo QualityLevel per MotionTracker supportato da Mega a Limited
    • 🐛 Correzione di CloudLocalizerStatus.WakingUp non correttamente gestito, causante errori di runtime
    • 🔧 Alcune ottimizzazioni e modifiche sono descritte nel changelog di EasyAR Sense

Campione Riscritto e Ottimizzato:

  • ✨ Riscrittura di tutti i campioni
    • ✨ Compatibilità con diverse configurazioni di Input System
    • ✨ Compatibile con URP17+
    • ✨ Compatibile con l'utilizzo di AR Foundation
    • 🔧 Compatibile senza l'utilizzo di AR Foundation
    • 🔧 Mantenuti pochi campioni senza supporto AR Foundation
    • ⚡ Ottimizzazione di script e chiamate di interfaccia
    • 🚚 Alcuni campioni sono stati rinominati
    • 🔧 Sostituzione di modelli, video e altre risorse all'interno dei campioni
    • ⚡ Riduzione dell'uso di streaming assets, utilizzati e importati solo in campioni che mostrano funzionalità specifiche
    • ✨ Utilizzo di Texture2D per creare ImageTarget
  • ✨ Aggiunta di nuove funzionalità e dimostrazioni di interfaccia
    • ✨ Aggiunto campione Workflow_ARSession per apprendere il flusso di base della sessione e il supporto del dispositivo
    • ✨ Aggiunto campione Workflow_FrameSource_ExternalImageStream, utilizza video come fotocamera personalizzata (non utilizzabile per visori)
    • ✨ Aggiunto campione Combination_BasedOn_MotionTracking per apprendere l'uso, il cambio e il passaggio ad AR Foundation di varie funzionalità quando il motion tracking è disponibile
    • ✨ Aggiunto campione Combination_BasedOn_AppleVisioPro per mostrare l'uso e il cambio di varie funzionalità su Apple Visio Pro
    • ✨ Aggiunto campione Combination_BasedOn_Xreal per mostrare l'uso e il cambio di varie funzionalità sui dispositivi XREAL
    • ✨ Aggiunti diversi Mega campioni (inclusi nelle versioni 4.7.x aggiornate in passato)
    • ✨ Aggiunta la funzionalità di cambiare dimensione della fotocamera e modalità torcia in Workflow_FrameSource_CameraDevice
    • 🔥 Rimossi campioni AR Foundation separati, le loro funzionalità sono incluse in altri campioni
    • 🔥 Rimosso il campione FrameRecording, la sua funzionalità è inclusa in altri campioni
    • 🔥 Rimosso MotionTracking_Fusion, la sua funzionalità è inclusa in Combination_BasedOn_MotionTracking
    • 🔥 Rimosso SurfaceTracking_ImageTarget, la combinazione di funzionalità può essere facilmente implementata
    • 🔥 Rimosso Camera_CustomCamera, può essere implementato autonomamente se necessario
    • 🔥 Rimossi campioni per dispositivi obsoleti come ActionOne e BT350
  • ✨ Semplificazione dell'uso di registrazione e riproduzione eif
    • ✨ Aggiunto il pulsante di registrazione eif a tutti i campioni, i file eif registrati possono essere utilizzati nell'editor
  • ✨ Riscrittura del launcher, aggiunta della descrizione dei campioni
    • 🐛 Risolto il problema delle scene dei campioni caricate tramite launcher troppo scure

Integrazione di funzionalità AR EasyAR e di terze parti:

  • ⬆️ Aggiornato EasyAR Sense alla versione 4.7.0 finale
  • ⬆️ Aggiornato EasyAR AR Engine Interop
  • ⬆️ Aggiornato ARCore SDK alla versione 1.46.0
  • 🔧 Disabilitato AR Engine su alcuni telefoni dove non può funzionare correttamente
  • 🐛 Risolto malfunzionamento ARCore su Unity 6 causato dal cambiamento nel comportamento di ClassLoader

Argomenti correlati