Novedades
La vista de árbol te permite seleccionar las métricas que deseas medir y obtener los resultados de un vistazo.
El sistema de sesiones te permite muestrear varias fuentes simultáneamente.
La barra de búsqueda te permite encontrar rápidamente la métrica que necesitas.
Puedes abrir varias sesiones guardadas para compararlas más fácilmente, sin tener que cerrar la sesión que estés ejecutando en ese momento.
Puedes recopilar métricas simultáneamente de varias fuentes.
La vista de histograma te permite profundizar en la distribución de cada métrica durante el periodo de muestreo.
Los prefijos se añaden automáticamente a los archivos guardados para facilitar la identificación de las sesiones.
Unreal Editor para Fortnite (UEFN) te proporciona las herramientas que necesitas para comprender y mejorar el rendimiento de tu proyecto. Dado que Fortnite se ejecuta en muchas plataformas, conocer las métricas específicas de tu proyecto significa que puedes realizar los ajustes necesarios para garantizar un rendimiento fluido en todas tus experiencias UEFN.
Dirígete a Cómo iniciar una sesión de muestreo para echar un vistazo rápido al proceso de trabajo o sigue leyendo para profundizar en la herramienta perfilador espacial.
Términos útiles
Una métrica espacial se mide en cualquier propiedad que utilice una posición espacial 3D en un mundo. Consiste en un cierto número de valores espaciales, cada uno de los cuales tiene un número que corresponde a una medida, con una coordenada asociada que da la posición espacial donde se ha medido el valor dentro del mundo.
Un valor espacial es una medida concreta de una métrica espacial en una ubicación 3D. Los valores espaciales tienen tres valores de coordenadas espaciales: X, Y, Z y un valor de resultado de medición. Los valores espaciales se agregan en una muestra métrica espacial.
Una muestra métrica espacial es una medición de una métrica espacial concreta a lo largo de un periodo definido. Puede contener varios valores espaciales medidos con un resultado asociado. Una muestra también incluye otros datos relevantes, como los límites 3D que encapsulan todos los valores espaciales adjuntos, la precisión de distancia utilizada y la fecha en que se tomó.
Las propiedades métricas espaciales representan toda la información incluida en una muestra métrica espacial:
| Propiedad | Definición |
|---|---|
ID de métrica | Define el identificador único de la métrica, que está directamente vinculado al tipo de métrica. |
Valor mín. | El valor mínimo entre los valores espaciales registrados. |
Valor máximo | El valor máximo entre los valores espaciales registrados. |
Valor de umbral | El valor máximo esperado para la métrica. |
Precisión espacial | El tamaño de la celda 3D se utiliza en unidades del mundo, por lo que todos los valores contenidos contribuyen al mismo valor espacial. Normalmente, se selecciona el valor más alto. |
Unidad | La unidad utilizada por los valores registrados, por ejemplo, milisegundos para el tiempo o metros para la distancia. |
El perfilador espacial es un widget de visualización que proporciona un mapa de calor 2D de métricas espaciales. Aquí también puedes registrar, guardar y cargar muestras de métricas espaciales. Recoge datos de la función de actualización de métricas espaciales, lo que significa que los datos se actualizan periódicamente.
Editor de UEFN con la ventana del perfilador espacial acoplada.
El perfilador espacial admite actualmente siete métricas espaciales:
| Métrica | Definición | Unidad |
|---|---|---|
Recuento de llamadas de trazado | Registra el número de llamadas de trazado en un único fotograma. | Llamadas de trazado |
Recuento de primitivas | Registra el número de formas primitivas renderizadas en un solo fotograma. Las formas primitivas son los componentes básicos de dibujo que se utilizan para renderizar objetos en 3D. | Primitivas |
Tiempo de actualización del juego | Realiza un seguimiento del subproceso de juego de la plataforma y mide el tiempo que tarda en actualizarse un solo fotograma. | Microsegundos |
Tiempo de renderizado | Realiza un seguimiento del subproceso de renderizado de la plataforma y mide el tiempo que se tarda en actualizar un solo fotograma. | Microsegundos |
Tiempo de fotogramas | Registra el tiempo que se tarda en actualizar un solo fotograma. Tanto el tiempo de actualización del juego como el tiempo de renderizar se incluyen en esta métrica. | Microsegundos |
Tiempo de la GPU | Realiza un seguimiento del tiempo de GPU de la plataforma. | Microsegundos |
Tiempo de RHI | Realiza un seguimiento del tiempo del subproceso de la interfaz de hardware de renderizado de la plataforma. | Microsegundos |
Cantidad de actores | Registra el número de actores en el mundo que participan en eventos de transmisión. Esto resulta especialmente útil para mundos con la transmisión de World Partition habilitada. Localizar recuentos de actores incoherentes en el nivel puede resaltar las áreas más importantes de la jugabilidad. No obstante, un recuento de actores realmente alto también puede indicar un número excesivo de actores pequeños y un posible punto de tensión para la experiencia. Es conveniente evaluar esta métrica junto con el Game Update Time para evaluar la complejidad de la lógica del juego, o con el Render Time para evaluar la complejidad del renderizado. | Actores |
Recuento de construcciones | Versión especializada de la métrica Cantidad de actores que realiza un seguimiento del número de actores que se han clasificado como construcciones. Esta categoría también incluye otros tipos de actores de malla estática persistentes. | Actores |
Cantidad de contenedores de botín | Versión especializada de la métrica Cantidad de actores que realiza un seguimiento de los actores que se han clasificado como contenedores de botín. Esta categoría incluye actores como cofres, cajas de munición y otros generadores de recogida. | Actores |
Recuento de recogidas | Versión especializada de la métrica Cantidad de actores que realiza un seguimiento del número de actores que se han clasificado como recogidas. Esta categoría incluye objetos del juego que se pueden saquear. | Actores |
Uso de memoria | Monitoriza el uso de memoria ejecutable de la plataforma. Puedes utilizar esto para evaluar los requisitos de memoria de cada plataforma en la que debe ejecutarse la experiencia. | Kilobytes |
Memoria disponible | Realiza un seguimiento de la memoria física disponible de la plataforma. Puedes utilizar esto para evaluar los requisitos de memoria de cada plataforma en la que debe ejecutarse la experiencia. | Kilobytes |
IU del perfilador espacial
El Profiler espacial es un widget independiente acoplable dividido en cuatro áreas:
Áreas del widget del perfilador espacial.
Barra de herramientas de control
Vista de mapa de calor
Vista de árbol de métricas
Vista de histograma
Barra de herramientas de control
Esta área contiene los principales elementos interactivos que permiten utilizar el Profiler espacial. Ofrece los controles necesarios para producir, visualizar y guardar muestras de métricas espaciales. Puedes utilizar las muestras que captures para generar datos con los que mejorar tu experiencia en UEFN.
Elementos de la barra de herramientas de control del perfilador espacial.
La barra de herramientas de control cuenta con los siguientes elementos:
Empezar muestreo: este botón inicia la captura del conjunto de métricas seleccionadas por el usuario. Tienes que estar conectado a una sesión UEFN para que se muestreen las métricas. Durante el muestreo, el mapa de calor centra automáticamente la vista en la ubicación del peón jugador de la sesión y se enfoca en los valores espaciales capturados.
Detener muestreo: este botón detiene la captura de las métricas seleccionadas.
Abrir un archivo de muestra: este botón abre un archivo de muestra ya existente, que puede contener varias métricas. Al abrirlo, se cargan todas las métricas cargadas en el explorador de métricas para que puedas evaluar los datos.
Guardar una muestra en un archivo: puedes utilizar este botón para guardar las sesiones de generación de perfiles activas. Abre un cuadro de diálogo para guardar en archivo y propone un nombre de archivo predeterminado con la marca de tiempo de la muestra. El Profiler espacial guarda todas las métricas de la sesión de muestreo actual en el archivo de destino.
Selector de sesiones de UEFN: puedes tener más de un cliente conectado a una sesión. Puedes utilizar el selector de sesión para elegir a qué sesión conectarte y ejecutar las métricas. El Profiler espacial se conecta al cliente automáticamente al iniciar una sesión y luego actualiza el selector de sesión con el nombre del usuario conectado a esa sesión.
Ajustes: este botón muestra la configuración de preferencias del perfilador espacial. Puedes utilizarlo para cambiar la visibilidad de ciertos elementos del widget.
Vista de árbol de métricas
Esta sección te permite seleccionar y anular la selección de las métricas que quieras en tu sesión de muestreo haciendo clic en las casillas de verificación situadas a la izquierda de las métricas.
El campo desplegable superior se utiliza para elegir entre una sesión en tiempo real y una sesión guardada previamente. Puedes cambiar entre tu sesión de muestreo actual y una sesión guardada seleccionando la sesión que deseas ver en el desplegable.
Con el segundo campo desplegable, puedes cambiar entre los objetivos de muestreo en tu sesión en tiempo real, como los clientes o el servidor. Puedes supervisar las métricas de todos los clientes conectados y tomar muestras de varias fuentes al mismo tiempo.
La barra de búsqueda te permite buscar una métrica específica.
Al hacer clic en una métrica para seleccionarla, la vista de mapa de calor se actualiza para mostrar las muestras de datos, y la vista de estadísticas se actualiza para mostrar las estadísticas agregadas de los datos. Los círculos de colores situados junto a cada métrica representan sus valores relativos en función de los umbrales que estableciste antes de la sesión de muestreo, lo que permite ver los resultados de un vistazo.
Vista de mapa de calor
La vista de mapa de calor permite visualizar un mapa de calor de la métrica elegida, con una superposición de todos los valores espaciales de la muestra. Cada valor espacial aparece coloreado según los datos de la muestra. Puedes establecer rápidamente valores límite para cada métrica a fin de definir el rango de valores esperados.
Puedes interactuar con el mapa de calor y personalizarlo a tu gusto mediante los cuatro botones de la parte superior:
Menú de tres líneas
Mostrar opciones
Jugador de enfoque
Límites de enfoque
Al hacer doble clic en cualquier ubicación de la vista de mapa de calor, la cámara del editor se sitúa en la ubicación correspondiente dentro del proyecto. Si se inicia una sesión, el peón jugador se teletransporta a la ubicación en la que se hace doble clic.
Menú de tres líneas
Este botón te permite acceder a las opciones de visualización del mapa de calor, que contiene dos secciones:
Configuración de métricas
Ajustes de color del mapa de calor
Opciones del menú de tres líneas del perfilador espacial.
Puedes restablecer la configuración de estas secciones haciendo clic en el botón de flecha de restablecimiento que aparece a la derecha de cada campo.
Configuración de métricas
El grupo de Ajustes de métricas agrupa todos los ajustes que afectan a la visualización de las métricas.
| Valor | Definición |
|---|---|
Umbral | Un valor umbral define el valor máximo esperado para una jugabilidad normal. |
Unidad de visualización | Cuando se especifica, esta opción define la unidad de visualización preferida para una métrica. Si no se especifica, la herramienta selecciona la unidad que mejor se ajusta a cada métrica. La unidad de visualización afecta a las unidades utilizadas por la vista de mapa de calor y la vista de resumen. |
Método de celda | Esta configuración especifica el método de reducción que utiliza la herramienta para calcular cada valor de celda 2D de la lista de valores que se encuentran dentro de los límites de cada celda. Los métodos de reducción disponibles son:
|
Tamaño de celda | Estos ajustes cambian el tamaño de la cuadrícula y pueden aumentar o disminuir el nivel de detalle de una zona de muestreo concreta. |
Ajustes de color del mapa de calor
Los ajustes de color del mapa de calor agrupan todos los ajustes que afectan a la visualización de las métricas.
Los colores de calor ofrecen una paleta de colores de fácil lectura que tiene en cuenta posibles problemas de daltonismo. Puedes definir los colores clave para personalizar el rango de colores del mapa de calor.
| Valor | Definición |
|---|---|
Bajo | Este color representa el espectro bajo de la gama de colores del mapa de calor y se corresponde con el valor mínimo de una muestra métrica. |
Punto medio | Este color representa la parte central del rango de color del mapa de calor definido entre el color mínimo y el umbral. En caso de que no se especifique un valor umbral, se asigna al valor espacial mediano de una muestra. |
Alta | Este color representa todos los valores que están por encima del umbral establecido. |
Máx. | Este color representa el valor máximo. Solo aparece cuando los usuarios definen un valor umbral para la métrica representada. Al especificar un valor umbral, el mapa de calor añade un rango que sobrepasa el umbral, que va desde el blanco hasta el color establecido para Máximo. |
Alfa mín. | Valor inicial dado a los valores espaciales. El valor alfa de todos los valores espaciales de una muestra aumenta según su valor, desde el valor Mínimo (utilizando Alfa mínimo) hasta los valores Máximo o Umbral con alfa máximo. Si se utiliza un valor Alfa mínimo bajo, se resaltan los valores espaciales más cercanos a los valores Máximo o Umbral, haciendo menos visibles los valores espaciales bajos. |
Alfa máx. | Valor inicial máximo dado a los valores espaciales. |
La Configuración de alfa muestra valores espaciales fuera del rango esperado. Ajustar estas opciones resulta especialmente útil cuando se analiza una muestra métrica con zonas de valores espaciales de alta densidad, ya que permite obtener una lectura más detallada de las métricas.
Ejes
Esta opción permite activar o desactivar la visualización de los ejes 3D en la esquina inferior izquierda, correspondiente a la orientación descendente de la vista del mapa de calor. Esta orientación está en paridad con la vista de minimapa del cliente y no con la del editor.
Mostrar ejes del mapa de calor
Cuadrícula
Activa o desactiva la visualización de la cuadrícula del mapa de calor 2D, subdividiendo el espacio visible en múltiplos de la extensión del valor de muestra. El tamaño de la cuadrícula se puede modificar en el menú de tres líneas.
Leyenda del mapa de calor
Esta opción activa o desactiva la visualización de la leyenda del rango de colores del mapa de calor en la esquina inferior derecha de la vista de mapa de calor.
Mostrar la leyenda de la paleta de colores del mapa de calor
Límites
Esta opción te permite activar la caja delimitadora 2D, que comprende todos los valores espaciales de la muestra.
Mostrar límites de muestra (blancos) en el mapa de calor
Jugador de enfoque
Este botón centra la vista en torno al peón jugador en la sesión conectada. Esta acción requiere una sesión conectada.
Límites de enfoque
Este botón centra la vista del mapa de calor en torno a la caja delimitadora 2D.
Menú contextual
Puedes acceder al menú contextual haciendo clic con el botón derecho del ratón en el área Vista de mapa de calor. Este menú ofrece las siguientes opciones:
Teletransportación
Vista predeterminada
Límites de enfoque
Seguimiento de la ubicación del enfoque
Menú contextual de la vista de mapa de calor del perfilador espacial
Teletransportación
Puedes utilizar esta opción para llevar la vista de la cámara y el peón jugador a una ubicación elegida con el botón derecho del ratón en la vista de mapa de calor. Esta acción requiere una sesión conectada para teletransportar al peón jugador. Si no hay ninguna sesión conectada, es el equivalente a hacer doble clic en cualquier ubicación de la vista de mapa de calor. De este modo, la cámara del editor se sitúa en la ubicación correspondiente dentro del proyecto.
Vista predeterminada
Esta opción restablece los valores de enfoque y zoom de la vista de mapa de calor a sus valores predeterminados.
Vista de histograma
El histograma te ayuda a visualizar los datos a medida que se recopilan en tiempo real. Puedes volver atrás en la prueba del nivel y evaluar cada métrica en un punto específico de la prueba de juego. Al desplazarse por el histograma de la sesión abierta, puedes identificar la ubicación de una lectura concreta que desees investigar.
Ajustar los valores en el menú de tres líneas modificará los distintos puntos límite que se muestran en el histograma.
Si haces clic con el botón derecho en el histograma, podrás seleccionar Mostrar pautas de umbral, Desplazamiento automático, Sombrear valores por celda, elegir los valores Siguiente y Anterior, y Escala de histograma. Puedes cambiar el tamaño del histograma manteniendo pulsada la tecla Mayús y desplazando la rueda del ratón.
También puedes acercar y alejar el histograma para obtener una visión más detallada de tus métricas.
Al pasar el ratón sobre un segmento de la muestra, una burbuja informativa mostrará su valor.
Al hacer clic en el segmento de muestra, se resalta la posición del segmento en el mapa de calor.
A la derecha del histograma, puedes ver un resumen de las estadísticas de la métrica seleccionada. En él se presentan las siguientes estadísticas compiladas a partir de los valores espaciales de la muestra:
| Estadística | Definición |
|---|---|
Valores | Número total de valores espaciales incluidos en la muestra. |
Alta | Número de valores espaciales que superan el valor umbral, si se ha definido. |
Valor mín. | Valor espacial más pequeño. |
Max Valor | Valor espacial más grande. |
Valor promedio | Valor espacial promedio. |
Valor mediano | Valor espacial mediano. |
Cómo iniciar una sesión de muestreo
En esta sección se explica cómo iniciar una sesión de muestreo mediante la herramienta Profiler espacial y cómo guardar la muestra de métrica espacial.
Ve a Herramientas > Métricas > Perfilador espacial. De este modo se abrirá el widget Profiler espacial.
En la vista de árbol, selecciona las métricas que quieras medir en tu sesión de muestreo.
Configura los parámetros de muestreo en el menú de tres líneas.
Haz clic en Abrir sesión para iniciar una partida mediante el cliente de Fortnite.
(Opcional) Una vez que se cargue el cliente, pulsa Finalizar la partida para entrar en el modo de edición, que permite a tu peón recorrer el nivel más rápidamente.
Pulsa Empezar muestreo.
En la sesión de juego, usa tu peón para correr por la isla y jugar según lo previsto. El mapa de calor de Profiler espacial se actualizará al hacerlo.
Pulsa el botón Detener muestreo para finalizar la sesión de muestreo.
Pulsa el icono de Guardar en el widget del perfilador espacial y selecciona una ubicación dentro del directorio local de tu proyecto. El perfilador proporciona acceso de lectura a cualquier muestra guardada en el proyecto. Las muestras se organizan según el tipo de métrica y la marca de tiempo.
Puedes hacer clic en el icono de Abrir para acceder a las grabaciones de muestras de proyectos anteriores.