Configurer un projet Unreal Engine

Appareils XR concernés
Ces conseils vous aideront à créer des expériences pour ces types d'appareils XR.
En savoir plus sur les types d'appareils XR →
Casques XR
Lunettes XR filaires
En savoir plus sur les types d'appareils XR →

Ce guide détaille les versions de moteur recommandées, les SDK requis et les paramètres de 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. Depuis le lanceur Epic Games, installez la version 5.6.x ou 5.8.x d'Unreal Engine.

  2. Configurez votre système pour compiler du code C++ (par exemple, à l'aide de Visual Studio 2022 pour Windows ou de 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 (Rabbit 2 | 2026.2.2 ou version ultérieure).

Installer la compatibilité avec les builds Android

Comme Android XR repose sur des versions spécifiques du SDK, vous devez installer les outils de compilation Android appropriés avec Unreal Engine.

  1. Ouvrez le lanceur Epic Games.

  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 SDK Manager pour installer les versions spécifiques suivantes requises par les exemples Android XR :

    • SDK Platforms : 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

Ensuite, créez un projet et configurez-le avec les plug-ins et les entrées XR nécessaires :

  1. Lancez Unreal Engine (version 5.6.x ou 5.8.x).
  2. Sous New Project Categories (Nouvelles catégories de projets), sélectionnez le modèle Virtual Reality (Réalité virtuelle).
  3. Dans le menu Project Defaults (Paramètres par défaut du projet), définissez Target Platform (Plate-forme cible) sur Mobile.
  4. Définissez le préréglage de qualité sur É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, procédez comme suit 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 à Platforms > Android (Plates-formes > Android).
  3. Si le bouton Accept SDK License (Accepter la licence du SDK) est surligné 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 une version ultérieure).

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

    Vulkan est l'API graphique hautes performances recommandée 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 à Engine > Rendering (Moteur > Rendu).

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

    Le moteur de rendu direct est nettement plus rapide pour la RV 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 une compilation des nuanceurs.

  3. Dans la section Default Settings (Paramètres par défaut), définissez Anti-Aliasing Method (Méthode d'anticrénelage) sur MSAA.

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

    Le MSAA fournit les résultats les plus nets pour la RV, sans les effets de flou causés par le TAA (Temporal Anti-Aliasing).

  5. Dans la section RV :

    1. Effacez HDR mobile.

      La désactivation de la technologie HDR (High Dynamic Range) sur mobile réduit considérablement les coûts de post-traitement.

    2. Sélectionnez Multivue mobile.

      Cela permet au moteur d'afficher 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.