Profilatura con informazioni dettagliate non realiProfiling with Unreal Insights

Unreal Insights è un sistema di profilatura che raccoglie, analizza e Visualizza i dati da Unreal Engine.Unreal Insights is a profiling system that collects, analyzes, and visualizes data from Unreal Engine. Il sistema di profilatura consente di individuare i colli di bottiglia e le aree di ottimizzazione in cui le prestazioni delle app possono usare un Boost.The profiling system can help you find optimization bottlenecks and areas where you apps performance could use a boost. In genere, si abilitano le informazioni dettagliate non reali direttamente dall'editor, ma per HoloLens 2 è necessario usare la riga di comando.Normally, you enable Unreal Insights right from the editor, but for HoloLens 2 you'll need to use the command line.

ConfigurazioneSetup

Unreal consente di creare e configurare un "profilo personalizzato" nell'utilità di avvio HoloLens con i parametri della riga di comando che abilitano le informazioni non reali.Unreal lets you to create and configure a "Custom Profile" in the HoloLens launcher with the command line parameters that enable Unreal Insights.

  1. Individuare l'indirizzo IP del computer utilizzando il comando ipconfig al prompt dei comandi.Find the IP address of your computer using the ipconfig command on the command prompt. L'indirizzo IP è l'indirizzo IPv4 elencato da ipconfig.The IP address is the IPv4 address listed by ipconfig. Tenere presente questo aspetto per un momento successivo quando si impostano i parametri della riga di comando.Keep this in mind for later when you set Command Line Parameters.

Importante

Se si è protetti da una VPN, potrebbe essere necessario specificare l'indirizzo IP fornito tramite la VPN.If you're behind a VPN, you may need to provide the IP address provided via the VPN instead.

Screenshot dei risultati della riga di comando per il comando ipconfig

  1. Passare alla parte superiore del pannello Unreal Engine e aprire Device Manager sotto il pulsante Launch (avvia ):Go to the top of the Unreal Engine panel and open Device Manager under the Launch button:

Screenshot delle opzioni di avvio con gestione dispositivi evidenziato

  1. Nella Device Manager selezionare Aggiungi un dispositivo non in elenco:In the Device Manager, select Add an Unlisted Device:

Screenshot di gestione dispositivi aperto in Unreal Engine

  1. Fare clic su selezionare una piattaforma e scegliere HoloLens:Click Select a platform and choose HoloLens:

Screenshot dell'elenco a discesa Aggiungi dispositivo non in elenco con HoloLens evidenziato

  1. Se si usa IPoverUSB, immettere 127.0.0.1:10080 come identificatore del dispositivo.If you're using IPoverUSB, enter 127.0.0.1:10080 as the Device Identifier. Immettere l'utente e la password di HoloLens nei rispettivi campi e compilare il nome visualizzato come desiderato.Enter your HoloLens user and password in their respective fields and fill Display Name as you wish.

Importante

L'identificatore del dispositivo è l'indirizzo IP del HoloLens, non del computer che esegue informazioni dettagliate non reali trovate nel passaggio 1.The Device Identifier is the IP address of the HoloLens, NOT of the computer running Unreal Insights you found in step 1.

Schermata dei dettagli del dispositivo HoloLens in gestione dispositivi

  1. Selezionare Aggiungi per visualizzare il HoloLens nell'elenco dei dispositivi di gestione dispositivi:Select Add and your HoloLens should appear in the device list of the device manager:

Screenshot di HoloLens aggiunto all'elenco dei dispositivi

LaunchLaunch

  1. Aprire avvio progetto dal pannello UE4 sotto il pulsante Launch (avvia ):Open Project Launcher from the UE4 panel under the Launch button:

Screenshot delle opzioni di avvio con avvio del progetto evidenziato

  1. Selezionare il + pulsante per creare un profilo personalizzato in profili di avvio personalizzati.Select the + button to create a custom profile under Custom Launch Profiles. Una volta creato, è sempre possibile modificare il profilo in un secondo momento:Once created, you can always edit this profile later:

Screenshot dell'utilità di avvio del progetto con profili di avvio personalizzati evidenziati

  1. Selezionare il pulsante modifica profilo nel profilo di avvio personalizzato di HoloLens e configurare:Select edit profile button on the HoloLens custom launch profile and configure:
    • Selezionare Cook to by the book per abilitare la copia nel dispositivoSelect Cook to By the Book to enable copying to device
    • È possibile scegliere di archiviare l'archivio ? nella sezione Archivio per mantenere il. appxbundle generato anziché eliminare per risparmiare spazio su disco.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. Specificare un percorso per il appxbundle e passare a una build di sviluppo, se si desideraSpecify a location for the .appxbundle and switch to a development build if you wish

Screenshot delle opzioni di Cook nella configurazione del profilo con Cook by the book e HoloLens evidenziato

  1. Impostare la modalità di distribuzione della compilazione per la copia nel dispositivo per attivare la sezione Launch dell'interfaccia utente:Set How would you like to deploy the build? to Copy to device to activate the Launch section of the UI:

Screenshot dell'utilità di avvio del progetto con opzioni di distribuzione con copia nel dispositivo evidenziato

  1. Impostare parametri della riga di comando aggiuntivi nella sezione Launch .Set Additional Command Line Parameters in the Launch section. I parametri verranno scritti in un file di ue4commandline.txt, inclusi nel bundle e usati all'avvio.The parameters will be written into a ue4commandline.txt file, packaged into the bundle, and used at launch.
    • Provare a eseguire queste operazioni per i principianti: -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
    • È possibile trovare un elenco completo dei parametri di avvio disponibili nella documentazione di riferimento di Unreal Insights.You can find a complete list of available launch parameters in the Unreal Insights reference documentation.

Nota

"IP_OF_YOUR_PC" è l'indirizzo IP trovato nel passaggio 1."IP_OF_YOUR_PC" is the IP address we found in step 1. Si tratta dell'indirizzo IP del computer che esegue Unreal Insights, non dell'indirizzo IP del HoloLens.This is the IP address of the computer running Unreal Insights, NOT the IP address of the HoloLens.

Importante

Il numero di tracce può essere molto rapido.Traces can get large very quickly. Abilitare solo i canali necessari per ridurre le dimensioni della traccia.Enable only those channels you need to keep trace size low.

Screenshot delle opzioni di configurazione di avvio

  1. Avviare informazioni dettagliate non reali prima dell'avvio dell'app. in caso contrario, le informazioni dettagliate non saranno in grado di inizializzare in modo appropriato prima dell'app:Launch Unreal Insights BEFORE app launch, otherwise Unreal Insights wont be able to initialize appropriately before the app:
    • Il file eseguibile di Unreal Insights viene archiviato nella cartella del motore dei binari, in genere come segue: "C:\Program Files\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 del file eseguibile di Unreal Insights in esecuzione

  1. Selezionare indietro per tornare alla radice della finestra di dialogo di avvio del progettoSelect Back to return to the root of the Project Launcher dialog
  2. Nell'editor fare clic su Launch (avvia ) nel profilo di avvio personalizzatoBack in the editor, Click Launch on your custom launch profile

Screenshot dei profili di avvio personalizzati

  1. È possibile osservare il pacchetto del progetto, installarlo nel dispositivo e avviareWatch as your project is packaged up, installed on your device, and launched

ProfilaturaProfiling

Per avviare la profilatura, selezionare la connessione in tempo reale al dispositivo per avviare la profilatura.Back in Unreal Insights, select the Live connection to your device to start profiling

Il profilo personalizzato è condiviso tra i progetti.The custom profile is shared between projects. Da questo punto in poi, è possibile usare il profilo personalizzato creato anziché eseguire questa operazione ogni volta.From here on out, you can use the custom profile you created instead of having to do this every time. È necessario ricreare la connessione al dispositivo ogni volta che si avvia Unreal con i passaggi da 3 a 6 nella sezione relativa all'installazione.You only need to recreate the connection to the device every time you start Unreal with steps 3 to 6 in the setup section.

Vedere ancheSee also