Configurer l'aperçu direct pour 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 →

La fonctionnalité d'aperçu direct vous permet de tester et d'itérer des interactions complexes directement dans Unreal Editor à l'aide de données en direct provenant de l'appareil Android XR. Avec l'aperçu direct, la machine hôte affiche et débogue le contenu, diffuse la fenêtre d'affichage visuelle directement sur votre appareil Android XR physique et renvoie les extensions OpenXR compatibles à l'hôte en temps réel.

Suivez ce guide pour configurer l'aperçu direct pour votre projet dans Unreal Engine.

Prérequis

Avant de commencer, assurez-vous que votre environnement de développement répond aux exigences suivantes :

• Version d'Unreal Engine : Unreal Engine 5.6.x ou 5.8.x.
• Configuration du projet : suivez toutes les étapes du guide Configuration d'un projet Unreal Engine.

• Android XR Engine Hub : suivez toutes les étapes de la section Premiers pas du guide Android XR Engine Hub pour installer et configurer votre machine hôte pour Direct Preview.

• Matériel :

  • Utilisez une machine hôte exécutant Windows 11.
  • Utilisez une carte graphique moderne compatible avec l'encodage vidéo Vulkan.
  Important : Installez la dernière version des pilotes de votre GPU avant de vérifier toutes ses fonctionnalités Vulkan.

Configurer les plug-ins Android XR

Configurez Unreal Engine avec les plug-ins Android XR requis :

1. Suivez les étapes du guide de démarrage rapide des extensions Android XR pour Unreal Engine.

   Plus tard, si vous créez un projet ou ouvrez un projet que vous n'avez pas utilisé avec l'aperçu direct, suivez à nouveau ces mêmes étapes.

2. Pour chaque projet, assurez-vous qu'il dispose d'un lien symbolique vers le dossier des plug-ins du fournisseur.

Configurer les paramètres du projet

Configurez les paramètres de votre projet pour le streaming Direct Preview :

1. Accédez à Project Settings > Platforms > Windows (Paramètres du projet > Plates-formes > Windows).
2. Pour RHI à Vulkan.
3. Accédez à Edit > Plugins (Modifier > Plug-ins).
4. Activez le plug-in AndroidXRStreaming.
5. Accédez à Edit > Project Settings > Description (Modifier > Paramètres du projet > Description).
6. Activez Démarrer en RV.

Activer l'environnement d'exécution de streaming

Maintenant que le plug-in AndroidXRStreaming est activé pour le projet, vérifiez si l'environnement d'exécution Android XR Streaming est présent :

1. Accédez à Project Settings > Plugins > AndroidXRStreaming (Paramètres du projet > Plug-ins > AndroidXRStreaming).

2. Cliquez sur Enable AndroidXR Streaming (Activer le streaming AndroidXR).

   

   Remarque : Pour ce faire, définissez une variable d'environnement basée sur la session pour le processus Unreal Engine. Il n'est donc pas nécessaire de modifier les entrées de registre, même si plusieurs environnements d'exécution sont présents sur la machine.

3. Redémarrez Unreal Engine pour appliquer ces modifications.

Configurer le client de streaming

Configurez le client de streaming avec différentes options pour votre projet :

1. Accédez à Project Settings > Plugins (Paramètres du projet > Plug-ins).

2. Dans la section AndroidXRStreamingClient, examinez chacune des options suivantes, puis activez-les ou désactivez-les en fonction des besoins de votre projet :

   • Auto Start Client On Preview (Démarrage automatique du client lors de l'aperçu) : lorsque cette option est activée, l'application cliente d'aperçu est lancée sur n'importe quel appareil valide sélectionné lorsque vous cliquez sur Start VR Preview (Démarrer l'aperçu RV) dans l'éditeur.
   • Auto Stop Client On Preview (Arrêt automatique du client lors de l'aperçu) : lorsque cette option est activée, le client d'aperçu est arrêté lorsque l'aperçu RV de l'éditeur est arrêté.
   • Sélectionner automatiquement un appareil compatible : lorsque cette option est activée, elle sélectionne automatiquement le premier appareil compatible connecté à la machine lors de la recherche d'appareils.
   • Afficher les boîtes de dialogue d'erreur : lorsque cette option est activée, des boîtes de dialogue d'erreur supplémentaires s'affichent (par exemple, une boîte de dialogue d'erreur s'affiche si vous essayez de lancer un aperçu RV sans sélectionner d'appareil client). Désactivez cette option pour masquer ces boîtes de dialogue.
   • Actualiser : lorsque cette option est activée, le bouton Actualiser recherche les appareils connectés et liste ceux qui sont compatibles (en fonction de la présence de l'application cliente Direct Preview dans Android XR Engine Hub).

Démarrer l'aperçu en direct

Démarrez l'aperçu direct pour diffuser directement depuis Unreal Engine :

1. Connectez votre appareil Android XR à votre ordinateur hôte à l'aide d'un câble USB-C de haute qualité.

   Remarque : Vous devez activer les options pour les développeurs et le débogage sur l'appareil Android XR pour que votre machine hôte puisse envoyer des commandes ADB (Android Debug Bridge).

2. Si vous n'avez jamais utilisé cet appareil avec l'aperçu direct, connectez-le et configurez-le pour l'aperçu direct dans Android XR Engine Hub avant de lancer l'aperçu direct via votre moteur de jeu.

3. Dans Unreal Editor, cliquez sur Play level in VR (Lire le niveau en RV). N'utilisez pas l'option habituelle Play in Editor (Lire dans l'éditeur) lorsque vous démarrez Direct Preview.