Aufzeichnen in einer Datei | Unreal Engine 5.7 Dokumentation

In diesem Tutorial erfährst du, wie du Visualisierungen in Chaos Visual Debugger (CVD) aufzeichnst und als .utrace- Datei für das spätere Debugging speicherst. Die Aufnahme in eine Datei ist nützlich, wenn du den Performance-Overhead der Live-Wiedergabe vermeiden möchtest.

Informationen zur Aufzeichnung von Visualisierungen in Echtzeit findest du unter Aufzeichnung einer Live-Sitzung.

Starten einer Aufzeichnung über die Benutzeroberfläche

In diesem Abschnitt erfährst du, wie du eine PIE Sitzung mit der Zielvoreinstellung „Lokaler Editor“ aufzeichnest und wie du alle anderen Zieltypen aufzeichnen kannst.

Lokaler Editor

Befolge diese Schritte, um eine lokal PIE-Sitzung aufzuzeichnen und wiederzugeben:

Schalte in CVD im Datenkanäle-Menü die Datenkanäle um, die du aufzeichnen möchtest.
Klicke in Unreal Editor auf die Schaltfläche Wiedergabe in der Haupt-Symbolleiste, um eine PIE-Sitzung zu starten. Du kannst entscheiden, ob du eine PIE Sitzung vor oder nach dem Beginn einer Aufzeichnung in CVD beginnen möchtest.
Da das Ziel „Lokale Editor“ bereits standardmäßig ausgewählt ist, kannst du die Aufnahme beginnen, indem du auf In Datei aufzeichnen klickst. Während der Aufnahme verwandelt sich die Schaltfläche in ein rotes Aufnahmesymbol.
Zeige mit dem Mauszeiger auf das Aufnahme-Symbol und klicke auf das rote quadratische Symbol, um die Aufnahme zu stoppen.
Dieser Prozess gibt eine einzelne .utrace- Datei aus, die du sofort nach der Aufnahme laden kannst, indem du im Dialogfeld auf Ja klickst.

Wenn du gerade eine Aufnahme erstellst, kannst du eine bestehende PIE-Sitzung beenden und eine neue beginnen – CVD verbindet sich automatisch damit.

Alle anderen Ziele

Befolge diese Schritte, um alle anderen Zieltypen aufzuzeichnen:

Vergewissere dich, dass deine Zielanwendung oder -anwendungen ausgeführt werden.
Schalte in CVD die Datenkanäle um, die du aufzeichnen möchtest.
Klicke auf die Dropdown-Liste Sitzungsziel in der CVD-Haupt-Werkzeugleiste und wähle eine Voreinstellung oder benutzerdefinierte Ziel aus, um ein Ziel für die Aufzeichnung auszuwählen.
Klicke in der CVD-Haupt-Symbolleiste auf In Datei aufzeichnen, um eine Aufnahme zu starten. Während der Aufnahme verwandelt sich die Schaltfläche in ein rotes Aufnahmesymbol.
Um die Aufnahme zu stoppen, markiere das Aufnahmesymbol und klicke auf das rote Quadrat-Symbol.

Abhängig davon, ob du ein einzelnes oder mehrere Ziele aufzeichnest, gibt dieser Prozess eine oder mehr .utrace- Dateien aus. Wenn du mehrere Ziele aufnimmst, erscheint das Dialogfenster, das dich zum Laden der Aufnahme auffordert, nicht.

(Legacy) Aufzeichnen in eine Datei mit dem Befehlszeilen-Interface

Wir empfehlen, die Benutzeroberfläche von CVD zu verwenden, um Aufnahmen zu starten und zu beenden. Du kannst jedoch auch die Befehlszeile verwenden, um PIE-Sitzungen, Game-Clients und -Server und paketierte Builds aufzuzeichnen.

Aktivieren eines Datenkanals

Zum Modifizieren von Datenkanälen öffne die Befehlszeile in der Zielanwendung. Drücke in einem verpackten Build den Backtick (`).
Gib den folgenden Konsolenbefehl ein und ersetze [newstate] durch True oder False und [channelname] durch den gewünschten Datenkanal:
p.Chaos.VD.SetCVDDataChannelEnabled [newstate] [channelname]
Zum Beispiel:
Drücke die Eingabetaste, um den Befehl auszuführen.

Aktivieren mehrerer Datenkanäle

Um mehrere Kanäle durch Auflistung zu aktivieren oder zu deaktivieren, trenne sie durch Kommata. Das folgende Beispiel aktiviert die Kanäle PostIntegrate und SceneQueries:

p.Chaos.VD.SetCVDDataChannelEnabled true SceneQueries,PostIntegrate

Aktivieren vordefinierter Datenkanäle

Um einen Game-Client oder -Server mit einem vordefinierten Satz aktivierter Kanäle zu starten, füge das folgende Befehlszeilen-Argument hinzu:

CVDDataChannelsOverride=[ChannelName1,ChannelName2]

Das folgende Beispiel aktiviert die Kanäle PostIntegrate und SceneQueries:

CVDDataChannelsOverride=SceneQueries,PostIntegrate

Starten einer Aufnahme über die Befehlszeile

Öffne die Befehlszeile in der Zielanwendung, um eine Aufnahme zu starten. Wenn du einen verpackten Build ausführst, kannst du den Backtick (`) drücken.
Gib den folgenden Befehl ein und drücke die Eingabetaste, um ihn auszuführen:
p.Chaos.StartVDRecording
Wenn die Aufnahme beginnt, wird auf dem Bildschirm der String „Chaos Visual Debugger recording in progress…“ angezeigt.
Um eine Aufnahme zu stoppen, öffne die Befehlszeile, gib den folgenden Befehl ein und drücke die Eingabetaste, um ihn auszuführen.
p.Chaos.StopVDRecording