Abilitare AR Foundation nei progetti EasyAR
Per abilitare il supporto AR Foundation di EasyAR o utilizzare altre funzionalità di AR Foundation, è necessario installare e configurare correttamente AR Foundation. Di seguito viene spiegato come eseguire queste operazioni.
Prima di iniziare
- Leggere Supporto di EasyAR per i framework XR di Unity per comprendere il supporto di EasyAR per i framework XR di Unity e quando considerare l'utilizzo di AR Foundation.
Compatibilità delle versioni di AR Foundation
EasyAR supporta AR Foundation 5 o versioni successive.
Importante
Il supporto ad AR Foundation è implementato tramite una fotocamera personalizzata.
Quando si utilizzano prodotti in prova (come licenze personali, licenze XR di prova o servizi Mega di prova) su fotocamere personalizzate o dispositivi di visualizzazione, EasyAR Sense smetterà di rispondere dopo 100 secondi dall'avvio (gli utenti Mega possono richiedere a EasyAR Business di modificare questa durata previa approvazione). L'utilizzo della versione a pagamento di EasyAR Sense e del servizio EasyAR Mega a pagamento non presenta questa limitazione.
Installare AR Foundation
Si consiglia di fare riferimento alla documentazione ufficiale di AR Foundation per installare AR Foundation. Prima di leggere, prestare attenzione a selezionare la versione corrispondente della documentazione.
Unity 2022 e versioni successive
Se nel progetto non sono installati plugin XR, è necessario andare in Project Settings > XR Plug-in Management e cliccare sul pulsante Install XR Plugin Management per installare XR Plug-in Management e attendere il completamento dell'installazione.
Se si desidera utilizzare AR Foundation sulla piattaforma Android, nella scheda Android selezionare Google ARCore e attendere il completamento dell'installazione.
Se si desidera utilizzare AR Foundation sulla piattaforma iOS, nella scheda iOS selezionare Apple ARKit e attendere il completamento dell'installazione.
Se si desidera utilizzare AR Foundation sulla piattaforma visionOS, è necessario leggere Configurazione del progetto per Vision Pro.
Consiglio
Si consiglia di mantenere Initialize XR On Startup selezionato per garantire che AR Foundation venga inizializzato al momento predefinito.
Dopo l'installazione, aprire la finestra Package Manager per visualizzare AR Foundation e i plugin delle piattaforme corrispondenti nell'elenco dei pacchetti installati. Assicurarsi che i numeri di versione di questi pacchetti siano esattamente identici.
Importante
Durante l'installazione e l'aggiornamento di AR Foundation, è necessario assicurarsi che le versioni di Google ARCore XR Plugin e Apple ARKit XR Plugin corrispondano esattamente alla versione di AR Foundation. Versioni non corrispondenti potrebbero causare errori runtime o malfunzionamenti.
Unity 2021
Nella versione Unity 2021, è necessario modificare manualmente il file Packages/manifest.json per specificare la versione, fare riferimento alla documentazione ufficiale.
Ad esempio, per installare la versione 5.2.0 di AR Foundation e utilizzarla sulle piattaforme Android e iOS, assicurarsi che il file Packages/manifest.json contenga quanto segue:
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
Configurare XR Plug-in
Quando si utilizza EasyAR, la presenza di ARCore non è solitamente necessaria. Pertanto, è necessario configurare ARCore come opzionale per evitare che l'applicazione non funzioni correttamente su dispositivi non supportati.
In Project Settings > XR Plug-in Management > ARCore, impostare sia Requirement che Depth su Optional
Attenzione
Se si imposta Requirement su Required e si installa l'applicazione compilata su un dispositivo non supportato, il dispositivo segnalerà erroneamente che ARCore è disponibile e funzionerà con ARCore. Ciò creerà l'illusione che questi dispositivi stiano eseguendo ARCore in modo anomalo (schermo nero o altri comportamenti anomali), ma ciò è errato.
Questo fenomeno si verifica perché Google Play Store impedisce l'installazione di app che richiedono ARCore su dispositivi non supportati, quindi queste app presuppongono sempre di essere eseguite su dispositivi supportati.
In una configurazione normale, questi dispositivi determineranno durante la creazione della sessione che ARCore non è supportato e utilizzeranno le funzionalità di EasyAR.
Se necessario, è possibile fare riferimento alla seguente documentazione ufficiale per ulteriori configurazioni di ARCore e ARKit. Prima di leggere, prestare attenzione a selezionare la versione corrispondente della documentazione.
Configurare Universal Render Pipeline
Se il progetto corrente utilizza URP, è necessario configurare gli asset URP. Se non configurati correttamente, l'immagine di fondo della fotocamera AR Foundation potrebbe non essere renderizzata correttamente.
Innanzitutto, assicurarsi di aver configurato correttamente il Renderer Feature URP di EasyAR, fare riferimento a Configurazione di Universal Render Pipeline per EasyAR.
Quindi, aggiungere ARBackgroundRendererFeature all'elenco dei Renderer Features
Come per la configurazione del Renderer Feature URP di EasyAR, è necessario verificare le configurazioni per diverse piattaforme in Project Settings > Quality, assicurandosi che su tutte le piattaforme in cui si desidera utilizzare AR Foundation venga utilizzato un asset URP configurato correttamente con ARBackgroundRendererFeature.
In alternativa, è possibile fare riferimento alla documentazione ufficiale di configurazione URP di AR Foundation per la configurazione. Prima di leggere, prestare attenzione a selezionare la versione corrispondente della documentazione.
Nota
La Configurazione di Universal Render Pipeline per EasyAR è comunque necessaria per garantire che le funzionalità di rendering correlate alle interfacce EasyAR funzionino correttamente anche su dispositivi non supportati da AR Foundation.
Abilitare il supporto AR Foundation di EasyAR
In Project Settings > EasyAR > Sense, assicurarsi che l'opzione Unity XR > AR Foundation Support sia abilitata. Questa opzione è abilitata per impostazione predefinita.
La modifica di questa opzione attiva la ricompilazione degli script; è necessario attendere il completamento della compilazione affinché le modifiche abbiano effetto. Se Unity non avvia correttamente la compilazione per qualche motivo, è possibile chiudere Unity ed eliminare la cartella Library/ScriptAssemblies per forzare Unity a ricompilare gli script.
Consiglio
Se EasyAR non è compatibile con AR Foundation nel progetto e non è necessario utilizzare contemporaneamente EasyAR e AR Foundation, è possibile disabilitare questa opzione.
Passaggi successivi
- Scoprire Configurazione e utilizzo della scena AR Foundation nei progetti EasyAR
- Scoprire come Passare automaticamente ad AR Foundation in base al supporto del dispositivo