Déployer un projet MRTK3 sur un appareil Quest

Cette page explique comment déployer votre projet Unity avec MRTK sur un appareil Quest. Pour ajouter MRTK à votre projet, consultez la page de configuration.

Notes

Nous vous recommandons vivement d’utiliser la communication holographique à distance pour effectuer une itération et un test rapides sur Hololens 2, ce qui permet de tester instantanément l’appareil sans avoir besoin de compiler et de déployer. Vous pouvez également jouer dans Unity directement avec le runtime OpenXR actuel du PC, incluant Windows Mixed Reality, SteamVR sur OpenXR, ou même Oculus Link pour Quest. Consultez notre liste complète ici.

Configuration requise pour le déploiement

  1. Suivez ces étapes pour vous assurer que votre projet est prêt à être déployé sur l’appareil Quest.

  2. Vérifiez que le mode développeur est activé sur votre appareil. L’installation des pilotes ADB Oculus est facultative.

  3. Accédez à File > Build Settings.

  4. Sous Plateforme, sélectionnez Android. Passez sur la plateforme Android.

  5. Accédez à Edit > Project Settings.

  6. Sous Paramètres du projet, accédez à Gestion des plug-ins XR et activez OpenXR sous l’onglet Android. Vérifiez que Initialiser XR au démarrage est sélectionné et qu’aucun groupe de fonctionnalités n’est activé.

    Oculus XR Plug-in Management window

  7. Sous Paramètres du projet, accédez à Gestion des plug-ins XR > OpenXR > Profils d’interaction et modifiez-le de sorte que seul le profil de contrôleur tactile Oculus soit présent.

  8. Sous Project Settings, accédez à XR Plug-in Management > OpenXR > OpenXR Feature Groups et vérifiez que les éléments suivants sont cochés sous All Features.

    Oculus OpenXR

    Notes

    Des icônes d’erreur/avertissement rouges ou jaunes peuvent s’afficher pendant ce processus. Cliquez sur l’icône pour ouvrir l’outil OpenXR Project Validation et sélectionnez Fix All pour résoudre les problèmes. Vous devrez peut-être effectuer cette opération plusieurs fois.

    Notes

    Si vous ne voyez pas Oculus Quest Support sous le panneau OpenXR Feature Groups, vérifiez que vous avez téléchargé le plug-in Mixed Reality OpenXR via MR Feature Tool

Déploiement sur un appareil

  1. Une fois le projet configuré, passez à Générer la build

    Notes

    Ne suivez pas les instructions de configuration des paramètres sur la page de documentation d’Oculus. Ses instructions nécessitent l’utilisation du Kit de développement logiciel (SDK) d’intégration Oculus Azure et utilisent le plug-in Oculus XR au lieu du plug-in OpenXR.

    Notes

    Nous vous recommandons de sélectionner Build and Run pour générer et exécuter votre projet. Cela le déploie directement sur votre Oculus Quest.