Análise de Cena

A ferramenta de Análise de Cena fornece um conjunto de visualizações no Roblox Studio que oferecem informações comparativas rápidas sobre como suas cenas de cliente e servidor estão montadas, quais recursos estão sendo utilizados e quais instâncias são responsáveis por esse uso de recursos. A Análise de Cena é projetada para ser usada durante sessões de jogo e teste, e pode inspecionar tanto os modelos de dados do cliente quanto do servidor.

Habilitar Análise de Cena

1. Habilite Análise de Cena em Arquivo > Recursos Beta.
2. Na barra de menus, selecione Janela > Resumo de Desempenho > Análise de Cena.

Usar Análise de Cena

A Análise de Cena é projetada para ser usada durante uma sessão de jogo ou teste. Abra a janela de Análise de Cena e navegue pelos modos disponíveis. Quando um modo está ativo, você vê uma exibição de caixas—a visão de treemap quadrada—mostrando os tamanhos relativos dos recursos sendo visualizados e as instâncias que estão contribuindo para eles.

• Abaixo da visão de treemap quadrada, há uma lista de todos os itens na visualização atual.
• Clicar com o botão direito em um item selecionado na Análise de Cena geralmente permite que você vá diretamente para esse item no Explorer.
• Você pode usar a barra de pesquisa para filtrar por nome na exibição atual.

Modos

A Análise de Cena tem muitos modos diferentes, cada um deles atendendo a um caso de uso distinto.

Memória de script

Essa visualização mostra quanta memória cada Script, LocalScript e ModuleScript está usando na VM Luau. Essa é a memória usada por tabelas e outras alocações de script, não a memória usada por ativos como animações, texturas e sons. A visualização é ainda mais detalhada pelas localizações comuns de onde os scripts são executados e por Script versus ModuleScript.

Instâncias sem pai

A visualização de instâncias sem pai mostra quais scripts e módulos estão mantendo referências a instâncias, como uma contagem por tipo.

Scripts que mantêm referências a instâncias é normal e não é, por si só, uma indicação de um bug ou vazamento de memória. No entanto, se você estiver investigando um vazamento de memória, essa visualização facilita a detecção se um script estiver fazendo algo que você não esperava.

Se você ainda estiver tendo dificuldades para encontrar a causa raiz de um vazamento de memória, essa ferramenta complementa a ferramenta de heap Luau, que pode mostrar mais informações sobre alocações individuais.

Clique com o botão direito em qualquer script nessa visualização para selecioná-lo diretamente no Explorer.

Composição de instância

A visualização de composição de instância mostra quais instâncias estão atualmente presentes no cliente ou servidor. Isso é inestimável ao trabalhar em construções grandes e complexas, pois cada instância tem custos de replicação e memória.

As categorias, como Personagens, Geometria e Texturas, são projetadas para ajudar você a entender como sua cena está balanceada. Por exemplo, talvez você não quisesse ter 25.000 emissores de partículas, mas essa visualização deixa você ciente disso.

Essa visualização também facilita a seleção de todas as instâncias de um determinado tipo.

Memória de áudio

A visualização de memória de áudio mostra quanta memória cada ativo de áudio está consumindo atualmente. A memória real usada por uma determinada faixa de áudio é bastante complexa, mas, em termos práticos, excluir todas as instâncias que fazem referência a uma faixa de áudio permite que essa memória seja descarregada.

Clique com o botão direito em qualquer ativo de áudio nessa visualização para selecionar todas as instâncias que estão usando-o.

Memória de animação

Ativos de animação são uma das fontes mais comuns de vazamentos de memória em produção. O Roblox é agressivo em descarregar ativos de animação não utilizados, mas é comum que scripts mantenham animações ativas após o modelo pai ter sido destruído.

Assim como com ativos de áudio, excluir todas as instâncias que fazem referência a um ativo de animação permite que ele seja descarregado.

Essa visualização, juntamente com a visualização de instâncias sem pai, torna fácil rastrear o ciclo de vida das animações e quanta memória elas realmente estão usando.

Clique com o botão direito em qualquer animação nessa visualização para selecionar todas as instâncias que estão usando-a.

Composição triangular

A visualização de composição triangular fornece uma detalhamento mais detalhado dos triângulos e chamadas de renderização que estão sendo renderizadas atualmente na viewport principal.

Esses detalhamentos incluem contagens para Sombras, Opaco, Transparente, Terreno, Grama, Partículas, Céu e UI.

Essas informações composicionais ajudam você a entender melhor como a geometria da sua cena é composta e identificar casos onde a cena contém geometria inesperada.

API do Motor

Você também pode acessar os dados de Análise de Cena programaticamente através de SceneAnalysisService, que é exposto através do servidor MCP. Cada método retorna tabelas contendo filhos aninhados com os mesmos dados que a exibição visual usa.