Analiza Sceny

Narzędzie Analiza Sceny oferuje zestaw widoków w Roblox Studio, które dostarczają natychmiastowych informacji porównawczych na temat tego, jak są zbudowane twoje sceny klienta i serwera, jakie zasoby wykorzystują oraz które instancje są odpowiedzialne za to wykorzystanie zasobów. Analiza Sceny jest zaprojektowana do użytku podczas sesji gry i testowania, i może badać zarówno dane klienta, jak i serwera.

Włącz Analizę Sceny

W pasku menu wybierz Okno > Podsumowanie Wydajności > Analiza Sceny.

Użyj Analizy Sceny

Analiza Sceny jest zaprojektowana do użycia podczas sesji gry lub testowej. Otwórz okno Analizy Sceny i przeglądaj dostępne tryby. Kiedy tryb jest aktywny, widzisz wyświetlacz pudełek—widok mapy kwadratowej—pokazujący względne rozmiary zasobów, które są wyświetlane oraz instancji, które się do nich przyczyniają.

• Poniżej widoku mapy kwadratowej znajduje się lista wszystkich przedmiotów w bieżącym widoku.
• Klikając prawym przyciskiem myszy wybrany element w Analizie Sceny, zazwyczaj możesz przejść bezpośrednio do tego elementu w Eksploratorze.
• Możesz użyć paska wyszukiwania do filtrowania według nazwy w bieżącym wyświetleniu.

Tryby

Analiza Sceny ma wiele różnych trybów, z których każdy odpowiada innemu przypadkowi użycia.

Pamięć skryptu

Ten widok pokazuje, ile pamięci wykorzystuje każdy Script, LocalScript i ModuleScript w Luau VM. To jest pamięć używana przez tabele i inne alokacje skryptowe, a nie pamięć używana przez zasoby takie jak animacje, tekstury i dźwięki. Widok jest dalej podzielony według typowych lokalizacji, z których są wykonywane skrypty oraz przez Script w porównaniu do ModuleScript.

Instancje bez rodzica

Widok instancji bez rodzica pokazuje, które skrypty i moduły przechowują odniesienia do instancji, zliczone według typu.

Skrypty przechowujące odniesienia do instancji są normalne i same w sobie nie wskazują na błąd ani wyciek pamięci. Jednak, jeśli badassz wyciek pamięci, ten widok ułatwia zauważenie, czy skrypt robi coś, czego się nie spodziewałeś.

Jeśli nadal masz problemy z znalezieniem źródła wycieku pamięci, to narzędzie jest komplementarne do narzędzia Stos Luau, które może pokazać więcej informacji o pojedynczych alokacjach.

Kliknij prawym przyciskiem myszy dowolny skrypt w tym widoku, aby wybrać go bezpośrednio w Eksploratorze.

Kompozycja instancji

Widok kompozycji instancji pokazuje, które instancje są obecnie obecne u klienta lub serwera. To jest niezwykle cenne podczas pracy nad dużymi i skomplikowanymi konstrukcjami, ponieważ każda instancja ma zarówno koszty replikacji, jak i pamięci.

Kategorie, takie jak Postacie, Geometria i Tekstury, są zaprojektowane, aby pomóc ci zrozumieć, jak twoja scena jest zrównoważona. Na przykład, być może nie zamierzałeś mieć 25 000 emitentów cząstek, ale ten widok ci to uświadamia.

Ten widok również ułatwia wybór wszystkich instancji danego typu.

Pamięć audio

Widok pamięci audio pokazuje, ile pamięci każdy zasób audio obecnie konsumuje. Rzeczywista pamięć używana przez dany utwór audio jest dość złożona, ale w praktyce usunięcie wszystkich instancji odnoszących się do utworu audio pozwala na załadowanie tej pamięci.

Kliknij prawym przyciskiem myszy dowolny zasób audio w tym widoku, aby wybrać wszystkie instancje, które go używają.

Pamięć animacji

Zasoby animacji są jednym z najczęstszych źródeł wycieków pamięci w produkcji. Roblox jest agresywny w usuwaniu nieużywanych zasobów animacji, ale często zdarza się, że skrypty utrzymują animacje przy życiu po zniszczeniu ich modelu rodzica.

Podobnie jak w przypadku zasobów audio, usunięcie wszystkich instancji odnoszących się do zasobu animacji pozwala na załadowanie go.

Ten widok, w połączeniu z widokiem bez rodzica, ułatwia śledzenie cyklu życia animacji i jaką pamięć rzeczywiście wykorzystują.

Kliknij prawym przyciskiem myszy dowolną animację w tym widoku, aby wybrać wszystkie instancje, które ją używają.

Kompozycja trójkątów

Widok kompozycji trójkątów przedstawia bardziej szczegółowe zestawienie trójkątów i wywołań rysowania, które obecnie są renderowane w głównym widoku.

Te zestawienia obejmują zliczenia dla Cieni, Opaque, Transparent, Terrain, Grass, Particles, Sky i UI.

Te informacje kompozycyjne pomagają lepiej zrozumieć, jak geometrię twojej sceny i zidentyfikować przypadki, w których scena zawiera nieoczekiwaną geometrię.

API Silnika

Możesz również uzyskać dostęp do danych Analizy Sceny programowo za pomocą SceneAnalysisService, które jest udostępniane przez serwer MCP. Każda metoda zwraca tabele zawierające zagnieżdżone dzieci z tymi samymi danymi, które są używane przez wizualny wyświetlacz.