Configurazione del progetto Unreal Engine

Questa guida descrive in dettaglio le versioni del motore consigliate, gli SDK richiesti e le impostazioni del progetto Android 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 strumenti:

1. Scarica e installa Epic Games Launcher.

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

2. Configura il sistema per compilare il codice C++ (ad esempio, utilizzando Visual Studio 2022 per Windows o Xcode per macOS). Per saperne di più, consulta la configurazione dell'ambiente di sviluppo C++ di Epic.

3. Installa l'SDK.NET 8.0.

4. Installa Android Studio (Panda 4 | 2025.3.4 Patch 1 o versioni successive).

Installare il supporto per la creazione di build Android

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

1. Apri Epic Games Launcher.

2. Fai clic sulla freccia giù accanto alla versione di Engine 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 dei 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:

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

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

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

Creare un progetto Unreal XR

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

1. Avvia Unreal Engine 5.6.1.
2. Nella sezione Nuove categorie di progetti, seleziona il modello Realtà virtuale.
3. Nel menu Impostazioni predefinite progetto, imposta Piattaforma di destinazione su Dispositivi mobili.
4. Imposta Preset qualità su Scalabile per promuovere prestazioni ottimali sull'hardware XR mobile.
5. Scegli un nome per il progetto, quindi fai clic su Crea.

Configurare le impostazioni di Android

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

1. Vai a Modifica > Impostazioni progetto.
2. Vai a Piattaforme > Android.
3. Se il pulsante Accetta licenza SDK è evidenziato in rosso, fai clic.
4. Nella sezione APKPackaging:
   • Imposta Versione minima dell'SDK su 34.
   • Imposta Versione SDK target su 34 (o versioni successive).

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

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

Configurare le impostazioni di rendering

Per ottenere le frequenze dei 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 seleziona Motore > Rendering.

2. Nella sezione Forward Renderer, seleziona Forward Shading.

   Il renderer forward è molto più veloce per la VR mobile rispetto al renderer deferred predefinito. Tieni presente che l'attivazione di questa opzione richiede il riavvio dell'editor e la compilazione degli shader.

3. Nella sezione Impostazioni predefinite, imposta Metodo anti-aliasing su MSAA.

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

   MSAA offre i risultati più nitidi per la VR senza gli effetti di sfocatura causati dall'anti-aliasing temporale (TAA).

5. Nella sezione VR:

   1. Deseleziona HDR mobile.

      La disattivazione della tecnologia 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'unica passata, migliorando notevolmente le prestazioni della CPU.

Vedi anche

Per istruzioni dettagliate sul deployment di un progetto modello su un dispositivo Android, consulta Configurazione dei progetti Unreal Engine per lo sviluppo per Android.