Profiler przestrzenny w Unreal Editor dla Fortnite | Fortnite Dokumentacja

Co nowego?

Widok drzewa pozwala wybrać wskaźniki, które chcesz mierzyć i uzyskać przegląd wyników.
System sesji umożliwia jednoczesne próbkowanie wielu źródeł.
Pasek wyszukiwania pozwala szybko znaleźć potrzebny wskaźnik.
Dla łatwiejszego porównania możesz otworzyć wiele zapisanych sesji, bez konieczności zamykania aktualnie uruchomionej sesji.
Możesz rejestrować wskaźniki jednocześnie z wielu źródeł.
Widok histogramu pozwala zapoznać się z rozkładem poszczególnych wskaźników w okresie próbkowania.
Do zapisanych plików automatycznie dodawane są przedrostki, aby ułatwić identyfikację sesji.

Unreal Editor dla Fortnite (UEFN) to zestaw narzędzi, których potrzebujesz, aby poznać wydajność projektu i ją poprawić. Fortnite działa na wielu platformach. Znając konkretne wskaźniki dotyczące projektu, będziesz w stanie wprowadzić konieczne zmiany, które zapewnią jego płynne działanie w UEFN.

Przejdź do Uruchom sesję próbkowania, aby zapoznać się z przepływem pracy, lub czytaj dalej, aby dowiedzieć się wszystkiego na temat narzędzia Profiler przestrzenny.

Przydatne pojęcia

Wskaźnik przestrzenny jest mierzony dla każdej właściwości, która wykorzystuje przestrzenną pozycję 3D w świecie. Składa się z określonej liczby wartości przestrzennych (z których każda zawiera liczbę odpowiadającą pomiarowi) wraz z powiązaną współrzędną, która nadaje pozycję przestrzenną, gdzie wartość była mierzona w obrębie świata.

Wartość przestrzenna to konkretny pomiar wskaźnika przestrzennego w lokalizacji 3D. Wartości przestrzenne obejmują trzy wartości współrzędnych przestrzennych X, Y, Z, a także wynikową wartość pomiaru. Wartości przestrzenne są agregowane w próbce wskaźnika przestrzennego.

Próbka wskaźnika przestrzennego to pomiar konkretnego wskaźnika przestrzennego przez określony czas. Może zawierać kilka zmierzonych wartości przestrzennych wraz z powiązanym wynikiem. Próbka zawiera również inne istotne dane, takie jak granice 3D otaczające wszystkie obejmujące wartości przestrzenne, użytą precyzję określania odległości i datę pobrania próbki.

Właściwości wskaźnika przestrzennego reprezentują dane zawarte w próbce wskaźnika przestrzennego:

Właściwość	Definicja
ID wskaźnika	Określa unikatowy identyfikator wskaźnika, który jest bezpośrednio powiązany z typem wskaźnika.
Wartość min.	Najniższa wartość spośród zarejestrowanych wartości przestrzennych.
Wartość maks.	Najwyższa wartość spośród zarejestrowanych wartości przestrzennych.
Wartość progowa	Maksymalna wartość oczekiwana dla danego wskaźnika.
Precyzja przestrzenna	Rozmiar komórki 3D (w jednostkach świata) używany po to, aby wszystkie zawarte wartości były uwzględniane w tej samej wartości przestrzennej. Zazwyczaj wybierana jest najwyższa wartość.
Jednostka	Jednostka używana przez rejestrowane wartości. Na przykład jednostką mogą być milisekundy w przypadku czasu lub metry w przypadku odległości.

Profiler przestrzenny to widżet wizualizacyjny, który przedstawia mapę aktywności (heatmap) 2D wskaźników przestrzennych. Można w nim również rejestrować, zapisywać i ładować próbki wskaźników przestrzennych. Pobiera dane z funkcji aktualizacji wskaźników przestrzennych, co oznacza, że dane są aktualizowane okresowo.

Edytor UEFN z zadokowanym oknem profilera przestrzennego.

Obecnie profiler przestrzenny obsługuje siedem wskaźników przestrzennych:

Metr	Definicja	Unit
Liczba poleceń rysowania	Śledzi liczbę poleceń rysowania w pojedynczej klatce	Polecenia rysowania
Liczba prymitywów	Śledzi liczbę typów prostych renderowanych w pojedynczej klatce. Typy proste to podstawowe komponenty rysunku używane do renderowania obiektów w 3D.	Prymitywy
Czas aktualizacji gry	Śledzi wątek gry dla danej platformy, mierząc czas potrzebny na zaktualizowanie pojedynczej klatki.	Mikrosekundy
Czas renderowania	Śledzi wątek renderowania dla danej platformy, mierząc czas potrzebny na zaktualizowanie pojedynczej klatki.	Mikrosekundy
Czas klatki	Śledzi czas poświęcony na aktualizację pojedynczej klatki. Wskaźnik ten obejmuje zarówno wskaźniki Czas aktualizacji gry, jak i Czas renderowania.	Mikrosekundy
Czas GPU	Śledzi czas GPU platformy.	Mikrosekundy
Czas RHI	Śledzi czas wątku interfejsu sprzętowego renderowania dla platformy.	Mikrosekundy
Liczba aktorów	Śledzi liczbę aktorów w świecie z uwzględnieniem zdarzeń streamingu. Jest to szczególnie przydatne w przypadku światów z włączonym streamingiem World Partition. Niespójności w liczbie aktorów na danym poziomie mogą wskazywać najważniejsze obszary rozgrywki. Jednak bardzo duża liczba aktorów może również być oznaką nadmiernej liczby małych aktorów i wskazywać punkt przygody o potencjalnie dużym obciążeniu. Dobrym pomysłem jest ocenianie tego wskaźnika łącznie z czasem aktualizacji gry, aby można było ocenić stopień złożoności logiki gry, lub łącznie z czasem renderowania, aby można było ocenić stopień złożoności renderowania.	Aktorzy
Liczba budynków	Specjalistyczna wersja wskaźnika Liczba aktorów, która śledzi liczbę aktorów zaklasyfikowanych jako budynki. Ta kategoria obejmuje też inne typy trwałych (persystentnych) aktorów siatki statycznej.	Aktorzy
Liczba pojemników z łupami	Specjalistyczna wersja wskaźnika Liczba aktorów, która śledzi liczbę aktorów zaklasyfikowanych jako pojemniki z łupem. Ta kategoria obejmuje takich aktorów, jak skrzynie, skrzynki z amunicją i inne generatory przedmiotów do podnoszenia.	Aktorzy
Liczba podnoszonych	Specjalistyczna wersja wskaźnika Liczba aktorów, która śledzi liczbę aktorów zaklasyfikowanych jako przedmioty do podnoszenia. Ta kategoria obejmuje możliwe do zdobycia przedmioty rozgrywki.	Aktorzy
Zużycie pamięci	Śledzi użycie wykonywalnej pamięci dla danej platformy. Możesz go użyć, aby ocenić wymagania dotyczące pamięci dla każdej z platform, na których ma być uruchamiana przygoda.	Kilobajty
Dostępna pamięć	Śledzi dostępną pamięć fizyczną platformy. Możesz go użyć, aby ocenić wymagania dotyczące pamięci dla każdej z platform, na których ma być uruchamiana przygoda.	Kilobajty

UI profilera przestrzennego

Profiler przestrzenny to możliwy do zadokowania, samodzielny widżet, który jest podzielony na cztery obszary:

Obszary widżetu profilera przestrzennego.

Pasek narzędzi z elementami sterującymi
Widok mapy aktywności (heatmap)
Widok drzewa wskaźników
Widok histogramu

Ten obszar zawiera główne elementy interaktywne służące do obsługiwania profilera przestrzennego. Umożliwia sterowanie tworzeniem, wizualizowaniem i zapisywaniem próbek wskaźników przestrzennych. Możesz wykorzystywać pobrane przez siebie próbki do generowania danych, które pomogą usprawnić Twoją przygodę UEFN.

Elementy paska narzędzi z elementami sterującymi profilera przestrzennego.

Pasek narzędzi z elementami sterującymi zawiera:

Rozpocznij próbkowanie: ten przycisk rozpoczyna przechwytywanie wybranego przez użytkownika zestawu wskaźników. Do próbkowania wskaźników konieczne jest połączenie z sesją UEFN. W czasie próbkowania mapa aktywności automatycznie wyśrodkowuje widok na lokalizacji pionka gracza w sesji i koncentruje się na przechwytywanych wartościach przestrzennych.
Zatrzymaj próbkowanie: ten przycisk kończy przechwytywanie wybranych wskaźników.
Otwórz Plik próbki: ten przycisk otwiera już istniejący plik próbki, który może zawierać wiele wskaźników. Przy otwieraniu wszystkie ładowane wskaźniki są ładowane do przeglądarki wskaźników, aby umożliwić dostęp do danych.
Zapisz próbkę do pliku: możesz użyć tego przycisku, aby zapisać aktywne sesje profilowania. Otwiera okno dialogowe zapisu do pliku i domyślnie proponuje nazwę pliku zawierającą znacznik czasu próbki. Profiler przestrzenny zapisuje w pliku docelowym wszystkie wskaźniki objęte aktualną sesją próbkowania.
Selektor sesji UEFN: z sesją można połączyć więcej niż jednego klienta. Możesz użyć selektora sesji, aby wybrać sesję, z którą chcesz nawiązać połączenie na potrzeby pomiaru wskaźników. Podczas uruchamiania sesji profiler przestrzenny automatycznie łączy się z klientem, a następnie aktualizuje selektor sesji przy użyciu nazwy użytkownika połączonego z tą sesją.
Ustawienia: ten przycisk wyświetla ustawienia preferencji profilera przestrzennego. Możesz go użyć, aby przełączyć widoczność określonych elementów widżetu.

Widok drzewa wskaźników

W tej sekcji możesz zaznaczyć i odznaczyć wskaźniki, które chcesz uwzględnić w sesji próbkowania, klikając pola wyboru z lewej strony wskaźników.

Górne pole listy rozwijanej służy do wyboru między sesją na żywo a wcześniej zapisaną sesją. Możesz przełączać między bieżącą sesją próbkowania i zapisaną sesją, wybierając sesję, którą chcesz wyświetlić z menu rozwijanego.

Drugie pole listy rozwijanej pozwala przełączać między celami próbkowania w aktywnej sesji, takimi jak klienci lub serwer. Możesz monitorować wskaźniki dla wszystkich połączonych klientów i próbkować wiele źródeł jednocześnie.

Pasek wyszukiwania pozwala wyszukać konkretne wskaźniki.

Gdy klikniesz wskaźnik w celu jego wybrania, widok mapy aktywności aktualizuje się, aby pokazać próbki danych, a widok statystyk zostanie zaktualizowany, aby wyświetlić zbiorcze statystyki danych. Kolorowe kółka obok każdego wskaźnika reprezentują ich względne wartości oparte na progach ustawionych przed sesją próbkowania, pokazując wyniki na zasadzie widoku poglądowego.

Liczba poleceń rysowania jest wybrana i wyświetlana na mapie aktywności.

Widok mapy aktywności (heatmap)

Widok mapy aktywności wyświetla mapę aktywności wybranego wskaźnika wraz z nakładką wszystkich wartości przestrzennych zawartych w próbce. Poszczególne wartości przestrzenne są kolorowane zgodnie z danymi zawartymi w próbce. Możesz szybko ustawić wartości odcięcia dla każdego wskaźnika, aby określić zakres oczekiwanych wartości.

Możesz wchodzić w interakcję z mapą aktywności i dostosowywać ją do własnych preferencji przy użyciu czterech znajdujących się u góry przycisków:

Menu hamburgerowe
Pokaż opcje
Fokus na graczu
Granice fokusu

Podwójne kliknięcie dowolnej lokalizacji w widoku mapy aktywności umieści kamerę edytora w odpowiadającej jej lokalizacji w projekcie. Jeśli sesja jest uruchomiona, pionek gracza teleportuje się do lokalizacji, na której wykonano podwójne kliknięcie.

Ten przycisk daje dostęp do opcji wizualizacji mapy aktywności, które obejmują dwie sekcje:

Ustawienia wskaźników
Ustawienia kolorów mapy aktywności (heatmap)

Opcje menu hamburgerowego dotyczące profilera przestrzennego.

Aby zresetować ustawienia w tych sekcjach, możesz kliknąć przycisk strzałki resetu po prawej stronie każdego pola.

Ustawienia wskaźników

Ustawienia wskaźnika grupują wszystkie ustawienia wpływające na wizualizację wskaźników.

WARTOŚĆ	Definicja
Próg	Wartość progowa określa oczekiwaną wartość maksymalną dla normalnej rozgrywki.
Jednostka wyświetlania	Jeśli zostanie określona, ta opcja określa preferowaną jednostkę wizualizacji dla wskaźnika. Jeśli pozostawisz tę pozycję nieokreśloną, narzędzie wybierze najlepiej dopasowaną jednostkę dla każdego wskaźnika. Jednostka wyświetlania wpływa na jednostki używane w widoku mapy aktywności i widoku podsumowania.
Metoda komórkowa	To ustawienie określa metodę redukcji używaną przez narzędzie do obliczania wartości każdej komórki 2D z listy wartości, które mieszczą się w granicach każdej komórki. Dostępne metody redukcji to: Mediana (domyślna) Wartość min. Wartość maks. Wartość średnia
Rozmiar komórki	To ustawienie zmienia rozmiar ustawienia siatki i może zwiększyć lub zmniejszyć poziom szczegółów w określonym obszarze próbkowania.

Ustawienia kolorów mapy aktywności (heatmap)

Ustawienia kolorów mapy aktywności (heatmap) zawierają wszystkie ustawienia wpływające na wizualizację wskaźników.

Sekcja Kolory aktywności oferuje czytelną paletę kolorów, w przypadku której uwzględniono potrzeby osób z zaburzeniami rozpoznawania barw. Możesz określić kolory kluczy, aby dostosować zakres kolorystyczny mapy aktywności.

WARTOŚĆ	Definicja
Niska	Ten kolor reprezentuje dolną część spektrum zakresu kolorystycznego mapy aktywności i jest mapowany na wartość minimalną w próbce wskaźnika.
Średnie	Ten kolor reprezentuje środkową część spektrum zakresu kolorystycznego mapy aktywności określony między kolorem Minimum a kolorem Próg. Jeśli nie została określona wartość progowa, jest mapowany na medianę wartości przestrzennej w próbce.
Wysoki	Ten kolor reprezentuje wszystkie wartości, które przekraczają ustaloną wartość progową.
Maks.	Ten kolor reprezentuje wartość maksymalną. Jest wyświetlany tylko wtedy, gdy użytkownicy określą wartość progową dla przedstawianego wskaźnika. Jeśli określisz wartość progową, mapa aktywności dodaje zakres, który przekracza próg, przechodząc od koloru białego do koloru ustawionego jako Maksimum.
Min. alfa	Wartość początkowa przypisywana wartościom przestrzennym. Wartość alfa wszystkich wartości przestrzennych w próbce wzrasta zgodnie z ich wartością – od wartości Minimum (wykorzystującej wartość Min. alfa) do wartości Maksimum lub Próg z maksymalną wartością alfa. Wykorzystanie niskiej wartości Min. alfa spowoduje podświetlenie wartości znajdujących się bliżej wartości Maksimum lub Próg poprzez zmniejszenie widoczności niskich wartości przestrzennych.
Maks. alfa	Maksymalna wartość początkowa przypisywana wartościom przestrzennym.

Ustawienia alfa przedstawiają wartości przestrzenne znajdujące się poza oczekiwanym zakresem. Dostosowanie tych opcji może okazać się szczególnie przydatne w przypadku analizy próbki wskaźnika zawierającej gniazda wartości przestrzennych o wysokiej gęstości, ponieważ umożliwi bardziej szczegółowy odczyt wskaźników.

Topory

Ta opcja przełącza wizualizację osi 3D w lewym dolnym rogu odpowiadającą orientacji „od góry do dołu” mapy aktywności. To orientacja odpowiada widokowi minimapy klienta, a nie edytora.

Wyświetlanie osi mapy aktywności

Siatka

Przełącza wizualizację siatki mapy aktywności 2D, dzieląc widoczną przestrzeń na wielokrotności zakresów wartości próbki. Rozmiar siatki można zmienić w menu hamburgerowym

Brak siatki

Pokaż siatkę

Legenda mapy aktywności

Ta opcja włącza lub wyłącza wizualizację legendy zakresu kolorów mapy aktywności w prawym dolnym rogu widoku mapy aktywności.

Wyświetlanie legendy palety kolorów mapy aktywności

Granice

Ta opcja umożliwia włączenie sześcianu ograniczającego 2D, który obejmuje wszystkie wartości przestrzenne zawarte w próbce.

Wyświetlanie granic próbki (białe) na mapie aktywności

Fokus na graczu

Ten przycisk wyśrodkowuje widok wokół pionka gracza w połączonej sesji. To działanie wymaga połączonej sesji.

Granice fokusu

Ten przycisk wyśrodkowuje widok mapy aktywności wokół sześcianu ograniczającego 2D.

Aby uzyskać dostęp do menu kontekstowego, możesz kliknąć prawym przyciskiem obszar mapy aktywności. To menu zawiera następujące opcje:

Teleportuj się
Widok domyślny
Granice fokusu
Śledź lokalizację fokusa

Menu kontekstowe widoku mapy aktywności profilera przestrzennego

Teleportuj się

Możesz skorzystać z tej opcji, aby przenieść zarówno pole widzenia kamery, jak i pionka gracza do wybranej lokalizacji, którą kliknięto prawym przyciskiem w widoku mapy aktywności. To działanie wymaga połączonej sesji, aby można było teleportować pionka gracza. W przypadku braku połączonej sesji będzie to równoznaczne z podwójnym kliknięciem dowolnej lokalizacji w widoku mapy aktywności, które umieści kamerę edytora w odpowiadającej jej lokalizacji w projekcie.

Widok domyślny

Ta opcja resetuje wartości fokusu i powiększania widoku mapy aktywności do wartości domyślnych.

Widok histogramu

Histogram ułatwia wizualizację danych w trakcie ich gromadzenia w czasie rzeczywistym. Możesz cofnąć się do swojego testu poziomu i ocenić każdy wskaźnik w konkretnym momencie testu gry. Przewijając histogram otwartej sesji, możesz zidentyfikować lokalizację konkretnego odczytu, który chcesz zbadać.

Dostosowanie wartości w menu hamburgerowym spowoduje zmodyfikowanie różnych punktów odcięcia wyświetlanych na histogramie.

Kliknięcie histogramu prawym przyciskiem myszy umożliwia wybranie opcji Pokaż wytyczne dotyczące progów, Automatyczne przewijanie, Cieniuj wartości wg komórki, wybierz wartości Następny i Poprzedni oraz Skaluj histogram. Skalę histogramu można zmienić, trzymając wciśnięty klawisz Shift i przewijając kółkiem myszy.

Kliknięcie histogramu prawym przyciskiem myszy powoduje wyświetlenie powyższych opcji.

Możesz także powiększać i pomniejszać histogram, aby uzyskać bardziej szczegółowy przegląd swoich wskaźników.

Większe pomniejszenie

Większe przybliżenie

Gdy najedziesz kursorem myszy na segment próbki, podpowiedź wyświetli jego wartość.

Kliknięcie przykładowego segmentu spowoduje podświetlenie lokalizacji segmentu na mapie aktywności (heatmap).

Z prawej strony histogramu znajduje się podsumowanie statystyk dla wybranego wskaźnika. Zawiera następujące statystyki uzyskane z wartości przestrzennych zawartych w próbce:

Statystyka	Definicja
Wartości	Łączna liczba wartości przestrzennych zawartych w próbce.
Wysoki	Liczba wartości przestrzennych przekraczających wartość progową (o ile została określona).
Wartość min.	Najmniejsza wartość przestrzenna.
Wartość maks.	Największa wartość przestrzenna.
Wartość średnia	Średnia wartość przestrzenna.
Mediana	Mediana wartości przestrzennych.

Uruchom sesję próbkowania

W tej sekcji opisano, jak można uruchomić sesję próbkowania z użyciem narzędzia Profiler przestrzenny, a także, jak można zapisać próbkę wskaźnika przestrzennego.

Wybierz kolejno Narzędzia > Wskaźniki przestrzenne > Profiler przestrzenny. Otworzy się widżet profilera przestrzennego.
W widoku drzewa wybierz wskaźniki, które chcesz mierzyć w sesji próbkowania.
Z poziomu menu hamburgerowego możesz ustawić własne parametry próbkowania.
Kliknij Uruchom sesję, aby rozpocząć grę za pośrednictwem klienta Fortnite.
(Opcjonalnie) Po załadowaniu klienta naciśnij Zakończ grę, aby przejść do Trybu edycji, co pozwoli pionkowi szybciej przelecieć przez poziom.
Naciśnij Rozpocznij próbkowanie.
W trakcie sesji gry użyj swojego pionka, aby biegać po wyspie i rozgrywać grę zgodnie z założeniami. Mapa aktywności profilera przestrzennego będzie aktualizowana w miarę wykonywania czynności.
Naciśnij przycisk Zatrzymaj próbkowanie, aby zakończyć sesję próbkowania.
Naciśnij ikonę Zapisz w widżecie profilera przestrzennego i wybierz lokalizację w katalogu lokalnym projektu. Profiler przyznaje dostęp do odczytu do wszystkich próbek zapisanych w projekcie. Próbki są porządkowane według typu wskaźnika i znacznika czasu.
Aby uzyskać dostęp do poprzednich nagrań próbek w projekcie, możesz kliknąć ikonę Otwórz.