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 diffuse les extensions OpenXR compatibles vers 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.
Configurer les plug-ins Android XR
Configurez Unreal Engine avec les plug-ins Android XR requis :
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 en ouvrez un que vous n'avez pas utilisé avec l'aperçu direct, suivez à nouveau ces mêmes étapes.
Pour chaque projet, assurez-vous qu'il comporte 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 d'aperçu direct :
- Accédez à Project Settings > Platforms > Windows (Paramètres du projet > Plates-formes > Windows).
- Pour RHI , sélectionnez Vulkan.
- Accédez à Edit > Plugins (Modifier > Plug-ins).
- Activez le plug-in AndroidXRStreaming.
- Accédez à Edit > Project Settings > Description (Modifier > Paramètres du projet > Description).
- Activez Start In VR (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 de streaming Android XR est présent :
- Accédez à Project Settings > Plugins > AndroidXRStreaming (Paramètres du projet > Plug-ins > AndroidXRStreaming).
Cliquez sur Enable AndroidXR Streaming (Activer le streaming AndroidXR).
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 :
- Accédez à Project Settings > Plugins (Paramètres du projet > Plug-ins).
Dans la section AndroidXRStreamingClient , examinez chacune des options suivantes, puis activez-les ou désactivez-les en fonction de vos besoins pour votre projet :
- Auto Start Client On Preview (Démarrer automatiquement le client lors de l'aperçu) : lorsque cette option est activée, elle lance l'application cliente d'aperçu sur n'importe quel appareil valide sélectionné lorsque vous cliquez sur Start VR Preview (Démarrer l'aperçu en RV) dans l'éditeur.
- Auto Stop Client On Preview (Arrêter automatiquement le client lors de l'aperçu) : lorsque cette option est activée, elle arrête le client d'aperçu lorsque l'aperçu en RV de l'éditeur est arrêté.
- Auto Select Compatible Device (Sélectionner automatiquement l'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, elle 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 en 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 (déterminés par la présence de l'application cliente d'aperçu direct dans Android XR Engine Hub).
Démarrer l'aperçu direct
Démarrez l'aperçu direct pour diffuser du contenu directement depuis Unreal Engine :
Connectez votre appareil Android XR à votre machine hôte à l'aide d'un câble USB-C de haute qualité.
Si vous n'avez jamais utilisé cet appareil avec l'aperçu direct auparavant, connectez-le et configurez-le pour l'aperçu direct dans Android XR Engine Hub avant de démarrer l'aperçu direct via votre moteur de jeu.
Dans l'éditeur Unreal, 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 l'aperçu direct.