Partager via

Visualiser le journal de l'Unreal Engine dans Visual Studio

  • Article

Utilisez les Visual Studio Tools pour Unreal Engine (UE) pour visualiser le journal UE dans Visual Studio. Ceci est pratique, car vous pouvez voir la journalisation UE sans avoir à basculer entre l’éditeur Unreal et Visual Studio.

Prérequis

Les éléments suivants doivent être installés :

Ajoutez le journal d'Unreal Engine à un échantillon et voyez les résultats dans Visual Studio

Après avoir complété le Guide de démarrage rapide : Visual Studio Tools for Unreal Engine pour télécharger et construire le jeu Lyra, suivez les étapes suivantes pour ajouter la journalisation Unreal Engine à l'échantillon de jeu Lyra et voir les messages de journal dans Visual Studio :

  1. Dans Visual Studio, ouvrez LyraGameplayAbility_RangedWeapon.cpp. Recherchez ce fichier dans le volet de recherche de l'Explorateur de solutions, ou trouvez-le sous Jeux>LyraStarterGame>Source>LyraGame>Personnage>LyraCharacter.h.

  2. Dans LyraGameplayAbility_RangedWeapon.cpp, accédez à la ligne 477. Vous devez voir cette fonction : void ULyraGameplayAbility_RangedWeapon::OnTargetDataReadyCallback

  3. Insérez le code suivant au début de la fonction : UE_LOG(LogLyra, Log, TEXT("shot fired")); Ceci crée une entrée de journal, associée à la catégorie LogLyra, qui journalise shot fired quand cette fonction est appelée.

  4. Exécutez l’exemple de jeu dans Visual Studio en choisissant Déboguer>Démarrer le débogage. Laissez quelques instants à l'éditeur Unreal pour charger le jeu Lyra.

  5. Dans Visual Studio, ouvrez la fenêtre de journalisation UE en choisissant Affichage>Autres>Journal Unreal Engine dans le menu principal de Visual Studio. Vous pouvez également utiliser le bouton de la barre d'outils UE pour afficher le journal. Pour en savoir plus sur la barre d'outils, consultez la rubrique Barre d'outils Unreal Engine.

  6. Dans l’éditeur Unreal, choisissez le bouton Play dans la barre d’outils (ou Alt+p) pour démarrer le jeu.

  7. Dans le jeu Lyra, utilisez les touches w, a, s et d pour parcourir le lecteur à gauche du portail Elimination. Positionnez le lecteur sur le portail d’entrée pour charger le jeu.

  8. Une fois le jeu en cours d’exécution, cliquez sur le bouton de la souris pour tirer. Ceci crée des entrées de journal dans la catégorie LogLyra. LogLyra va maintenant apparaître dans le filtre Catégories pour l’étape suivante.

  9. Réduisez le bruit du journal en filtrant tous les événements sauf ceux de la catégorie LogLyra dans la fenêtre de journalisation UE comme suit : choisissez la liste déroulante Catégories. Choisissez (Tout sélectionner) en haut de la liste pour effacer toutes les sources de journal. Sélectionnez ensuite LogLyra. Dans la fenêtre de journalisation UE, vous devez voir le message de journalisation shot fired :

    Capture d'écran de la fenêtre Journal de l'Unreal Engine montrant les événements « coups de feu » et le menu déroulant Catégories avec LogLyra sélectionné.

    Les événements sont dans le bas du journal : il peut donc être nécessaire de faire défiler vers le bas pour les voir. Vous pouvez aussi choisir le bouton Effacer pour effacer le journal, puis tirer à nouveau pour voir le message de journal.

Si vous trouvez la couleur de police difficile à lire, vous pouvez l’ajuster sous Outils>Options>Environnement>Polices et couleurs. Changez la liste déroulante Afficher les paramètres pour : en Journal Unreal Engine. Dans Afficher les éléments : sélectionnez Journal et changez la couleur de Premier plan de l’élément en choisissant quelque chose de plus facile à lire.

L’ouverture de la fenêtre de journalisation UE pendant le débogage est pratique, car vous n’avez pas à basculer vers l’éditeur Unreal pour les voir.

Options de journal Unreal Engine

À partir de la version Visual Studio 2022 17.12, utilisez Outils>Options>Unreal Engine pour configurer la fenêtre de journalisation Unreal Engine. Sous l’onglet Général , les options suivantes pour la fenêtre du journal Unreal Engine sont disponibles sous Fenêtre de l’outil Journal :

Capture d’écran des options de la fenêtre de Journal Unreal Engine.

  • Effacer au lancement : efface la fenêtre du journal lorsque le jeu est lancé.
  • Se rappeler des filtres : conserve les filtres que vous avez définis dans la fenêtre de journal lorsque vous fermez Visual Studio.
  • Demander des messages JSON  : demande que les entrées de journal soient au format JSON. JSON fournit un format structuré qui est facile à analyser et à traiter par programmation. Cela simplifie l’extraction d’informations spécifiques à partir de messages de journal, telles que les détails d’erreur, les horodatages et d’autres métadonnées.
  • Afficher automatiquement : affiche automatiquement la fenêtre de journal lorsque le jeu est lancé dans Visual Studio.

Contenu connexe

Visual Studio Tools pour Unreal Engine
Ajouter des classes, des modules et des plug-ins Unreal Engine dans Visual Studio
Visualiser les Blueprints de l'Unreal Engine dans Visual Studio
Visualiser le journal de l'Unreal Engine dans Visual Studio
Visualiser les macros Unreal Engine dans Visual Studio