Profilatura con Unreal Insights

Unreal Insights è un sistema di profilatura che raccoglie, analizza e visualizza i dati da Unreal Engine. Il sistema di profilatura consente di trovare colli di bottiglia dell'ottimizzazione e le aree in cui le prestazioni delle app possono usare un aumento delle prestazioni. In genere, si abilita Unreal Insights dall'editor, ma per HoloLens 2 è necessario usare la riga di comando.

Eseguire la configurazione

Unreal consente di creare e configurare un "profilo personalizzato" nell'utilità di avvio HoloLens con i parametri della riga di comando che abilitano Unreal Insights.

  1. Trovare l'indirizzo IP del computer usando il comando ipconfig al prompt dei comandi. L'indirizzo IP è l'indirizzo IPv4 elencato da ipconfig. Tenere presente questo problema per un momento successivo quando si impostano i parametri della riga di comando.

Importante

Se si è dietro una VPN, potrebbe invece essere necessario specificare l'indirizzo IP fornito tramite la VPN.

Screenshot dei risultati della riga di comando per il comando ipconfig

  1. Aprire Project Impostazioni dalla barra degli strumenti "Modifica" nella finestra principale dell'editor.

Screenshot dell'elenco a discesa Modifica con Project Impostazioni evidenziato

  1. Scorrere verso il basso il pannello sinistro fino a trovare l'intestazione Platforms (Piattaforme) e selezionare HoloLens.

Screenshot della sezione Platforms (Piattaforme) nel pannello Project Impostazioni sinistra con HoloLens evidenziato

  1. Verificare che nella sezione Capabilities (Funzionalità) sia selezionato "Internet Client", "Internet Client Server" (Server client Internet) e "Private Network Client Server" (Server client di rete privata).

Screenshot delle opzioni funzionalità con client Internet, server client Internet e server client di rete privata selezionati

Launch

  1. Aprire Project launcher dal pannello UE4 sotto il pulsante Launch (Avvia):

Screenshot delle opzioni di avvio con l'icona di avvio del progetto evidenziata

  1. Selezionare il + pulsante per creare un profilo personalizzato in Profili di avvio personalizzati. Una volta creato, è sempre possibile modificare questo profilo in un secondo momento:

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

  1. Selezionare il pulsante Modifica profilo nel HoloLens di avvio personalizzato. Nella sezione Build (Compilazione) selezionare Build UAT (Compila UAT) e impostare Additional Command Line Parameters (Parametri aggiuntivi della riga di comando).
    • Per iniziare, provare a eseguire queste operazioni: -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 di riferimento.

Nota

"IP_OF_YOUR_PC" è l'indirizzo IP trovato nel passaggio 1. Questo è l'indirizzo IP del computer che esegue Unreal Insights, NON l'indirizzo IP del HoloLens.

Importante

Le tracce possono raggiungere dimensioni molto grandi molto rapidamente. Abilitare solo i canali necessari per mantenere ridotte le dimensioni della traccia.

Screenshot delle opzioni di compilazione nella configurazione del profilo

  1. Selezionare Cook to the Book (Prepara in base al libro) per abilitare la copia nel dispositivo. Assicurarsi che le mappe siano selezionate in Mappe.

Screenshot delle opzioni di cook nella configurazione del profilo con cook del libro e HoloLens evidenziate

  1. Impostare How would you like to package the build (Come si vuole creare il pacchetto della compilazione) su Package & store locally (Archivia pacchetto in locale). Prendere nota del percorso del file scelto, che sarà necessario in seguito.

Screenshot delle opzioni del pacchetto nella configurazione del profilo impostata per creare un pacchetto e archiviare in locale

  1. Impostare Come si desidera distribuire la compilazione? su Non distribuire.

Screenshot delle opzioni di distribuzione nella configurazione del profilo con la distribuzione impostata su Non distribuire

  1. Selezionare Indietro per tornare alla radice della finestra di Project di avvio
  2. Nell'editor fare clic su Avvia nel profilo di avvio personalizzato

Screenshot dei profili di avvio personalizzati

  1. Osservare come viene compilato il progetto e quindi distribuire appxbundle (nel percorso del pacchetto del passaggio 5) nel HoloLens tramite il portale per dispositivi

  2. Avviare Unreal Insights. L'eseguibile Insights Unreal viene archiviato nella cartella del motore dei file binari, in genere come indicato di seguito: "C:\Programmi\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"

Screenshot dell'eseguibile di Unreal Insights in esecuzione

  1. Avviare l'app nel HoloLens.

Profilatura

Tornare a Unreal Insights selezionare la connessione in tempo reale al dispositivo per avviare la profilatura

Il profilo personalizzato viene condiviso tra i progetti. Da qui in avanti è possibile usare il profilo personalizzato creato invece di dover eseguire questa operazione ogni volta. È necessario ricreare la connessione al dispositivo solo ogni volta che si avvia Unreal con i passaggi da 3 a 6 nella sezione relativa alla configurazione.

Vedi anche