Migrazione di app Unity da EasyAR Sense Unity Plugin versione 4.2 e precedenti

A partire dalla versione 4.3, il plugin Unity viene distribuito e gestito tramite Unity Package Manager, con una significativa riorganizzazione della struttura del pacchetto. Pertanto, quando si esegue l'aggiornamento dalla versione 4.2 o inferiore alla versione 4.3 o successiva, sono necessari passaggi aggiuntivi.

Migrazione steps

Quando si esegue l'aggiornamento dalla versione 4.2 o inferiore, è necessario:

1. Eliminare tutti i file del vecchio plugin, che potrebbero trovarsi nelle cartelle Assets/EasyAR, Assets/Plugins, Assets/Samples e Assets/StreamingAssets.
2. Quindi importare la nuova versione tramite la Package Manager window di Unity.
3. Aggiornare le scene e il codice seguendo le guide di migrazione specifiche per ciascuna versione di seguito.

Migrazione alla versione 4000 e successive

La migrazione alla versione 4000 e successive richiede le seguenti modifiche.

Fare riferimento a creazione e configurazione della sessione AR per ricreare la struttura della scena.

Modifiche rilevanti:

• I prefab sono stati rimossi.
• VIOCameraDeviceUnion è stato rimosso.

L'utilizzo di AR Foundation richiede di fare riferimento ad abilitare AR Foundation nei progetti EasyAR per utilizzare AR Foundation.

Modifiche rilevanti:

• Il supporto per AR Foundation è stato reimplementato.

Non è possibile utilizzare EasyAR su dispositivi XREAL X e XREAL Light. Si consiglia di passare a XREAL Air2 Ultra.

Modifiche rilevanti:

• Nreal/XREAL X e Nreal/XREAL Light non sono più supportati.
• Il supporto XREAL è integrato in EasyAR Sense e supporta XREAL Air2 Ultra.

Fare riferimento a migrazione alla versione 4000 per procedere con la migrazione.

La versione 4000 presenta ulteriori cambiamenti rispetto alla 4.x.

Migrazione alla versione 4.6

Avvertenza

La versione 4.6 non è più mantenuta. Si consiglia di aggiornare direttamente alla versione 4000 o successiva. La documentazione completa per lo sviluppo Unity sul sito web di EasyAR è preparata per la versione 4000 e successive.

La migrazione alla versione 4.6 richiede le seguenti modifiche.

Si consiglia di fare riferimento agli esempi della versione 4.6 per comprendere la nuova struttura della scena e ricreare i componenti pertinenti.

Modifiche rilevanti:

• I prefab sono stati rimossi.
• VIOCameraDeviceUnion è stato rimosso.
• Il supporto per AR Foundation è stato separato in un pacchetto indipendente.

Se non è necessario utilizzare AR Foundation, è possibile eliminare il nodo AR Foundation sotto AR Session nella scena e l'utilizzo di ARFoundationFrameSource nel codice.

Modifiche rilevanti:

• Il supporto per AR Foundation è stato separato in un pacchetto indipendente.

Se non è necessario utilizzare Nreal, è possibile eliminare il nodo Nreal sotto AR Session nella scena e l'utilizzo di NrealFrameSource nel codice. Quando si utilizza Nreal, non è più necessario creare un pacchetto virtuale.

Modifiche rilevanti:

• Il supporto per Nreal è stato separato in un pacchetto indipendente.

Si consiglia di fare riferimento alla documentazione delle interfacce negli script e agli esempi della versione 4.6 per comprendere le modifiche e le modalità d'uso delle interfacce, apportando le opportune regolazioni.

Modifiche rilevanti:

• Anche alcune altre interfacce di script sono cambiate.
• Alcuni metodi pubblici sono contrassegnati come internal nei commenti XML e dovrebbero essere evitati. Queste interfacce sono state rimosse nella versione 4000.

Migrazione alla versione 4.4

Avvertenza

La versione 4.4 non è più mantenuta. Si consiglia di aggiornare direttamente alla versione 4000 o successiva. La documentazione completa per lo sviluppo Unity sul sito web di EasyAR è preparata per la versione 4000 e successive.

La migrazione alla versione 4.4 richiede attenzione alle seguenti modifiche.

È necessario eliminare il più possibile i riferimenti ai prefab all'interno del pacchetto del plugin. Se si continua a utilizzare questi prefab, verranno visualizzati log di avviso contenenti brevi indicazioni su come sostituirli nel nuovo plugin. Si consiglia di fare riferimento agli esempi della versione 4.4 per comprendere la nuova struttura della scena.

Modifiche rilevanti:

• I prefab sono stati contrassegnati come obsoleti e rimossi nella versione 4.6.

Eliminare l'utilizzo di VIOCameraDeviceUnion. Se si continua a utilizzare questo componente, verranno visualizzati log di avviso contenenti brevi indicazioni su come sostituirlo nel nuovo plugin. Si consiglia di fare riferimento agli esempi della versione 4.4 per comprendere la nuova struttura della scena.

Modifiche rilevanti:

• VIOCameraDeviceUnion è stato contrassegnato come obsoleto e rimosso nella versione 4.6.

Si consiglia di fare riferimento alla documentazione delle interfacce negli script e agli esempi della versione 4.4 per comprendere le modifiche e le modalità d'uso delle interfacce, apportando le opportune regolazioni.

Modifiche rilevanti:

• Anche alcune altre interfacce di script sono cambiate.
• Alcuni metodi pubblici sono contrassegnati come internal nei commenti XML e dovrebbero essere evitati. Queste interfacce sono state rimosse nella versione 4000.