Anzeigen des Unreal Engine-Logs in Visual Studio

Verwenden Sie die Visual Studio Tools für Unreal Engine (UE), um das UE-Logging innerhalb von Visual Studio anzuzeigen. Dies ist nützlich, da Sie die UE-Protokollierung sehen können, ohne zwischen dem Unreal Editor und Visual Studio wechseln zu müssen.

Voraussetzungen

Folgendes muss installiert sein:

• Visual Studio, Version 17.10 oder höher.
• Unreal Engine Version 5 oder höher.
• Visual Studio Tools for Unreal Engine. Installationsanweisungen finden Sie unter Installieren von Visual Studio Tools for Unreal Engine.
• Schließen Sie den Schnellstart: Visual Studio-Tools für Unreal Engine ab, um das Spiel „Lyra“ herunterzuladen, zu erstellen und für die Verwendung der Visual Studio-Tools für Unreal Engine zu konfigurieren.

Hinzufügen der Unreal Engine-Protokollierung zu einem Beispiel und Anzeigen der Ergebnisse in Visual Studio

Nachdem Sie die Schnellstartanleitung für Visual Studio Tools: Unreal Engine zum Herunterladen und Erstellen des Lyra-Spiels abgeschlossen haben, führen Sie die folgenden Schritte aus, um die Unreal Engine-Protokollierung zum Lyra-Spielbeispiel hinzuzufügen und um die Protokollmeldungen in Visual Studio anzuzeigen:

1. Öffnen Sie in Visual Studio LyraGameplayAbility_RangedWeapon.cpp. Suchen Sie entweder im Suchbereich des Solution Explorernach dieser Datei, oder finden Sie sie unter Games>LyraStarterGame>Source>LyraGame>Weapons>LyraGameplayAbility_RangedWeapon.cpp.

2. Gehen Sie in LyraGameplayAbility_RangedWeapon.cpp zu Zeile 477. Diese Funktion sollte angezeigt werden: void ULyraGameplayAbility_RangedWeapon::OnTargetDataReadyCallback

3. Fügen Sie den folgenden Code am Anfang der Funktion ein: UE_LOG(LogLyra, Log, TEXT("shot fired")); Dadurch wird ein Protokolleintrag erstellt, der der Kategorie LogLyrazugeordnet ist und shot fired protokolliert, wenn diese Funktion aufgerufen wird.

4. Führen Sie das Beispielspiel in Visual Studio aus, indem Sie Debuggen>Debuggen startenauswählen. Geben Sie dem Unreal Editor einige Momente, um das Lyra-Spiel zu laden.

5. Öffnen Sie in Visual Studio das UE-Protokollierungsfenster, indem Sie Ansicht>Andere Windows>Unreal Engine Log aus dem Visual Studio-Hauptmenü auswählen. Oder verwenden Sie die Schaltfläche der UE-Symbolleiste, um das Protokoll anzuzeigen. Weitere Informationen zur Symbolleiste finden Sie unter Unreal Engine-Symbolleiste.

6. Wählen Sie im Unreal-Editor auf der Symbolleiste (oder Alt+p) die Schaltfläche „Play“ (Spielen) aus, um das Spiel zu starten.

7. Verwenden Sie im Lyra-Spiel die w, a, s, d Tasten, um den Spieler nach links zum Eliminierungsportal zu navigieren. Positionieren Sie den Spieler über dem Einstiegsportal, um das Spiel zu laden.

8. Sobald das Spiel ausgeführt wird, klicken Sie auf die Maustaste, um das Spiel auszulösen. Dadurch werden einige Protokolleinträge in der Kategorie LogLyra erstellt. Jetzt wird LogLyra im Filter "Kategorien" für den nächsten Schritt angezeigt.

9. Reduzieren Sie das Protokollrauschen, indem Sie alle Ereignisse außer der Kategorie LogLyra im UE-Protokollierungsfenster wie folgt filtern: Wählen Sie das Dropdown-Menü Kategorien. Wählen Sie (Alle auswählen) oben in der Liste aus, um alle Protokollquellen zu löschen. Wählen Sie dann LogLyraaus. Im UE-Protokollierungsfenster sollte die Protokollmeldung angezeigt werden: shot fired:

   

   Die Ereignisse befinden sich unten im Protokoll, sodass Sie möglicherweise nach unten scrollen müssen, um sie anzuzeigen. Sie können auch die Schaltfläche löschen auswählen, um das Protokoll zu löschen und dann erneut auszulösen, um die Protokollmeldung anzuzeigen.

Wenn Sie die Schriftfarbe schwer zu lesen finden, können Sie sie unter Tools>Optionen>Umgebung>Schriftarten und Farbenanpassen. Wählen Sie im Dropdownmenü Einstellungen anzeigen für: den Eintrag Unreal Engine-Protokoll aus. Wählen Sie unter Elemente anzeigen: die Option Protokoll aus, und ändern Sie die Farbe für den Elementvordergrund in eine leichter zu erkennende Farbe.

Es ist praktisch, das UE-Protokollierungsfenster geöffnet zu haben, während Sie debuggen, da Sie nicht zum dem Unreal-Editor wechseln müssen, um die Protokolle anzuzeigen.

Unreal Engine-Protokollierungsoptionen

Ab Visual Studio 2022 17.12 können Sie das Protokollierungsfenster des Unreal Engine konfigurieren. Wählen Sie Tools>Optionen>Unreal Engine>Log Tool Window aus, um die folgenden Optionen anzuzeigen:

• Filtermerken: Merken Sie sich die Filter, die Sie im Protokollfenster festgelegt haben, wenn Sie Visual Studio schließen.
• Beim Start löschen: Löschen Sie das Protokollfenster, wenn das Spiel gestartet wird.
• JSON-Nachrichtenanfordern: Anforderung, dass Einträge im JSON-Format protokolliert werden. JSON stellt ein strukturiertes Format bereit, das programmgesteuert analysiert und verarbeitet werden kann. Dies vereinfacht das Extrahieren bestimmter Informationen aus Protokollmeldungen, z. B. Fehlerdetails, Zeitstempel und andere Metadaten.
• Automatisch anzeigen: Automatisches Anzeigen des Protokollfensters, wenn das Spiel in Visual Studio gestartet wird.

Verwandte Inhalte

Visual Studio-Werkzeuge für Unreal Engine
Hinzufügen von Unreal Engine-Klassen, Modulen und Plug-Ins in Visual Studio
Anzeigen von Unreal Engine Blueprints in Visual Studio
Anzeigen der Unreal Engine-Logdateien in Visual Studio
Anzeigen von Unreal Engine-Makros in Visual Studio