A ferramenta de Análise de Cena fornece um conjunto de visualizações no Roblox Studio que oferecem informações comparativas de relance sobre como suas cenas de cliente e servidor estão montadas, quais recursos estão utilizando e quais instâncias são responsáveis por esse uso de recursos. A Análise de Cena é projetada para ser usada durante as sessões de jogo e teste, e pode inspecionar tanto os modelos de dados do cliente quanto do servidor.
Ativar Análise de Cena
Na barra de menu, 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 visualização de treemap quadrado—mostrando os tamanhos relativos dos recursos sendo visualizados e as instâncias que estão contribuindo para eles.
- Abaixo da visualização de treemap quadrado há uma lista de todos os itens na visualização atual.
- Clicando 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 dos quais atende a um caso de uso diferente.
Memória de script
Esta visualização mostra quanta memória cada Script, LocalScript e ModuleScript está usando na VM Luau. Esta é 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 não parentadas
A visualização de instâncias não parentadas mostra quais scripts e módulos estão segurando referências a instâncias, como uma contagem por tipo.
Scripts que seguram referências a instâncias são normais e não, por si só, indicam um bug ou vazamento de memória. No entanto, se você estiver investigando um vazamento de memória, esta visualização torna fácil identificar se um script está fazendo algo que você não esperava.
Se você ainda está tendo dificuldade em encontrar a causa raiz de um vazamento de memória, esta 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 nesta visualização para selecioná-lo diretamente no Explorer.
Composição de instâncias
A visualização de composição de instâncias 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 ajudá-lo a entender como sua cena está equilibrada. Por exemplo, talvez você não quisesse ter 25.000 emissores de partículas, mas essa visualização deixa você saber.
Esta visualização também torna fácil selecionar 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 no momento. A memória real usada por uma determinada faixa de áudio é bastante complexa, mas em termos práticos, excluir todas as instâncias que se referem a uma faixa de áudio permite que essa memória seja descarregada.
Clique com o botão direito em qualquer ativo de áudio nesta 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 os ativos de áudio, excluir todas as instâncias que se referem a um ativo de animação permite que ele seja descarregado.
Esta visualização, juntamente com a visualização de instâncias não parentadas, torna fácil acompanhar o ciclo de vida das animações e quanto de memória elas estão realmente usando.
Clique com o botão direito em qualquer animação nesta visualização para selecionar todas as instâncias que estão usando-a.
Composição de triângulos
A visualização de composição de triângulos oferece uma visão mais detalhada dos triângulos e chamadas de desenho que estão sendo renderizadas atualmente na visualização principal.
Essas divisões incluem contagens para Sombras, Opaque, 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 em que a cena contém geometria inesperada.
As estatísticas nesta visualização não correspondem necessariamente ao que os jogadores veem em seus dispositivos. O escalonamento pode causar diferenças dramáticas entre um poderoso PC de desenvolvimento e, por exemplo, um telefone de médio porte.
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.
| Método | Descrição |
| GetInstanceCompositionAsync | Retorna contagens de instâncias por categoria e classe da árvore DataModel. |
| GetScriptMemoryAsync | Retorna o uso de memória do heap da VM Luau por script em bytes. |
| GetUnparentedInstancesAsync | Retorna instâncias mantidas pelo Luau, mas não mais na DataModel, agrupadas por script host. |
| GetTriangleCompositionAsync | Retorna contagens de triângulos e chamadas de desenho por passe de renderização. |
| GetAnimationMemoryAsync | Retorna a memória do clipe de animação carregado, deduplicada por clipe. |
| GetAudioMemoryAsync | Retorna a memória de ativos de áudio carregados, deduplicada por ID de ativo. |