Configurazione e utilizzo della scena AR Foundation in un progetto EasyAR
Quando si utilizza AR Foundation in Unity, spesso è necessario affidarsi a EasyAR per superare le limitazioni dei dispositivi di AR Foundation. Di seguito viene spiegato come configurare e utilizzare correttamente AR Foundation in una scena EasyAR e come abilitare dinamicamente AR Foundation in base al supporto del dispositivo.
Prima di iniziare
- Leggere Supporto di EasyAR per il framework XR di Unity per comprendere il supporto di EasyAR per il framework XR di Unity e quando considerare l'utilizzo di AR Foundation.
- Leggere Abilitare AR Foundation in un progetto EasyAR per sapere come installare e configurare AR Foundation in un progetto EasyAR.
Aggiungere i componenti AR Foundation
Aggiungere AR Session e XR Origin di AR Foundation alla scena EasyAR.
Aggiungere AR Session
Nella vista Hierarchy, fare clic con il tasto destro in uno spazio vuoto, quindi selezionare XR > AR Session dal menu per aggiungere ARSession di Unity alla scena.
Nota
Questa AR Session è diversa da quella di EasyAR; entrambe devono coesistere nella scena.
Aggiungere XR Origin
Nella vista Hierarchy, fare clic con il tasto destro in uno spazio vuoto, quindi selezionare XR > XR Origin (Mobile AR) dal menu per aggiungere XROrigin di Unity alla scena.
Nota
Questa XR Origin si sovrappone alla funzionalità di XR Origin di EasyAR; è necessario utilizzare XR Origin di Unity anziché quella di EasyAR.
Se nella scena è presente XR Origin di EasyAR, generalmente denominata XR Origin (EasyAR), spostare gli oggetti figlio sotto la nuova XR Origin, quindi eliminare XR Origin (EasyAR).
Se sotto la nuova XR Origin non è presente un XR Origin Child, aggiungerlo manualmente.
Nella vista Hierarchy, selezionare XR Origin, fare clic con il tasto destro e selezionare EasyAR Sense > Origin > Origin : XR Origin Child dal menu per aggiungere XR Origin Child sotto XR Origin.
Configurare la camera
Se nella scena è presente una Camera per AR, potrebbe apparire una fotocamera principale ridondante; eliminare la fotocamera originale.
Quindi selezionare Main Camera sotto XR Origin e configurarla seguendo le istruzioni in Configurazioni della camera.
Alla fine, una scena EasyAR completa con AR Foundation aggiunta dovrebbe avere una struttura simile a questa:
Attenzione
Se si modifica la configurazione di AR Foundation tramite ARCameraManager.currentConfiguration, notare che alcuni telefoni (come Xiaomi 10) hanno problemi: dopo la modifica, non è possibile ottenere immagini e EasyAR diventa inutilizzabile (l'app ha uno sfondo ma nessuna reazione dalle funzioni EasyAR). Pertanto, generalmente non è consigliato modificarla; se necessario, preparare un piano di ripiego per quando EasyAR non funziona.
Compatibilità del dispositivo e abilitazione dinamica di AR Foundation
EasyAR supporta molti più dispositivi di AR Foundation, quindi è necessario configurare l'applicazione per abilitare AR Foundation solo quando necessario, disattivandola completamente negli altri casi.
Verificare i componenti frame source
Generalmente, la sessione creata tramite il menu EasyAR aggiunge automaticamente ARCoreARFoundationFrameSource e ARKitARFoundationFrameSource (tranne per funzioni come il tracciamento immagine che non richiedono SLAM).
Importante
ARCoreARFoundationFrameSource e ARKitARFoundationFrameSource sono frame source forniti da EasyAR per abilitare la funzionalità AR Foundation sui dispositivi supportati. Se la sessione nella scena non include questi frame source, non sarà possibile abilitare la funzionalità AR Foundation.
Se la sessione nella scena non include questi frame source, aggiungerli manualmente tramite il menu.
Per eseguire su telefoni non supportati da AR Foundation, assicurarsi che la sessione includa frame source diversi da AR Foundation. Una ARSession tipica dovrebbe essere simile a questa:
Consiglio
È possibile ordinare i frame source in base alle esigenze; durante l'esecuzione, la sessione selezionerà il primo frame source disponibile in base all'ordine di trasformazione e al supporto del dispositivo.
Abilitare AR Foundation solo quando necessario
Poiché l'implementazione sottostante di AR Foundation su telefoni è ARCore e ARKit, utilizzabili solo su dispositivi limitati (specialmente su molti telefoni Android cinesi), si consiglia di abilitare AR Foundation e gli script correlati solo sui dispositivi supportati.
EasyAR può automatizzare queste operazioni tramite l'opzione Unity XR > Unity XR Auto Switch in Project Settings > EasyAR > Sense. Per dettagli, consultare Attivazione/disattivazione automatica degli oggetti Unity XR.
Mantenere la compatibilità della scena con AR Foundation
Una scena configurata correttamente con i componenti AR Foundation funzionerà sia con il pacchetto AR Foundation installato che non installato.
Quando AR Foundation non è installato, le sue funzionalità e i frame source corrispondenti non sono disponibili e nella scena mancheranno alcuni script, il che è normale.
Consiglio
Molti sample funzionano sia con che senza il pacchetto AR Foundation installato. Per abilitare il supporto AR Foundation in questi sample, è sufficiente Abilitare AR Foundation in un progetto EasyAR.
Passi successivi
- Scoprire come Attivare/disattivare automaticamente AR Foundation in base al supporto del dispositivo
Argomenti correlati
- Componenti AR menzionati:
- AR Foundation fornisce capacità di tracciamento del movimento su alcuni dispositivi; per la relazione tra tracciamento del movimento e funzionalità EasyAR, consultare:
- Per maggiori informazioni sulla configurazione della scena AR Foundation, leggere la documentazione ufficiale di AR Foundation, selezionando la versione corrispondente: