Outil de débogage Oculus
OCULUS RIFT DOCUMENTATION
Ce sujet concerne le développement d'Oculus Rift avec le SDK PC. Pour en savoir plus sur l'optimisation des performances pour les applications Meta Quest, consultez l'un des sujets suivants en fonction de votre plateforme de développement : L’outil de débogage Oculus (ODT) vous permet d’afficher des informations sur le débogage ou les performances de votre jeu ou expérience. Il vous permet également de régler ou de configurer des paramètres connexes, tels que la taille du champ de vision pour une vue écran plat miroir de l'expérience VR (qui pourrait être diffusée à une audience dans un format de visualisation plus confortable).
Démarrage de l’ODT
Pour démarrer l'outil de débogage Oculus :
- Assurez-vous que vous disposez des droits admin. Cela est obligatoire pour exécuter l’outil de débogage Oculus.
- Naviguez jusqu’Ã
Program Files\Oculus\Support\oculus-diagnostics\. Notez que l'outil de débogage Oculus doit toujours être exécuté directement depuis cet emplacement, afin de s'assurer qu'une version correspond à la distribution Oculus. Si vous copiez l'outil de débogage Oculus dans un autre emplacement, il est possible qu’il ne fonctionne plus après les mises à jour ultérieures. Double-cliquez sur OculusDebugTool.exe. L’outil de débogage Oculus s’ouvre. La fenêtre principale est illustrée ci-dessous avec tous les titres de la liste de premier niveau développés :

L'interface d’utilisation ODT est décrite dans les paragraphes suivants.
Menu File (Fichier)

- Launch App... (Lancer l’application) : lance une application VR.
- Restart as administrator (Redémarrer comme administrateur) : redémarre l’outil de débogage Oculus avec les droits d’admin.
Menu Tools (Outils)

- Performance Profiler (Analyseur de performances) : lance l’analyseur de performances. Pour en savoir plus, consultez Analyseur de performances.
- Lost Frame Capture (Capture d’images perdues) : lance la capture d’images perdues. Pour en savoir plus, consultez Outil Lost Frame Capture.
- Scene View: Visualizes your HMD and controller position.
- Mirror (Miroir) : affiche le contenu rendu dans le HMD sur l'écran de votre PC. Pour en savoir plus, consultez Miroir de composition.
Menu Service

- Restart Oculus Service (Redémarrer le service Oculus) : redémarre le service Oculus sur votre ordinateur local.
- Start Oculus Service (Démarrer le service Oculus) : démarre le service Oculus sur votre ordinateur local.
- Stop Oculus Service (Arrêter le service Oculus) : arrête le service Oculus sur votre ordinateur local.
- Toggle console window visibility (Afficher ou masquer la fenêtre de la console) : active et désactive la visibilité de la fenêtre de sortie de la console. La fenêtre de la console affiche les détails de tous les scripts et applications qui s'exécutent en coulisses lorsque vous utilisez l'ODT. La plupart des utilisateur·ices n'ont pas besoin d'activer cette option.
- Logs (Journaux) : affiche une fenêtre de journal qui suit les détails de tous les scripts et applications qui s'exécutent en coulisses lorsque vous utilisez l'ODT. La plupart des utilisateur·ices n'ont pas besoin d'activer cette option.
Utilisation de l’ODT
Il est conseillé de désactiver la Distorsion asynchrone de l’espace (ASW), afin d'avoir une idée précise des performances de votre application (sans l'aide de l’ASW). Pour ce faire, désactivez l’option Distorsion asynchrone de l’espace :

- Sélectionnez l'affichage HUD visible que vous souhaitez voir. Les options sont les suivantes : Aucun (aucun HUD n’est affiché), HUD des performances, HUD de débogage stéréo ou HUD de couches.
Si vous sélectionnez HUD des performances, sélectionnez celui que vous voulez afficher. Les options sont les suivantes : délai de latence, délai d’affichage, marge de performance et informations sur la version. Pour en savoir plus, consultez
Affichage tête haute des performances. Le HUD vous permet, à vous ou à vos utilisateur·ices, d'afficher des informations sur les performances des applications créées avec le SDK. Vous trouverez ci-après un exemple d’HUD des performances :

Si vous avez sélectionné le HUD de débogage stéréo, configurez le mode, la taille, la position et la couleur à partir des options du HUD de débogage stéréo. Vous trouverez ci-après un exemple du HUD de débogage stéréo :

Si vous avez sélectionné le HUD des couches, sélectionnez la couche dont vous voulez afficher les informations ou cochez la case Afficher tout. Vous trouverez ci-après un exemple du HUD des couches :

- Sélectionnez Launch App (Lancer l’application) dans le menu File (Fichier) et sélectionnez le fichier exécutable de l’application.
- Mettez le casque et affichez les résultats.
Champ de vision plus grand pour le jeu en streaming
Le paramètre FOV-Tangent Multiplicateur (Multiplicateur de tangente de champ de vision) est fourni par l'outil de débogage Oculus, comme indiqué sur la capture d'écran suivante. Ce paramètre peut être utilisé pour améliorer l'expérience visuelle lors de la diffusion d'un jeu à une audience. Cette fonction permet d'augmenter la taille du champ de vision tel qu'il apparaît sur les écrans plats miroirs, par rapport à ce qui est affiché dans le casque. Cela améliore le confort de visualisation des jeux en streaming ou enregistrés, car le champ de vision utilisé dans le casque peut sembler trop étroit sur les écrans plats et provoquer ainsi le mal des transports auprès de l’audience. La fonctionnalité FOV-Tangent Multiplier comporte deux paramètres : Horizontal et Vertical. Il suffit de définir ces valeurs sur le multiplicateur souhaité pour le champ de vision. Par exemple, si vous réglez Horizontal sur 1.2 et Vertical sur 1.1, le champ de vision diffusé sera 20 % plus grand horizontalement et 10 % plus grand verticalement, par rapport au champ de vision dans le casque. L'ODT affiche le paramètre Horizontal, suivi d'un point-virgule, puis le paramètre Vertical. Ainsi, l'exemple précédent serait inscrit comme 1.2;1.1 sur la ligne FOV-Tangent Multiplier :
