Table of Contents

Note di rilascio per EasyAR Sense Unity Plugin

Siamo lieti di annunciare il rilascio di EasyAR Sense Unity Plugin 4000. Questa versione segna che EasyAR dispone di API complete e supporto per dispositivi aggiornato, con rilasci più frequenti rispetto al passato.

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

Versioni precedenti

Versione 4001.0.0

Data di rilascio: 2026-03-10

  • 🐛 Correzione di un problema numerico nella conversione della pose da nativo a Unity. Questo problema poteva causare brevi salti nella pose durante l'uso di Mega su alcuni dispositivi, portando a rapide oscillazioni o tremolii del contenuto. La correzione potrebbe risolvere anche altri problemi simili potenziali.
  • 🔧 Adeguamento di alcune interfacce di MegaTrackerFrameFilter per adattarsi ai cambiamenti nelle interfacce di EasyAR Sense
  • ⬆️ Aggiornamento di EasyAR Sense a 4.8.0

Versione 4000.0.1

Data di rilascio: 2025-11-14

  • 🐛 Correzione: risolto un potenziale AndroidJavaException durante il runtime nelle build Android con minify abilitato, causato dall'assenza di metodi statici (loadLibraries, setupActivity). L'errore impediva il funzionamento di EasyAR.

Versione 4000.0.0

Data di rilascio: 2025-10-20

Da questa versione, EasyAR Sense Unity Plugin seguirà il controllo delle versioni dei pacchetti (utilizzando Semantic Versioning) richiesto da Unity. Pertanto, il numero di versione differirà da EasyAR Sense e la frequenza di rilascio potrebbe variare. Questo plugin include EasyAR Sense 4.7.0 versione stabile.

EasyAR Sense Unity Plugin 4000.0.0 introduce cambiamenti significativi, principalmente in queste aree:

  1. Compatibilità con Unity e AR Foundation

    Da questa versione, EasyAR Sense Unity Plugin supporterà solo Unity 2021.3 e versioni successive, con supporto completo per Unity 6. Il supporto per AR Foundation è stato integrato nel pacchetto del plugin, supportando solo AR Foundation 5 e versioni successive con un utilizzo notevolmente semplificato. Se nella scena sono presenti componenti di AR Foundation, la configurazione della scena e il codice degli script possono rimanere invariati, indipendentemente dall'utilizzo finale di AR Foundation.

  2. Supporto aggiornato per visori, con aggiunta di nuovi modelli OST/VST

    Dopo anni di affinamento con aziende del settore, il supporto di EasyAR per i visori è ora standardizzato. È possibile estendere EasyAR Sense Unity Plugin per supportare visori di terze parti (potrebbe richiedere interfacce dati dal produttore). Questa versione include supporto nativo per Apple Vision Pro e XREAL Air2 Ultra, oltre a supporto tramite pacchetti di estensione per Pico 4 Ultra Enterprise e Rokid AR Studio. È inoltre possibile ottenere pacchetti di estensione per altri dispositivi da alcuni partner di EasyAR (ad esempio Xrany 元霓).

  3. Perfezionamento delle interfacce dei componenti Unity, ottimizzazione significativa del flusso di lavoro di ARSession

    Questa è la prima versione che incapsula completamente le funzionalità di EasyAR Sense tramite componenti Unity. ARSession è stato ampiamente ottimizzato e riscritto, semplificando la verifica del supporto di dispositivi o funzionalità e consentendo l'avvio o l'arresto dinamico di ARSession per cambiare funzionalità AR durante l'esecuzione. È possibile utilizzare ARSessionFactory per creare dinamicamente ARSession e componenti correlati. Sono state aggiunte funzionalità di navigazione inerziale e fotocamera 3DoF, progettate principalmente per EasyAR Mega ma utilizzabili separatamente.

  4. Nuovi strumenti di sviluppo e diagnostica

    Questa versione introduce funzionalità completamente nuove di registrazione e riproduzione EIF. Sebbene disponibili in versioni precedenti, l'utilizzo di EIF non è mai stato così semplice. È ora possibile utilizzare lo strumento di diagnostica Session Validation Tool nell'editor Unity per riprodurre file eif e simulare il comportamento sulla scena, replicando su computer gli effetti di tracciamento immagini, mappe spaziali o EasyAR Mega osservati sul dispositivo. È possibile utilizzare il pannello di diagnostica runtime EasyAR Diagnostics Panel per avviare facilmente la registrazione eif nell'app o attivare/disattivare la visualizzazione delle informazioni chiave sullo stato di ARSession e dei suoi componenti. Inoltre, gli esempi (sample) sono stati completamente riscritti, mostrando direttamente lo stato di ARSession e un pulsante per registrare eif.

  5. Pubblicazione completa degli strumenti EasyAR Mega

    Questa versione include Mega Studio 2.12. Gli aggiornamenti futuri del plugin saranno più frequenti, con gli strumenti Mega per Unity integrati progressivamente nel plugin e pubblicati con gli aggiornamenti regolari. Oltre agli aggiornamenti delle versioni precedenti, questa versione abilita per impostazione predefinita il supporto alla navigazione inerziale, estendendo significativamente la compatibilità dei dispositivi con EasyAR Mega. Include inoltre il supporto per l'ultima versione del servizio EasyAR Mega Landmark. Per utilizzare EasyAR Mega è possibile fare richiesta tramite la pagina web di EasyAR.

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