Novità?
La visualizzazione ad albero ti permette di selezionare le metriche che vuoi misurare e ottenere risultati a colpo d'occhio.
Il sistema Sessione ti permette di campionare più sorgenti contemporaneamente.
La barra di ricerca ti consente di trovare rapidamente la metrica richiesta.
Puoi aprire più sessioni salvate per un confronto più semplice, senza dover chiudere la sessione attualmente in esecuzione.
Puoi acquisire metriche contemporaneamente da più sorgenti.
La visualizzazione a istogramma ti permette di approfondire la distribuzione di ogni metrica nel periodo di campionamento.
I prefissi vengono aggiunti automaticamente ai file salvati per facilitare l'identificazione delle sessioni.
Unreal Editor per Fortnite (UEFN) ti fornisce gli strumenti necessari per comprendere e migliorare le prestazioni del tuo progetto. Dato che Fortnite viene eseguito su molte piattaforme, conoscere le metriche specifiche per il tuo progetto significa poter apportare tutte le modifiche necessarie per garantire prestazioni fluide in tutte le tue esperienze UEFN.
Vai a Avvia una sessione di campionamento per una rapida occhiata al flusso di lavoro, oppure continua a leggere per un approfondimento sullo strumento Profilatore spaziale.
Termini utili
Una Metrica spaziale viene misurata per qualsiasi proprietà che utilizza una posizione spaziale 3D in un mondo. Si tratta di un certo numero di valori spaziali, ognuno dei quali ha un numero che corrisponde a una misurazione, con una coordinata associata che indica la posizione spaziale in cui il valore è stato misurato all'interno del mondo.
Un Valore spaziale è una misura concreta di una metrica spaziale in una posizione 3D. I valori spaziali presentano tre valori di coordinate spaziali X, Y, Z e un valore risultato della misurazione. I valori spaziali vengono aggregati in un campione metrico spaziale.
Un Campione metrico spaziale è una misurazione di una metrica spaziale concreta in un periodo definito. Può contenere diversi valori spaziali misurati con un risultato associato. Un campione include anche altri dati rilevanti, ad esempio i limiti 3D che racchiudono tutti i valori spaziali racchiusi, la precisione della distanza utilizzata e la data in cui è stato registrato.
Le Proprietà metriche spaziali rappresentano tutte le informazioni incluse in un campione di metriche spaziali:
| Proprietà | Definizione |
|---|---|
ID metrica | Definisce l'identificativo univoco della metrica che è direttamente legato al tipo di metrica. |
Valore min | Valore minimo tra i valori spaziali registrati. |
Valore max | Valore massimo tra i valori spaziali registrati. |
Valore soglia | Valore massimo previsto per la metrica. |
Precisione spaziale | Dimensione della cella 3D utilizzata in unità del mondo in modo che tutti i valori contenuti contribuiscano allo stesso valore spaziale. Di solito viene selezionato il valore più alto. |
Unità | Unità utilizzata dai valori registrati, ad esempio millisecondi per il tempo o metri per la distanza. |
Il Profilatore spaziale è un widget di visualizzazione che fornisce una mappa di calore 2D delle metriche spaziali. Qui puoi anche registrare, salvare e caricare campioni di metrica spaziale. Raccoglie i dati dalla funzione di aggiornamento delle metriche spaziali, il che significa che i dati vengono aggiornati periodicamente.
Editor UEFN con la finestra Profilatore spaziale ancorata.
Il Profilatore spaziale attualmente supporta sette metriche spaziali:
| Metrica | Definizione | Unit |
|---|---|---|
Conteggio draw call | Tiene traccia del numero di draw call in un singolo frame | Draw call |
Conteggio primitive | Tiene traccia del numero di primitive renderizzate in un singolo frame. Le primitive sono i componenti di disegno di base utilizzati per il rendering di oggetti in 3D. | Primitive |
Tempo di aggiornamento del gioco | Tiene conto del thread di gioco della piattaforma misurando il tempo necessario per aggiornare un singolo frame. | Microsecondi |
Tempo di rendering | Tiene conto del thread di rendering della piattaforma misurando il tempo necessario per aggiornare un singolo frame. | Microsecondi |
Durata frame | Tiene traccia del tempo impiegato per aggiornare un singolo frame. Sia il tempo di aggiornamento della partita che il tempo di rendering sono inclusi in questa metrica. | Microsecondi |
Tempo GPU | Traccia il tempo della GPU della piattaforma. | Microsecondi |
Tempo di RHI | Tiene traccia del tempo di thread dell'interfaccia hardware di rendering della piattaforma. | Microsecondi |
Conteggio attori | Tiene traccia del numero di attori nel mondo che si occupano di eventi in streaming. Ciò risulta particolarmente utile per i mondi con lo streaming World Partition abilitato. Vedere il numero di attori incoerenti nel livello può evidenziare le aree più importanti del gameplay. Tuttavia, un numero di attori molto elevato può anche indicare un numero eccessivo di piccoli attori e un potenziale punto di stress per l'esperienza. È una buona idea valutare questa metrica insieme al Tempo di aggiornamento del gioco per valutare la complessità della logica di gioco o al Tempo di rendering per valutare la complessità del rendering. | Actor |
Conteggio degli edifici | Una versione specializzata della metrica Conteggio attori che tiene traccia del numero di attori che sono stati classificati come edifici. Questa categoria include anche altri tipi di attori con mesh statica persistenti. | Actor |
Conteggio contenitori di bottino | Una versione specializzata della metrica Conteggio attori che tiene traccia del numero di attori che sono stati classificati come contenitori di bottino. Questa categoria include attori come forzieri, scatole di munizioni e altri generatori di oggetti raccoglibili. | Actor |
Conteggio degli oggetti raccoglibili | Una versione specializzata della metrica Conteggio attori che tiene traccia del numero di attori che sono stati classificati come oggetti raccoglibili. Questa categoria include oggetti di gameplay utilizzabili come bottino. | Actor |
Consumo di memoria | Traccia l'utilizzo della memoria eseguibile della piattaforma. Puoi utilizzarlo per valutare i requisiti di memoria di ogni piattaforma su cui deve essere eseguita l'esperienza. | Kilobyte |
Memoria disponibile | Tiene traccia della memoria fisica disponibile della piattaforma. Puoi utilizzarlo per valutare i requisiti di memoria di ogni piattaforma su cui deve essere eseguita l'esperienza. | Kilobyte |
UI del profilatore spaziale
Il Profilatore spaziale è un widget standalone ancorabile suddiviso in quattro aree:
Aree del widget di Profilatore spaziale.
Barra degli strumenti di controllo
Visualizzazione mappa di calore
Visualizzazione ad albero delle metriche
Visualizzazione a istogramma
Barra degli strumenti di controllo
Questa area contiene i principali elementi interattivi per il funzionamento di Profilatore spaziale. Fornisce i controlli per produrre, visualizzare e salvare esempi di Metriche spaziali. Puoi utilizzare i campioni acquisiti per generare dati che possano migliorare la tua esperienza UEFN.
Elementi della barra degli strumenti di controllo di Profilatore spaziale.
La barra degli strumenti di controllo include i seguenti elementi:
Inizia il campionamento: questo pulsante avvia l'acquisizione dell'insieme di metriche selezionate dall'utente. Per campionare le metriche devi essere connesso a una sessione UEFN. Durante il campionamento, la mappa di calore centra automaticamente la vista sulla posizione della pedina della sessione e si concentra sui valori spaziali acquisiti.
Interrompi campionamento: questo pulsante interrompe l'acquisizione delle metriche selezionate.
Apri un file di esempio: questo pulsante apre un file di esempio preesistente, che può contenere più metriche. All'apertura, tutte le metriche caricate vengono caricate nel browser delle metriche in modo che tu possa valutare i dati.
Salva un campione su file: puoi utilizzare questo pulsante per salvare le sessioni di profilazione attive. Apre una finestra di dialogo per il salvataggio su file e propone un nome di file con il timestamp del campione per impostazione predefinita. Profilatore spaziale salva tutte le metriche della sessione di campionamento corrente nel file di destinazione.
Selettore di sessione UEFN: puoi avere più di un client connesso a una sessione. Puoi utilizzare il selettore di sessione per scegliere quale sessione connettere ed eseguire le metriche. Profilatore spaziale si connette automaticamente al client quando avvia una sessione e aggiorna il selettore di sessione con il nome dell'utente connesso a tale sessione.
Impostazioni: questo pulsante visualizza le impostazioni delle preferenze di Profilatore spaziale. Puoi utilizzare questa opzione per attivare la visibilità di alcuni elementi del widget.
Visualizzazione ad albero delle metriche
Questa sezione ti permette di selezionare e deselezionare le metriche desiderate nella sessione di campionamento facendo clic sulle caselle di controllo a sinistra delle metriche.
Il campo a discesa in alto viene utilizzato per scegliere tra una sessione live e una sessione salvata in precedenza. Puoi passare dalla sessione di campionamento corrente a una sessione salvata selezionando la sessione che desideri visualizzare dal menu a discesa.
Con il secondo campo a discesa, puoi passare da un obiettivo di campionamento all'altro nella sessione live, come i client o il server. Puoi monitorare le metriche di tutti i client connessi e campionare più origini contemporaneamente.
La barra di ricerca ti consente di cercare una metrica specifica.
Quando fai clic su una metrica per selezionarla, la vista Heatmap si aggiorna per mostrare eventuali campioni di dati e la vista Statistiche si aggiorna per visualizzare le statistiche aggregate per i dati. I cerchi colorati accanto a ogni metrica rappresentano i loro valori relativi in base alle soglie impostate prima della sessione di campionamento, mostrando i risultati a colpo d'occhio.
Visualizzazione mappa di calore
La visualizzazione mappa di calore mostra una mappa di calore della metrica scelta, con una sovrapposizione di tutti i valori spaziali del campione. Ciascun valore spaziale è colorato in base ai dati del campione. Puoi impostare rapidamente dei valori limite per ogni metrica per definire l'intervallo dei valori previsti.
Puoi interagire con la mappa di calore e personalizzarla in base alle tue preferenze utilizzando i quattro pulsanti in alto:
Menu hamburger
Mostra opzioni
Inquadra giocatore
Limiti del focus
Facendo due volte clic su un punto qualsiasi della visualizzazione mappa di calore, la telecamera dell'Editor si posiziona nel punto corrispondente del progetto. Se viene avviata una sessione, la pedina del giocatore si teletrasporta nella posizione in cui fai due volte clic.
Menu hamburger
Questo pulsante ti dà accesso alle opzioni di visualizzazione mappa di calore che contiene due sezioni:
Impostazioni metrica
Impostazioni di colore mappa di calore
Opzioni del menu hamburger di Profilatore spaziale.
Puoi reimpostare le impostazioni di queste sezioni facendo clic sulla freccia di reimpostazione sul lato destro di ogni campo.
Impostazioni metrica
Le Impostazioni metrica raggruppano tutte le impostazioni che influenzano la visualizzazione delle metriche.
| Valore | Definizione |
|---|---|
Soglia | Un valore di soglia definisce il valore massimo previsto per un gameplay normale. |
Unità visualizzata | Quando specificata, questa opzione definisce l'unità di visualizzazione preferita per una metrica. Se non viene specificato, lo strumento seleziona l'unità di misura più adatta per ogni metrica. L'unità di visualizzazione influisce sulle unità utilizzate dalla visualizzazione Heatmap e dalla visualizzazione riepilogo. |
Metodo cella | Questa impostazione specifica il metodo di riduzione utilizzato dallo strumento per calcolare ogni valore di cella 2D dall'elenco di valori che rientrano nei limiti di ogni cella. I metodi di riduzione disponibili sono:
|
Dimensioni cella | Questa impostazione modifica le dimensioni della griglia e può aumentare o diminuire il livello di dettaglio di una particolare area di campionamento. |
Impostazioni di colore mappa di calore
Le Impostazioni colore mappa di calore contengono tutte le impostazioni che influenzano la visualizzazione delle metriche.
I Colori di calore offrono una tavolozza di colori leggibile, tenendo conto del daltonismo. Puoi definire i colori chiave per personalizzare la gamma di colori della mappa di calore.
| Valore | Definizione |
|---|---|
Ridotta | Questo colore rappresenta lo spettro basso della gamma di colori della mappa di calore e corrisponde al valore minimo in un campione metrico. |
Punto medio | Questo colore rappresenta il centro della gamma di colori della mappa di calore definita tra il colore minimo e il colore soglia. Se non viene specificato un valore di soglia, esso corrisponde al valore spaziale mediano di un campione. |
Elevata | Questo colore rappresenta tutti i valori che sono al di sopra della soglia impostata. |
Max | Questo colore rappresenta il valore massimo. Viene visualizzato solo quando gli utenti definiscono un valore di soglia per la metrica rappresentata. Quando specifichi un valore di soglia, la mappa di calore aggiunge un intervallo che supera la soglia, passando dal bianco al colore impostato per il massimo. |
Alfa min | Valore iniziale dato ai valori spaziali. Il valore alfa di tutti i valori spaziali di un campione aumenta in base al suo valore, a partire dal valore minimo (utilizzando Alfa min) fino ai valori massimi o di soglia con alfa massimo. L'utilizzo di un valore Alfa min basso mette in evidenza i valori spaziali più vicini ai valori massimo o soglia, rendendo meno visibili i valori spaziali bassi. |
Alfa max | Valore massimo iniziale dato ai valori spaziali. |
Le Impostazioni Alpha mostrano i valori spaziali al di fuori dell'intervallo previsto. La regolazione di queste opzioni diventa particolarmente utile quando si guarda un campione di metriche con tasche di valori spaziali ad alta densità, in quanto è possibile ottenere una lettura più granulare delle metriche.
Asce
Questa opzione attiva la visualizzazione degli assi 3D nell'angolo in basso a sinistra corrispondente all'orientamento della visualizzazione mappa di calore dall'alto verso il basso. Questo orientamento è in linea con la vista della minimappa del cliente e non con quella dell'editor.
Visualizzazione degli assi della mappa di calore
Griglia
Alterna la visualizzazione della griglia della mappa di calore 2D, suddividendo lo spazio visibile in multipli dell'estensione del valore del campione. La dimensione della griglia può essere modificata nel menu hamburger
Legenda della mappa di calore
Questa opzione attiva o disattiva la visualizzazione della legenda della gamma di colori della mappa di calore nell'angolo in basso a destra della visualizzazione mappa di calore.
Visualizzazione della legenda della tavolozza dei colori della mappa di calore
Limiti
Questa opzione ti permette di attivare il riquadro di delimitazione 2D che comprende tutti i valori spaziali del campione.
Mostra i limiti del campione (in bianco) sulla mappa di calore
Inquadra giocatore
Questo pulsante centra la visualizzazione intorno alla pedina del giocatore nella sessione connessa. Questa azione richiede una sessione connessa.
Limiti del focus
Questo pulsante centra la visualizzazione mappa di calore intorno al riquadro di delimitazione 2D.
Menu contestuale
Puoi accedere al menu contestuale facendo clic con il tasto destro del mouse sull'area della visualizzazione mappa di calore. Questo menu contiene le seguenti opzioni:
Teletrasporto
Visualizzazione predefinita
Limiti del focus
Traccia la posizione del focus
Menu contestuale visualizzazione mappa di calore di Profilatore spaziale
Teletrasporto
Puoi utilizzare questa opzione per portare sia la visuale della telecamera che la pedina del giocatore in un punto scelto con il tasto destro del mouse nella visualizzazione mappa di calore. Questa azione richiede una sessione connessa per teletrasportare la pedina del giocatore. Se non è presente una sessione collegata, ciò equivale a fare due volte clic su un punto qualsiasi della visualizzazione mappa di calore che posiziona la telecamera dell'Editor nel punto corrispondente del progetto.
Visualizzazione predefinita
Questa opzione reimposta i valori di messa a fuoco e di zoom della visualizzazione mappa di calore alle impostazioni predefinite.
Visualizzazione a istogramma
L'istogramma ti aiuta a visualizzare i dati mentre vengono raccolti in tempo reale. Puoi tornare indietro nel test del livello e valutare ogni metrica in un punto specifico del playtest. Scorrendo l'istogramma della sessione aperta puoi identificare la posizione di una particolare lettura su cui desideri indagare.
La regolazione dei valori nel menu Hamburger modificherà i vari punti cutoff visualizzati nell'istogramma.
Facendo clic con il tasto destro del mouse sull'istogramma puoi selezionare Visualizza linee guida soglia, Scorrimento automatico, Ombreggia i valori per cella, scegli i valori Successivo e Precedente e Scala istogramma. Puoi modificare la scala dell'istogramma tenendo premuto il tasto Maiusc + scorrendo la rotellina del mouse.
Puoi anche ingrandire e rimpicciolire l'istogramma per avere un aspetto più dettagliato delle tue metriche.
Quando passi il mouse su un segmento del campione, un tooltip ne visualizza il valore.
Facendo clic sul segmento campione si evidenzia la posizione del segmento sulla mappa di calore.
A destra dell'istogramma puoi visualizzare un riepilogo delle statistiche per la metrica selezionata. Mostra le seguenti statistiche compilate a partire dai valori spaziali del campione:
| Statistica | Definizione |
|---|---|
Valori | Numero totale di valori spaziali inclusi nel campione. |
Elevata | Numero di valori spaziali che superano il valore di soglia, se definito. |
Valore min | Valore spaziale più piccolo. |
Valore max | Valore spaziale più grande. |
Valore medio | Valore spaziale medio. |
Valore della mediana | Valore spaziale mediano. |
Avvia una sessione di campionamento
Questa sezione spiega come avviare una sessione di campionamento con lo strumento Profilatore spaziale e mostra come salvare il campione metrico spaziale.
Vai a Strumenti > Metriche spaziali > Profilatore spaziale. Si apre il widget Profilatore spaziale.
Nella visualizzazione ad albero, seleziona le metriche che vuoi misurare nella sessione di campionamento.
Imposta i parametri di campionamento dal menu hamburger.
Fai clic su Avvia sessione per avviare una partita attraverso il client di Fortnite.
(Opzionale) Una volta caricato il client, premi Fine partita per entrare nella Modalità modifica che permette alla tua pedina di volare più velocemente attraverso il livello.
Premi Inizia il campionamento.
Nella sessione della partita, utilizza la tua pedina per correre intorno all'isola e giocare come previsto. La heatmap del Profilatore spaziale si aggiornerà gradualmente.
Premi il pulsante Stop per terminare la sessione di campionamento.
Premi l'icona Salva sul widget Profilatore spaziale e scegli una posizione all'interno della directory locale del tuo progetto. Il profilatore fornisce l'accesso in lettura a qualsiasi campione salvato nel progetto. I campioni sono organizzati per tipo di metrica e timestamp.
Puoi fare clic sull'icona Apri per accedere alle registrazioni dei campioni dei progetti precedenti.
