Configurer un projet Unreal Engine

Ce guide décrit en détail les versions de moteur recommandées, les SDK requis et les paramètres du projet Android lors du développement d'une application Unreal Engine pour Android XR.

Prérequis

Avant de pouvoir configurer Unreal Engine pour le développement Android XR, vous devez installer les applications et outils suivants :

1. Téléchargez et installez le lanceur Epic Games.

   1. Dans Epic Games Launcher, installez la version 5.6.1 (ou ultérieure) d'Unreal Engine.

2. Configurez votre système pour compiler du code C++ (par exemple, en utilisant Visual Studio 2022 pour Windows ou Xcode pour macOS). Pour en savoir plus, consultez la page Configuration de l'environnement de développement C++ d'Epic.

3. Installez le SDK.NET 8.0.

4. Installez Android Studio (Quail 4 | 2026.1.4 ou version ultérieure).

Installer la prise en charge de la compilation Android

Étant donné qu'Android XR repose sur des versions spécifiques du SDK, vous devez installer les outils de compilation Android appropriés en même temps qu'Unreal Engine.

1. Ouvrez l'Epic Games Launcher.

2. Cliquez sur la flèche du menu déroulant à côté de la version du moteur installée (bouton "Lancer"), puis sur Options.

   1. Faites défiler la page jusqu'aux options d'installation, sélectionnez Android, puis cliquez sur Appliquer.
   2. Si vous y êtes invité, autorisez le moteur à enregistrer les extensions de fichier dont il a besoin.

3. Installez Java JDK 17.

4. Dans Android Studio, utilisez le SDK Manager pour installer les versions spécifiques suivantes requises par les exemples Android XR :

   • Plates-formes SDK : 34, 35 et 36
   • NDK : 29.0.x
   • Outils de ligne de commande (tous les éléments)

5. Suivez le guide de configuration avancée et de dépannage d'Epic pour configurer les variables d'environnement système suivantes :

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

Créer un projet Unreal XR

Créez ensuite un projet et configurez-le avec les plug-ins et les entrées XR nécessaires :

1. Lancez Unreal Engine 5.6.1.
2. Sous Nouvelles catégories de projets, sélectionnez le modèle Réalité virtuelle.
3. Dans le menu Paramètres par défaut du projet, définissez Plate-forme cible sur Mobile.
4. Définissez le préréglage de qualité sur Scalable (Évolutif) pour optimiser les performances sur le matériel XR mobile.
5. Choisissez un nom de projet, puis cliquez sur Créer.

Configurer les paramètres Android

Une fois votre projet ouvert, suivez ces étapes pour définir les niveaux d'API Android et les paramètres graphiques requis pour Android XR :

1. Accédez à Edit > Project Settings (Modifier > Paramètres du projet).
2. Accédez à Plates-formes > Android.
3. Si le bouton Accepter la licence du SDK est mis en surbrillance en rouge, cliquez dessus.
4. Dans la section APKPackaging :
   • Définissez Minimum SDK Version (Version minimale du SDK) sur 34.
   • Définissez Target SDK Version (Version du SDK cible) sur 34 (ou version ultérieure).

5. Faites défiler la page jusqu'à la section Build (Compilation), puis sélectionnez Support Vulkan (Compatibilité avec Vulkan).

   Vulkan est l'API graphique recommandée et très performante pour Android XR.

Configurer les paramètres de rendu

Pour obtenir les fréquences d'images élevées et la clarté visuelle requises pour Android XR, vous devez également configurer Unreal Engine pour qu'il utilise le chemin de rendu mobile optimisé :

1. Accédez à Edit > Project Settings (Modifier > Paramètres du projet), puis accédez à Engine > Rendering (Moteur > Rendu).

2. Dans la section Forward Renderer (Rendu direct), sélectionnez Forward Shading (Ombrage direct).

   Le moteur de rendu direct est beaucoup plus rapide pour la VR mobile que le moteur de rendu différé par défaut. Notez que l'activation de cette option nécessite un redémarrage de l'éditeur et la compilation des nuanceurs.

3. Dans la section Paramètres par défaut, définissez Méthode d'anticrénelage sur MSAA.

4. Dans la section Mobile, définissez MSAA mobile sur 4x.

   MSAA offre les résultats les plus nets pour la VR sans les effets de flou causés par l'AA temporelle (TAA).

5. Dans la section VR :

   1. Désélectionnez HDR mobile.

      La désactivation de la plage dynamique élevée sur mobile réduit considérablement la surcharge de post-traitement.

   2. Sélectionnez mode Multivue mobile.

      Cela permet au moteur de rendre les deux yeux en une seule passe, ce qui améliore considérablement les performances du processeur.

Voir aussi

Pour obtenir des instructions détaillées sur le déploiement d'un projet de modèle sur un appareil Android, consultez Configurer des projets Unreal Engine pour le développement Android.