¿Qué hay de nuevo?
La vista de árbol te permite seleccionar las métricas que deseas medir y obtener resultados de un vistazo.
El sistema de sesión te permite muestrear múltiples fuentes simultáneamente.
La barra de búsqueda te permite encontrar rápidamente la métrica necesaria.
Puedes abrir varias sesiones guardadas para facilitar la comparación, sin tener que cerrar la sesión que estás ejecutando actualmente.
Puedes capturar métricas simultáneamente desde múltiples fuentes.
La vista de histograma te permite profundizar en la distribución de cada métrica durante el período de muestreo.
Los prefijos se añaden automáticamente a tus archivos guardados para facilitar la identificación de las sesiones.
Unreal Editor para Fortnite (UEFN) te brinda las herramientas necesarias para entender y mejorar el rendimiento de tu proyecto. Como Fortnite se ejecuta en muchas plataformas, al saber las métricas específicas de tu proyecto, podrás hacer cualquier ajuste necesario para garantizar un rendimiento uniforme a lo largo de tus experiencias de UEFN.
Ve a Iniciar una sesión de prueba para echar un vistazo al flujo de trabajo o continúa leyendo para analizar en profundidad la herramienta perfilador espacial.
Términos útiles
Una métrica espacial se mide para cualquier propiedad que use una posición espacial 3D en un entorno. Consiste en una cantidad determinada de valores espaciales, cada uno con un número que corresponde a una medida, con una coordinada asociada que da la posición espacial donde se midió el valor dentro del entorno.
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 y Z, y un valor de resultado de medida. Los valores espaciales se agregan en una muestra de métrica espacial.
Una Muestra de Métrica Espacial es una medición de una métrica espacial concreta por un período de tiempo definido. Puede contener varios valores espaciales medidos con un resultado asociado. Una muestra también incluye otros datos relevantes, como los bordes 3D que incluyen todos los valores espaciales incluidos, la presión de distancia usada y los datos que se tomaron.
Las propiedades de métricas espaciales representan toda la información incluida en una muestra de métrica espacial:
| Propiedad | Definición |
|---|---|
ID de la métrica | Define el identificador único de la métrica, que está directamente ligado al tipo de métrica. |
Valor mínimo | 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 que se usa en las unidades del entorno, de modo que todos los valores contenidos contribuyen al mismo valor espacial. Generalmente, se selecciona el valor más alto. |
Unidad | La unidad usada 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 te proporciona un mapa de calor 2D de métricas espaciales. Aquí también puedes grabar, guardar y cargar muestras de métrica espacial. Recopila 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 acoplada del perfilador espacial.
El perfilador espacial actualmente es compatible con siete métricas espaciales:
| Métrico | Definición | Unidad |
|---|---|---|
Recuento de peticiones de trazado | Realiza un seguimiento del número de peticiones de trazado en un único fotograma | Peticiones de trazado |
Recuento de primitivas | Realiza un seguimiento del número de primitivas renderizadas en un único fotograma. Las primitivas son los Componentes básicos de dibujo que se utilizan para renderizar Objetos en 3D. | Primitivas |
Tiempo de actualización del juego | Rastrea el subproceso de juego de la plataforma, que mide el tiempo que toma actualizar un fotograma único. | Microsegundos |
Tiempo de renderización | Rastrea el subproceso de renderización de la plataforma, que mide el tiempo que toma actualizar un fotograma único. | Microsegundos |
Tiempo de fotograma | Realiza un seguimiento del tiempo empleado en actualizar un único 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 renderizar de la plataforma. | Microsegundos |
Recuento de actores | Registra el número de actores en el entorno que participan en eventos de streaming. Esto es de gran utilidad para entornos con el streaming de World Partition activado. Ver que el recuento de actores es incoherente en el nivel puede poner de relieve las áreas más importantes de la jugabilidad. Sin embargo, 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 una buena idea evaluar esta métrica junto con el Tiempo de actualización del juego para evaluar la complejidad de la lógica del juego, o con el Tiempo de renderizado para evaluar la complejidad del renderizado. | Actores |
Conteo de construcción | Una versión especializada de la métrica Recuento de actores que rastrea la cantidad de actores que se clasificaron como edificios. Esta categoría también incluye otros tipos de actores de malla estática persistentes. | Actores |
Conteo de contenedores de botín | Una versión especializada de la métrica Conteo de actores que rastrea la cantidad de actores que se clasificaron como contenedores de botín. Esta categoría incluye actores como cofres, cajas de munición y otros generadores de recolección. | Actores |
Conteo de recolección | Una versión especializada de la métrica Conteo de actores que realiza un seguimiento de la cantidad de actores que se clasificaron como elementos de recolección. Esta categoría incluye objetos de juego saqueables. | Actores |
Uso de memoria | Registra el uso de la memoria ejecutable de la plataforma. Puedes usarlo para evaluar los requisitos de memoria de cada plataforma en la que deba ejecutarse la experiencia. | Kilobytes |
Memoria disponible | Realiza un seguimiento de la memoria física disponible de la plataforma. Puedes usarlo para evaluar los requisitos de memoria de cada plataforma en la que deba ejecutarse la experiencia. | Kilobytes |
IU del perfilador espacial
El perfilador espacial es un widget independiente anclable dividido en cuatro áreas:
Áreas del widget del perfilador espacial.
Barra de herramientas de control
Vista de mapa térmico
Vista de árbol de métricas
Vista de histograma
Barra de herramientas de control
Esta área contiene los principales elementos interactivos para operar el perfilador espacial. Te ofrece los controles para producir, visualizar y guardar muestras de métricas espaciales. Puedes usar las muestras que captures para generar datos que puedan mejorar tu experiencia en UEFN.
Elementos de la barra de herramientas de control del perfilador espacial.
La barra de herramientas de control incluye los siguientes elementos:
Iniciar muestreo: este botón inicia la captura del conjunto de métricas que el usuario seleccionó. Tienes que conectarte a una sesión de UEFN para que se muestreen las métricas. Durante el muestreo, el mapa térmico centra automáticamente la vista en la ubicación del peón jugador de la sesión y se centra 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 preexistente, que puede tener varias métricas. Al abrirse, todas las métricas se cargan en el navegador de métricas para que puedas evaluar los datos.
Guardar una muestra en el archivo: puedes usar este botón para guardar sesiones de generación de perfiles activas. Abre un cuadro de diálogo para guardar en archivo y propone por defecto un nombre de archivo con la marca de tiempo de la muestra. El perfilador espacial guarda todas las métricas de la sesión de muestreo actual en el archivo de destino.
Selector de sesiones de UEFN: puedes conectar más de un cliente a una sesión. Puedes usar el selector de sesiones para elegir la sesión a la que te conectarás para ejecutar las métricas. El perfilador espacial se conecta automáticamente al cliente cuando se inicia la sesión y, luego, actualiza el selector de sesiones con el nombre del usuario que está conectado a esa sesión.
Configuración: este botón muestra la configuración de preferencias del perfilador espacial. Puedes usar esto para activar o desactivar la visibilidad de ciertos elementos de widget.
Vista de árbol de métricas
Esta sección te permite seleccionar y deseleccionar las métricas que deseas en tu sesión de muestreo haciendo clic en las casillas de verificación a la izquierda de las métricas.
El campo desplegable superior se utiliza para elegir entre una sesión en vivo y una sesión guardada anteriormente. Puedes alternar entre tu sesión de muestreo actual y una sesión guardada al seleccionar la sesión que deseas ver en el menú desplegable.
Con el segundo campo desplegable, puedes cambiar entre los Dispara aquí de muestreo en tu sesión en vivo, como los clientes o el servidor. Puedes monitorear 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.
Cuando haces clic en una métrica para seleccionarla, la vista del mapa térmico se actualiza para mostrar cualquier muestra de datos, y la vista de estadísticas se actualiza para mostrar las estadísticas totales de los datos. Los Círculos de colores junto a cada métrica representan sus valores relativos en función de los umbrales que definiste antes de la sesión de muestreo, mostrando tus resultados de un vistazo.
Vista de mapa térmico
La vista del mapa térmico muestra un mapa térmico de la métrica que elijas, además de una interfaz de todos los valores espaciales de la muestra. Cada valor espacial está coloreado según los datos de la muestra. Puedes establecer valores de límite rápidamente para cada métrica para definir el rango de los valores esperados.
Puedes interactuar con el mapa térmico y personalizarlo con tus preferencias mediante los cuatro botones de la parte superior:
Menú de hamburguesa
Mostrar opciones
Enfocar jugador
Límites de enfoque
Al hacer doble clic en cualquier ubicación de la vista del mapa térmico, 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 a la que le haces doble clic.
Menú de hamburguesa
Este botón te brinda acceso a las opciones de visualización del mapa térmico, que contiene dos secciones:
Configuración de las métricas
Configuraciones de color del mapa térmico
Opciones del menú de hamburguesa del perfilador espacial.
Puedes restablecer la configuración de estas secciones haciendo clic en el botón de flecha de restablecimiento situado a la derecha de cada campo.
Configuración de las métricas
La configuración de métricas agrupa todas las configuraciones que afectan la visualización de las métricas.
| Value | Definición |
|---|---|
Umbral | Un valor de umbral define el valor máximo esperado para una jugabilidad normal. |
Mostrar unidad | 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 de mejor ajuste para cada métrica. La Unidad de visualización afecta a las unidades utilizadas por la Vista del mapa térmico y la Vista de resumen. |
Método de la 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 los siguientes:
|
Tamaño de celda | Esta configuración cambia el tamaño de la cuadrícula y puede aumentar o disminuir el nivel de detalle para un área de muestreo en particular. |
Configuraciones de color del mapa térmico
La configuración de color del mapa térmico contiene todos los ajustes que afectan a la visualización de las métricas.
Los colores térmicos ofrecen una paleta de colores legibles teniendo en cuenta el daltonismo. Puedes definir los colores clave para personalizar la gama de colores del mapa térmico.
| Value | Definición |
|---|---|
Baja | Este color representa el espectro bajo de la gama de colores del mapa térmico y corresponde al valor mínimo de una muestra de métrica. |
Punto medio | Este color representa el centro de la gama de colores del mapa térmico definida entre el color Mínimo y el color Umbral. Si no se especifica un valor de umbral, se asigna al valor espacial mediano de una muestra. |
Alta | Este color representa todos los valores que están por encima del umbral definido. |
Máx. | Este color representa el valor máximo. Solo se muestra cuando los usuarios definen un valor de umbral para la métrica representada. Cuando se especifica un valor de umbral, el mapa térmico añade un rango que supera el umbral, yendo del blanco al color establecido para el Máximo. |
Alfa mínimo | El 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 (usando Alfa mín.) hasta los valores Máximo o Umbral con alfa máx. El uso de un valor de Alfa mín. bajo resalta los valores espaciales más cercanos a los valores Máximo o Umbral, haciendo que los valores espaciales bajos sean menos visibles. |
Alfa máximo | El valor inicial máximo dado a los valores espaciales. |
La Configuración alfa muestra valores espaciales fuera del rango esperado. Ajustar estas opciones se vuelve especialmente útil cuando se observa una muestra de métrica con bolsas de valores espaciales de alta densidad, ya que puedes obtener una lectura más granular de las métricas.
Hachas
Esta opción activa la visualización de los ejes 3D en la esquina inferior izquierda correspondiente a la orientación de arriba abajo de la vista del mapa térmico. Esta orientación está en paridad con la vista del minimapa del cliente y no con la del editor.
Cómo mostrar los ejes del mapa térmico
Cuadrícula
Activa la visualización de la cuadrícula del mapa térmico 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 hamburguesa.
Leyenda del mapa térmico
Esta opción activa o desactiva la visualización de la leyenda de la gama de colores del mapa térmico en la esquina inferior derecha de la vista del mapa térmico.
Visualización de la leyenda de la paleta de colores del mapa térmico
Límites
Esta opción permite activar el cuadro delimitador 2D, que comprende todos los valores espaciales de la muestra.
Visualización de los límites de muestra (blanco) en el mapa térmico
Enfocar jugador
Este botón centra la vista alrededor del 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 térmico alrededor del cuadro delimitador 2D.
Menú contextual
Puedes acceder al menú contextual haciendo clic derecho en el área de vista del mapa térmico. Este menú contiene las siguientes opciones:
Teletransportar
Vista por defecto
Límites de enfoque
Ubicación de enfoque de la pista
Menú contextual de la vista del mapa térmico del perfilador espacial
Teletransportar
Puedes usar esta opción para llevar tanto la vista de cámara como el peón jugador a una ubicación elegida con el botón derecho del ratón en la vista del mapa térmico. Esta acción requiere una sesión conectada para teletransportar al peón jugador. Si no hay ninguna sesión conectada, equivale a hacer doble clic en cualquier ubicación de la Vista del mapa térmico, lo que coloca la cámara del editor en la ubicación correspondiente dentro del proyecto.
Vista por defecto
Esta opción restablece los valores de enfoque y zoom de la vista de mapa térmico a sus valores por defecto.
Vista de histograma
El histograma te ayuda a visualizar los datos a medida que se recopilan en tiempo real. Puedes volver a la prueba del nivel y evaluar cada métrica en un punto específico de la prueba de juego. Al desplazarte por el histograma de la sesión abierta, puedes identificar la ubicación de una lectura concreta que quieras investigar.
Al ajustar los valores en el menú de hamburguesa, se modificarán los distintos puntos de corte que se muestran en el histograma.
Al hacer clic con el botón derecho en el histograma, podrás seleccionar Mostrar pautas de umbral, Desplazamiento automático, Valores de sombreado por celda, elegir los valores Siguiente y Anterior, y escalar el histograma. Puedes cambiar la escala del histograma al mantener presionada la tecla Shift + desplazar la rueda del mouse.
También puedes acercar y alejar el histograma para obtener una visión más detallada de tus métricas.
Cuando pasas el mouse sobre un segmento de la muestra, un texto emergente mostrará su valor.
Al hacer clic en el segmento de muestra, se resalta la ubicación del segmento en el mapa térmico.
A la derecha del histograma, puedes ver un resumen de las estadísticas de la métrica seleccionada. Muestra las siguientes estadísticas compiladas a partir de los valores espaciales de la muestra:
| Estadísticas | Definición |
|---|---|
Valores | El número total de valores espaciales incluidos en la muestra. |
Alta | El número de valores espaciales que superan el valor de umbral, si se definió. |
Valor mínimo | El valor espacial más pequeño. |
Valor máximo | El valor espacial más grande. |
Valor promedio | El valor espacial promedio. |
Promedio Valor | El valor espacial medio. |
Iniciar una sesión de muestreo
En esta sección se explica cómo iniciar una sesión de muestreo con la herramienta del perfilador espacial y cómo guardar la muestra de la métrica espacial.
Ve a Herramientas > Métricas espaciales > Perfilador espacial. Esto abre el widget del perfilador espacial.
En la vista de árbol, selecciona las métricas que deseas medir en tu sesión de muestreo.
Establece tus parámetros de muestreo desde el menú desplegable.
Haz clic en Comenzar sesión para iniciar una partida a través del cliente de Fortnite.
(Opcional) Una vez que se cargue el cliente, presiona Finalizar partida para entrar en el Modo de edición, que permite a tu peón volar por el nivel más rápido.
Presione Iniciar muestreo.
En la sesión de juego, usa tu peón para volar por la isla y jugar el juego como está previsto. El mapa térmico del perfilador espacial se actualizará a medida que lo hagas.
Presiona el botón Detener muestreo para finalizar la sesión de muestreo.
Presiona el ícono Guardar en el widget del perfilador espacial y elige una ubicación del directorio local de tu proyecto. El generador de perfiles proporciona acceso de lectura a cualquier muestra guardada en el proyecto. Las muestras se organizan por tipo de métrica y fecha y hora.
Puedes hacer clic en el ícono Abrir para acceder a las grabaciones de muestras de proyectos anteriores.