Migrare applicazioni Unity da EasyAR Sense Unity Plugin 4.2 e versioni precedenti

A partire dalla versione 4.3, il plugin Unity viene distribuito e gestito tramite Unity Package Manager, e la struttura del pacchetto del plugin è stata modificata in modo significativo. Pertanto, quando si esegue l'aggiornamento dalla 4.2 o versioni precedenti alla 4.3 o versioni successive, sono necessari alcuni passaggi aggiuntivi.

Passaggi di migrazione

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

1. Eliminare tutti i file del vecchio plugin. Questi file possono 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 scene e codice secondo le guide di migrazione per ciascuna versione riportate di seguito.

Migrare a 4000 e versioni successive

La migrazione a 4000 e versioni successive richiede le seguenti modifiche.

Consultare Creare e configurare AR session per ricreare la struttura della scena.

Modifiche correlate:

• prefab è stato rimosso.
• VIOCameraDeviceUnion è stato rimosso.

Per usare AR Foundation, consultare Abilitare AR Foundation in un progetto EasyAR.

Modifiche correlate:

• Il supporto AR Foundation è stato reimplementato.

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

Modifiche correlate:

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

Consultare Migrare a 4000 per il lavoro di migrazione successivo.

La versione 4000 presenta più modifiche rispetto a 4.x.

Migrare alla versione 4.6

Avvertenza

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

La migrazione alla versione 4.6 richiede le seguenti modifiche.

Si consiglia di consultare gli esempi della versione 4.6 per comprendere la nuova struttura della scena e ricreare i componenti correlati.

Modifiche correlate:

• prefab è stato rimosso.
• VIOCameraDeviceUnion è stato rimosso.
• Il supporto AR Foundation è stato separato in un package indipendente.

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

Modifiche correlate:

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

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

Modifiche correlate:

• Il supporto Nreal è stato separato in un package indipendente.

Si consiglia di consultare la documentazione API negli script e gli esempi della versione 4.6 per comprendere le modifiche API e l'uso, quindi apportare gli adeguamenti necessari.

Modifiche correlate:

• Anche alcune altre API degli script sono cambiate.
• Alcuni metodi pubblici sono contrassegnati come internal nei commenti XML. Evitare di usare queste API. Sono state eliminate nella versione 4000.

Migrare alla versione 4.4

Avvertenza

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

Quando si migra alla versione 4.4, prestare attenzione alle seguenti modifiche.

Rimuovere il più possibile i riferimenti ai prefab all'interno del pacchetto del plugin. Se si continua a usare questi prefab, verranno visualizzati log di avviso, che contengono una breve guida su come sostituirli nel nuovo plugin. Si consiglia di consultare gli esempi della versione 4.4 per comprendere la nuova struttura della scena.

Modifiche correlate:

• prefab è stato contrassegnato come obsoleto ed eliminato nella versione 4.6.

Rimuovere l'uso di VIOCameraDeviceUnion. Se si continua a usare questo componente, verranno visualizzati log di avviso, che contengono una breve guida su come sostituirlo nel nuovo plugin. Si consiglia di consultare gli esempi della versione 4.4 per comprendere la nuova struttura della scena.

Modifiche correlate:

• VIOCameraDeviceUnion è stato contrassegnato come obsoleto ed eliminato nella versione 4.6.

Si consiglia di consultare la documentazione API negli script e gli esempi della versione 4.4 per comprendere le modifiche API e l'uso, quindi apportare gli adeguamenti necessari.

Modifiche correlate:

• Anche alcune altre API degli script sono cambiate.
• Alcuni metodi pubblici sono contrassegnati come internal nei commenti XML. Evitare di usare queste API. Sono state eliminate nella versione 4000.