Configurazione del progetto Unreal Engine

Questa guida descrive in dettaglio le versioni del motore, gli SDK richiesti e le impostazioni del progetto Android consigliate durante lo sviluppo di un'app Unreal Engine per Android XR.

Prerequisiti

Prima di poter configurare Unreal Engine per lo sviluppo di Android XR, devi installare le seguenti applicazioni e i seguenti strumenti:

1. Scarica e installa il Epic Games Launcher.

   1. Da Epic Games Launcher, installa la versione 5.6.1 (o successive) di Unreal Engine.

2. Configura il sistema per creare codice C++ (ad esempio, utilizzando Visual Studio 2022 per Windows o Xcode per macOS). Per ulteriori informazioni, vedi Configurazione dell'ambiente di sviluppo C++ di Epic.

3. Installa l'SDK.NET 8.0.

4. Installa Android Studio (Quail 2 | 2026.1.2 o versioni successive).

Installare il supporto per la build di Android

Poiché Android XR si basa su versioni specifiche dell'SDK, devi installare gli strumenti di build di Android corretti insieme a Unreal Engine.

1. Apri Epic Games Launcher.

2. Fai clic sulla freccia del menu a discesa accanto alla versione del motore installata (pulsante Avvia) e poi su Opzioni.

   1. Scorri fino alle opzioni di installazione, seleziona Android e fai clic su Applica.
   2. Se richiesto, consenti al motore di registrare le estensioni di file necessarie.

3. Installa Java JDK 17.

4. In Android Studio, utilizza SDK Manager per installare le seguenti versioni specifiche richieste dagli esempi di Android XR:

   • SDK Platforms: 34, 35 e 36
   • NDK: 29.0.x
   • Strumenti a riga di comando (tutti gli elementi)

5. Segui la guida di Epic Configurazione avanzata e risoluzione dei problemi per configurare le seguenti variabili di ambiente di sistema:

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

Creare un progetto Unreal XR

Poi, crea un nuovo progetto e configuralo con i plug-in e gli input XR necessari:

1. Avvia Unreal Engine 5.6.1.
2. In New Project Categories, seleziona il modello Virtual Reality.
3. Nel menu Project Defaults, imposta Target Platform su Mobile.
4. Imposta Quality Preset su Scalable per promuovere prestazioni ottimali sull'hardware XR mobile.
5. Scegli un nome per il progetto e fai clic su Crea.

Configurare le impostazioni di Android

Dopo aver aperto il progetto, completa questi passaggi per impostare i livelli API Android e le impostazioni grafiche richieste per Android XR:

1. Vai a Modifica > Impostazioni progetto.
2. Vai a Piattaforme > Android.
3. Se il pulsante Accept SDK License è evidenziato in rosso, fai clic su di esso.
4. Nella sezione APKPackaging :
   • Imposta Minimum SDK Version su 34.
   • Imposta Target SDK Version su 34 (o versioni successive).

5. Scorri fino alla sezione Build e seleziona Support Vulkan.

   Vulkan è l'API grafica consigliata e ad alte prestazioni per Android XR.

Configurare le impostazioni di rendering

Per ottenere le frequenze fotogrammi elevate e la nitidezza visiva richieste per Android XR, devi anche configurare Unreal Engine in modo che utilizzi il percorso di rendering mobile ottimizzato:

1. Vai a Modifica > Impostazioni progetto e poi a Motore > Rendering.

2. Nella sezione Forward Renderer, seleziona Forward Shading.

   Il renderer di inoltro è notevolmente più veloce per la realtà virtuale mobile rispetto al renderer differito predefinito. Tieni presente che l'attivazione di questa opzione richiede il riavvio dell'editor e la compilazione degli shader.

3. Nella sezione Default Settings, imposta Anti-Aliasing Method su MSAA.

4. Nella sezione Mobile, imposta Mobile MSAA su 4x.

   MSAA fornisce i risultati più nitidi per la realtà virtuale senza gli effetti di sfocatura causati da Temporal AA (TAA).

5. Nella sezione VR:

   1. Deseleziona Mobile HDR.

      La disattivazione di High Dynamic Range sui dispositivi mobili riduce drasticamente l'overhead di post-elaborazione.

   2. Seleziona Visualizzazione multipla mobile.

      In questo modo, il motore può eseguire il rendering di entrambi gli occhi in un unico passaggio, migliorando notevolmente le prestazioni della CPU.

Vedi anche

Per istruzioni dettagliate su come eseguire il deployment di un progetto modello su un dispositivo con Android, consulta Configurare i progetti Unreal Engine per lo sviluppo di Android development.