Configurazione del progetto Unreal Engine

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Scopri di più sui tipi di dispositivi XR →
Visori XR
Occhiali XR con cavo
Scopri di più sui tipi di dispositivi XR →

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

  1. Scarica e installa Epic Games Launcher.

    1. Da Epic Games Launcher, installa la versione 5.6.x o 5.8.x di Unreal Engine.

  2. Configura il sistema per creare 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 (Rabbit 2 | 2026.2.2 o versioni successive).

Installa il supporto per la 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 l'Avvio applicazioni di Epic Games.

  2. Fai clic sulla freccia menu a discesa accanto alla versione di Engine installata (pulsante Avvia) e fai clic su Opzioni.

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

  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

Crea un progetto Unreal XR

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

  1. Avvia Unreal Engine (versione 5.6.x o 5.8.x).
  2. In New Project Categories (Nuove categorie di progetti), seleziona il modello Virtual Reality (Realtà virtuale).
  3. Nel menu Project Defaults (Impostazioni predefinite del progetto), imposta Target Platform (Piattaforma di destinazione) su Mobile (Dispositivo mobile).
  4. Imposta Quality Preset (Preset qualità) su Scalable (Scalabile) per promuovere prestazioni ottimali sull'hardware XR mobile.
  5. Scegli un nome per il progetto, quindi fai clic su Crea.

Configura le impostazioni 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 Edit > Project Settings.
  2. Vai a Platforms > Android (Piattaforme > Android).
  3. Se il pulsante Accetta licenza SDK è evidenziato in rosso, fai clic.
  4. Nella sezione APKPackaging:
    • Imposta Versione SDK minima su 34.
    • Imposta Versione SDK target 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.

Configura 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 Edit > Project Settings e poi a Engine > Rendering.

  2. Nella sezione Forward Renderer, seleziona Forward Shading.

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

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

  4. Nella sezione Dispositivi mobili, imposta MSAA per dispositivi mobili su 4x.

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

  5. Nella sezione VR:

    1. HDR mobile nitido.

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

    2. Seleziona Multiview 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 sul deployment di un progetto modello su un dispositivo Android, consulta Configurazione dei progetti Unreal Engine per lo sviluppo Android.