La herramienta de Análisis de Escena proporciona un conjunto de vistas en Roblox Studio que te ofrecen información comparativa de un vistazo sobre cómo están ensambladas tus escenas de cliente y servidor, qué recursos están utilizando y qué instancias son responsables de ese uso de recursos. El Análisis de Escena está diseñado para usarse durante las sesiones de juego y prueba, y puede inspeccionar tanto los modelos de datos del cliente como los del servidor.
Habilitar Análisis de Escena
En la barra del menú, selecciona Ventana > Resumen de Rendimiento > Análisis de Escena.
Usar Análisis de Escena
El Análisis de Escena está diseñado para ser utilizado durante una sesión de juego o prueba. Abre la ventana de Análisis de Escena y explora los modos disponibles. Cuando un modo está activo, verás un display de cuadros—la vista de treemap cuadrada—mostrando el tamaño relativo de los recursos que se están viendo y las instancias que están contribuyendo a ellos.
- Debajo de la vista de treemap cuadrada hay una lista de todos los elementos en la vista actual.
- Hacer clic derecho en un elemento seleccionado en el Análisis de Escena generalmente te permite saltar directamente a ese elemento en el Explorador.
- Puedes usar la barra de búsqueda para filtrar por nombre en la visualización actual.
Modos
El Análisis de Escena tiene muchos modos diferentes, cada uno de los cuales se adapta a un caso de uso diferente.
Memoria de scripts
Esta vista muestra cuánta memoria está usando cada Script, LocalScript y ModuleScript en la VM de Luau. Esta es la memoria utilizada por tablas y otras asignaciones de scripts, no la memoria utilizada por activos como animaciones, texturas y sonidos. La vista se desglosa aún más por las ubicaciones comunes desde las que se ejecutan los scripts y por Script frente a ModuleScript.
Instancias sin padre
La vista de instancias sin padre muestra qué scripts y módulos están manteniendo referencias a instancias, como un conteo por tipo.
Los scripts que mantienen referencias a instancias son normales y no son, por sí solos, una indicación de un error o fuga de memoria. Sin embargo, si estás investigando una fuga de memoria, esta vista facilita detectar si un script está haciendo algo que no esperabas.
Si aún tienes problemas para encontrar la causa raíz de una fuga de memoria, esta herramienta complementa al montículo de Luau, que puede mostrarte más información sobre asignaciones individuales.
Haz clic derecho en cualquier script en esta vista para seleccionarlo directamente en el Explorador.
Composición de instancias
La vista de composición de instancias muestra qué instancias están actualmente presentes en el cliente o servidor. Esto es invaluable al trabajar en construcciones grandes y complejas, ya que cada instancia tiene costos de replicación y memoria.
Las categorías, como Personajes, Geometría y Texturas, están diseñadas para ayudarte a entender cómo está equilibrada tu escena. Por ejemplo, quizás no tenías intención de tener 25,000 emisores de partículas, pero esta vista te lo hace saber.
Esta vista también facilita seleccionar todas las instancias de un tipo determinado.
Memoria de audio
La vista de memoria de audio muestra cuánta memoria está consumiendo actualmente cada activo de audio. La memoria real utilizada por una pista de audio dada es bastante compleja, pero en términos prácticos, eliminar todas las instancias que hacen referencia a una pista de audio permite que esa memoria se descargue.
Haz clic derecho en cualquier activo de audio en esta vista para seleccionar todas las instancias que lo están utilizando.
Memoria de animación
Los activos de animación son una de las fuentes más comunes de fugas de memoria en producción. Roblox es agresivo al descargar activos de animación no utilizados, pero es común que los scripts mantengan las animaciones activas después de que su modelo padre ha sido destruido.
Al igual que con los activos de audio, eliminar todas las instancias que hacen referencia a un activo de animación permite que se descargue.
Esta vista, junto con la vista de instancias sin padre, facilita rastrear el ciclo de vida de las animaciones y cuánta memoria están utilizando realmente.
Haz clic derecho en cualquier animación en esta vista para seleccionar todas las instancias que la están utilizando.
Composición de triángulos
La vista de composición de triángulos te da un desglose más detallado de los triángulos y las llamadas de dibujo que se están renderizando actualmente en el viewport principal.
Estos desgloses incluyen conteos para Sombras, Opaco, Transparente, Terreno, Césped, Partículas, Cielo y UI.
Esta información compositiva te ayuda a entender mejor cómo está compuesta la geometría de tu escena e identificar casos donde la escena contiene geometría inesperada.
Las estadísticas en esta vista no necesariamente coinciden con lo que los jugadores ven en sus dispositivos. El escalado puede causar diferencias dramáticas entre una poderosa PC de desarrollo y, por ejemplo, un teléfono de gama media.
API del Motor
También puedes acceder a los datos de Análisis de Escena programáticamente a través de SceneAnalysisService, que se expone a través del servidor MCP. Cada método devuelve tablas que contienen hijos anidados con los mismos datos que utiliza la visualización.
| Método | Descripción |
| GetInstanceCompositionAsync | Devuelve conteos de instancia por categoría y clase del árbol DataModel. |
| GetScriptMemoryAsync | Devuelve el uso de memoria del montículo de Luau por script en bytes. |
| GetUnparentedInstancesAsync | Devuelve instancias retenidas por Luau pero que ya no están en el DataModel, agrupadas por script de anfitrión. |
| GetTriangleCompositionAsync | Devuelve conteos de triángulos y llamadas de dibujo por pasada de renderizado. |
| GetAnimationMemoryAsync | Devuelve la memoria de clips de animación cargados, deduplicada por clip. |
| GetAudioMemoryAsync | Devuelve la memoria de activos de audio cargados, deduplicada por ID de activo. |