Analisi della Scena

Lo strumento di Analisi della Scena fornisce una suite di visualizzazioni in Roblox Studio che ti danno informazioni comparative a colpo d'occhio su come sono composte le scene del client e del server, quali risorse stanno utilizzando e quali istanze sono responsabili di quel utilizzo delle risorse. L'Analisi della Scena è progettata per essere utilizzata durante le sessioni di gioco e di test e può ispezionare sia i modelli di dati del client che del server.

Abilitare l'Analisi della Scena

Nel menu, seleziona Finestra > Riepilogo delle Prestazioni > Analisi della Scena.

Utilizzare l'Analisi della Scena

L'Analisi della Scena è progettata per essere utilizzata durante una sessione di gioco o di test. Apri la finestra di Analisi della Scena e sfoglia le modalità disponibili. Quando una modalità è attiva, vedrai un display di riquadri—la vista treemap squarificata—che mostra le dimensioni relative delle risorse visualizzate e delle istanze che contribuiscono a esse.

• Sotto la vista treemap squarificata c'è un elenco di tutti gli elementi nella vista corrente.
• Facendo clic destro su un elemento selezionato nell'Analisi della Scena, di solito puoi saltare direttamente a quell'elemento nell'Esplora.
• Puoi utilizzare la barra di ricerca per filtrare per nome nella visualizzazione corrente.

Modalità

L'Analisi della Scena ha molte modalità diverse, ognuna delle quali si adatta a un caso d'uso diverso.

Memoria degli script

Questa vista mostra quanta memoria sta utilizzando ciascun Script, LocalScript e ModuleScript nella VM Luau. Questa è la memoria utilizzata da tabelle e altre allocazioni di script, non la memoria utilizzata da risorse come animazioni, texture e suoni. La vista è ulteriormente suddivisa per le posizioni comuni da cui vengono eseguiti gli script e per Script rispetto a ModuleScript.

Istanze non associate

La vista delle istanze non associate mostra quali script e moduli stanno mantenendo riferimenti alle istanze, come un conteggio per tipo.

Gli script che mantengono riferimenti alle istanze sono normali e non rappresentano, di per sé, un'indicazione di un bug o di una perdita di memoria. Tuttavia, se stai indagando su una perdita di memoria, questa vista rende facile individuare se uno script sta facendo qualcosa che non ti aspettavi.

Se hai ancora difficoltà a trovare la causa principale di una perdita di memoria, questo strumento è complementare allo strumento montone Luau, che può mostrarti maggiori informazioni sulle singole allocazioni.

Fai clic destro su qualsiasi script in questa vista per selezionarlo direttamente nell'Esplora.

Composizione delle istanze

La vista della composizione delle istanze mostra quali istanze sono attualmente presenti sul client o sul server. Questo è inestimabile quando si lavora su costruzioni grandi e complesse, poiché ogni istanza ha costi di replica e di memoria.

Le categorie, come Personaggi, Geometria e Texture, sono progettate per aiutarti a comprendere come è bilanciata la tua scena. Ad esempio, forse non intendevi avere 25.000 emettitori di particelle, ma questa vista te lo fa sapere.

Questa vista rende anche facile selezionare tutte le istanze di un dato tipo.

Memoria audio

La vista della memoria audio mostra quanta memoria sta attualmente consumando ciascuna risorsa audio. La reale memoria utilizzata da una data traccia audio è piuttosto complessa, ma in termini pratici, eliminare tutte le istanze che fanno riferimento a una traccia audio consente a quella memoria di essere scaricata.

Fai clic destro su qualsiasi risorsa audio in questa vista per selezionare tutte le istanze che la utilizzano.

Memoria delle animazioni

Le risorse delle animazioni sono una delle fonti più comuni di perdite di memoria in produzione. Roblox è aggressivo nel caricare risorse di animazione non utilizzate, ma è comune che gli script mantengano animazioni vive dopo che il loro modello genitore è stato distrutto.

Come per le risorse audio, eliminare tutte le istanze che fanno riferimento a una risorsa di animazione consente di scaricarla.

Questa vista, insieme alla vista delle istanze non associate, rende facile tracciare il ciclo di vita delle animazioni e quanto effettivamente stanno utilizzando in termini di memoria.

Fai clic destro su qualsiasi animazione in questa vista per selezionare tutte le istanze che la utilizzano.

Composizione triangolare

La vista della composizione triangolare ti offre un'analisi più dettagliata dei triangoli e delle chiamate di disegno attualmente in fase di rendering nella finestra principale.

Queste suddivisioni includono conteggi per Ombre, Opaco, Trasparente, Terreno, Erba, Particelle, Cielo e UI.

Queste informazioni compositive ti aiutano a capire meglio come è composta la geometria della tua scena e a identificare casi in cui la scena contiene geometria imprevista.

API del Motore

Puoi anche accedere ai dati dell'Analisi della Scena programmaticamente tramite SceneAnalysisService, che è esposta attraverso il server MCP. Ciascun metodo restituisce tabelle contenenti figli nidificati con gli stessi dati utilizzati dal display visivo.