Configurer l'aperçu direct pour Unreal Engine

Appareils XR concernés

Ces conseils vous aident à 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 →

L'aperçu direct vous permet de tester et d'itérer des interactions complexes directement dans l'éditeur Unreal à 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.1 ou version ultérieure.
• Configuration du projet : suivez toutes les étapes du guide de configuration du 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 l'aperçu direct.

• Matériel :

  • Utilisez une machine hôte exécutant Windows 11.
  • Utilisez une carte graphique moderne compatible avec l'encodage vidéo Vulkan.
  Important : Mettez à jour les pilotes de votre GPU vers leurs dernières versions 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 de l'aperçu direct :

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

Activer le runtime de streaming

Maintenant que le plug-in AndroidXRStreaming est activé pour le projet, vérifiez si le runtime Android XR Streaming est présent :

1. Accédez à Project Settings > Plugins > AndroidXRStreaming.

2. Cliquez sur Activer la diffusion AndroidXR.

   

   Remarque : Cette méthode fonctionne en définissant une variable d'environnement basée sur la session pour le processus Unreal Engine. Vous n'avez donc pas besoin de modifier les entrées de registre, même si plusieurs runtimes 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 et activez ou désactivez-les en fonction de ce dont vous avez besoin pour votre projet :

   • Démarrer automatiquement le client en mode Aperçu : lorsque cette option est activée, l'application cliente d'aperçu se lance sur tout appareil valide sélectionné lorsque vous cliquez sur Démarrer l'aperçu VR dans l'éditeur.
   • Arrêt automatique du client en mode Aperçu : lorsqu'il est activé, le client d'aperçu se ferme lorsque l'aperçu VR de l'éditeur est arrêté.
   • Sélection automatique de l'appareil compatible : lorsqu'elle est activée, cette option sélectionne automatiquement le premier appareil compatible connecté à la machine lors de la recherche d'appareils.
   • Afficher les boîtes de dialogue d'erreur : lorsqu'elle est activée, cette option affiche des boîtes de dialogue d'erreur supplémentaires (par exemple, une boîte de dialogue d'erreur s'affiche si vous essayez de démarrer un aperçu VR 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 (déterminés par la présence de l'application cliente Aperçu direct dans le hub Android XR Engine).

Lancer l'aperçu direct

Lancez l'aperçu direct pour diffuser du contenu directement depuis Unreal Engine :

1. Connectez votre appareil Android XR à votre machine 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 le hub Android XR Engine avant de lancer l'aperçu direct via votre moteur de jeu.

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