Profilerstellung mit Unreal InsightsProfiling with Unreal Insights

Unreal Insights ist ein Profil Erstellungs System, das Daten von Unreal Engine sammelt, analysiert und visualisiert.Unreal Insights is a profiling system that collects, analyzes, and visualizes data from Unreal Engine. Das Profil Erstellungs System kann Sie bei der Suche nach Optimierungs Engpässen und Bereichen unterstützen, in denen die Leistung von apps eine Erhöhung der AnwendungenThe profiling system can help you find optimization bottlenecks and areas where you apps performance could use a boost. Normalerweise aktivieren Sie Unreal Insights direkt aus dem Editor, aber für hololens 2 müssen Sie die Befehlszeile verwenden.Normally, you enable Unreal Insights right from the editor, but for HoloLens 2 you'll need to use the command line.

EinrichtenSetup

Unreal ermöglicht es Ihnen, ein "benutzerdefiniertes Profil" im hololens-Start Programm mit den Befehlszeilen Parametern zu erstellen und zu konfigurieren, die Unreal Insights ermöglichen.Unreal lets you to create and configure a "Custom Profile" in the HoloLens launcher with the command line parameters that enable Unreal Insights.

  1. Suchen Sie die IP-Adresse Ihres Computers mithilfe des Befehls " ipconfig " an der Eingabeaufforderung.Find the IP address of your computer using the ipconfig command on the command prompt. Die IP-Adresse ist die von ipconfig aufgelistete IPv4-Adresse.The IP address is the IPv4 address listed by ipconfig. Beachten Sie dies für den späteren Zeitpunkt, wenn Sie Befehlszeilenparameter festlegen.Keep this in mind for later when you set Command Line Parameters.

Wichtig

Wenn Sie sich hinter einem VPN befinden, müssen Sie möglicherweise die IP-Adresse angeben, die über das VPN bereitgestellt wird.If you're behind a VPN, you may need to provide the IP address provided via the VPN instead.

Screenshot der Befehlszeilen Ergebnisse für den Befehl "ipconfig"

  1. Wechseln Sie zum oberen Rand des Unreal Engine-Panels, und öffnen Sie Geräte-Manager unter der Schaltfläche " starten ":Go to the top of the Unreal Engine panel and open Device Manager under the Launch button:

Screenshot der Startoptionen mit hervorgehobenem Geräte-Manager

  1. Wählen Sie im Geräte-Manager die Option nicht aufgelistetes Gerät hinzufügen aus:In the Device Manager, select Add an Unlisted Device:

Screenshot des geöffneten Geräte-Managers in der Unreal-Engine

  1. Klicken Sie auf Plattform auswählen , und wählen Sie hololens aus:Click Select a platform and choose HoloLens:

Screenshot der Dropdown Liste "nicht aufgelisteten Gerät hinzufügen" mit hervorgehobenem hololens

  1. Wenn Sie ipoverusb verwenden, geben Sie 127.0.0.1:10080 als Geräte Bezeichner ein.If you're using IPoverUSB, enter 127.0.0.1:10080 as the Device Identifier. Geben Sie Ihren hololens-Benutzer und das Kennwort in die entsprechenden Felder ein, und füllen Sie den anzeigen Amen wie gewünscht aus.Enter your HoloLens user and password in their respective fields and fill Display Name as you wish.

Wichtig

Der Geräte Bezeichner ist die IP-Adresse der hololens und nicht der Computer, auf dem Unreal Insights ausgeführt wird, den Sie in Schritt 1 gefunden haben.The Device Identifier is the IP address of the HoloLens, NOT of the computer running Unreal Insights you found in step 1.

Screenshot der Geräte Details des hololens in Device Manager

  1. Wählen Sie Hinzufügen aus, und ihre hololens sollte in der Geräteliste des Geräte-Managers angezeigt werden:Select Add and your HoloLens should appear in the device list of the device manager:

Screenshot der der Geräteliste hinzugefügten hololens

StartenLaunch

  1. Öffnen Sie das Projekt Startfeld über den Bereich UE4 unter der Schaltfläche starten:Open Project Launcher from the UE4 panel under the Launch button:

Screenshot der Startoptionen mit hervorgehobenem Projekt Starter

  1. Wählen Sie die + Schaltfläche zum Erstellen eines benutzerdefinierten Profils unter benutzerdefinierte Start profile aus.Select the + button to create a custom profile under Custom Launch Profiles. Nach der Erstellung können Sie dieses Profil später jederzeit bearbeiten:Once created, you can always edit this profile later:

Screenshot: Projektstart Programm mit hervorgehobenem benutzerdefinierten Start Profilen

  1. Wählen Sie im benutzerdefinierten Start Profil hololens die Schaltfläche Profil bearbeiten aus, und konfigurieren Sie Folgendes:Select edit profile button on the HoloLens custom launch profile and configure:
    • Wählen Sie für das Buch die Option Kochen aus, um das Kopieren auf das GerätSelect Cook to By the Book to enable copying to device
    • Sie sollten die Option "möchten Sie archivieren? " im Abschnitt " Archive " aktivieren, um die generierte. appxbundle-Datei beizubehalten, anstatt Sie zu löschen, um Speicherplatz zu sparen.You may want to check Do you wish to archive? in the Archive section to retain the generated .appxbundle rather than deleting to save disk space. Geben Sie einen Speicherort für die appxbundle-Datei an, und wechseln Sie bei Bedarf zu einem entwicklungbuild.Specify a location for the .appxbundle and switch to a development build if you wish

Screenshot der Koch Optionen in der Profil Konfiguration mit dem Buch "Cook" und "hololens" hervorgehoben

  1. Legen Sie fest, wie soll der Build bereitgestellt werden soll? auf das Gerät zu kopieren , um den Startbereich der Benutzeroberfläche zu aktivieren:Set How would you like to deploy the build? to Copy to device to activate the Launch section of the UI:

Screenshot des Projektstart Programms mit den Bereitstellungs Optionen mit hervorgehobener Kopie auf Gerät

  1. Legen Sie Zusätzliche Befehlszeilenparameter im Startbereich fest.Set Additional Command Line Parameters in the Launch section. Die Parameter werden in eine ue4commandline.txt Datei geschrieben, in das Bündel gepackt und beim Start verwendet.The parameters will be written into a ue4commandline.txt file, packaged into the bundle, and used at launch.
    • Probieren Sie die folgenden Schritte aus: -tracehost = IP_OF_YOUR_PC-Trace = Log, Bookmark, Frame, CPU, GPU, loadtime, File, NETTry these for starters: -tracehost=IP_OF_YOUR_PC -trace=Log,Bookmark,Frame,CPU,GPU,LoadTime,File,Net
    • Eine komplette Liste der verfügbaren Startparameter finden Sie in der Unreal Insights-Referenz Dokumentation.You can find a complete list of available launch parameters in the Unreal Insights reference documentation.

Hinweis

"IP_OF_YOUR_PC" ist die IP-Adresse, die in Schritt 1 gefunden wurde."IP_OF_YOUR_PC" is the IP address we found in step 1. Dabei handelt es sich um die IP-Adresse des Computers, auf dem Unreal Insights ausgeführt wird, nicht um die IP-Adresse der hololens.This is the IP address of the computer running Unreal Insights, NOT the IP address of the HoloLens.

Wichtig

Ablauf Verfolgungen können sehr schnell groß werden.Traces can get large very quickly. Aktivieren Sie nur die Kanäle, die Sie benötigen, um die Ablauf Verfolgungs Größe zu beschränken.Enable only those channels you need to keep trace size low.

Screenshot der Start Konfigurationsoptionen

  1. Starten Sie vor dem Starten der APP Unreal Insights, sonst ist Unreal Insights nicht in der Lage, vor der APP ordnungsgemäß zu initialisieren:Launch Unreal Insights BEFORE app launch, otherwise Unreal Insights wont be able to initialize appropriately before the app:
    • Die ausführbare Datei von Unreal Insights wird im Ordner Binärdateien-Engine gespeichert, in der Regel wie folgt: "c:\programme\epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"The Unreal Insights executable is stored in the binaries engine folder, usually as follows: "C:\Program Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"

Screenshot der ausführbaren Datei "Unreal Insights"

  1. Wählen Sie zurück , um zum Stamm des Dialog Felds für das Projekt Startfeld zurückzukehren.Select Back to return to the root of the Project Launcher dialog
  2. Klicken Sie im Editor auf Start im benutzerdefinierten Start Profil.Back in the editor, Click Launch on your custom launch profile

Bildschirm Abbildung von benutzerdefinierten Start Profilen

  1. Sehen Sie sich an, wie Ihr Projekt verpackt, auf Ihrem Gerät installiert und gestartet wird.Watch as your project is packaged up, installed on your device, and launched

ProfilerstellungProfiling

Zurück in Unreal Insights: Wählen Sie die Live Verbindung zum Gerät aus, um die Profilerstellung zu starten.Back in Unreal Insights, select the Live connection to your device to start profiling

Das benutzerdefinierte Profil wird von Projekten gemeinsam genutzt.The custom profile is shared between projects. Von hier aus können Sie das von Ihnen erstellte benutzerdefinierte Profil verwenden, anstatt jedes Mal dies zu tun.From here on out, you can use the custom profile you created instead of having to do this every time. Sie müssen die Verbindung mit dem Gerät nur bei jedem Start von Unreal mit den Schritten 3 bis 6 im Abschnitt Setupneu erstellen.You only need to recreate the connection to the device every time you start Unreal with steps 3 to 6 in the setup section.

Weitere InformationenSee also