Generación de perfiles con Unreal InsightsProfiling with Unreal Insights

La información inreal es un sistema de generación de perfiles que recopila, analiza y visualiza datos de un motor inreal.Unreal Insights is a profiling system that collects, analyzes, and visualizes data from Unreal Engine. El sistema de generación de perfiles puede ayudarle a encontrar cuellos de botella y áreas de optimización donde el rendimiento de las aplicaciones podría usar un aumento.The profiling system can help you find optimization bottlenecks and areas where you apps performance could use a boost. Normalmente, se habilita la información no real directamente desde el editor, pero para HoloLens 2 deberá usar la línea de comandos.Normally, you enable Unreal Insights right from the editor, but for HoloLens 2 you'll need to use the command line.

ConfigurarSetup

No real le permite crear y configurar un "perfil personalizado" en el iniciador de HoloLens con los parámetros de la línea de comandos que permiten obtener información inreal.Unreal lets you to create and configure a "Custom Profile" in the HoloLens launcher with the command line parameters that enable Unreal Insights.

  1. Busque la dirección IP del equipo mediante el comando ipconfig en el símbolo del sistema.Find the IP address of your computer using the ipconfig command on the command prompt. La dirección IP es la dirección IPv4 que se muestra en ipconfig.The IP address is the IPv4 address listed by ipconfig. Tenga esto en cuenta para más adelante al establecer los parámetros de la línea de comandos.Keep this in mind for later when you set Command Line Parameters.

Importante

Si está detrás de una VPN, puede que necesite proporcionar la dirección IP proporcionada a través de la VPN en su lugar.If you're behind a VPN, you may need to provide the IP address provided via the VPN instead.

Captura de pantalla de los resultados de la línea de comandos para el comando ipconfig

  1. Vaya a la parte superior del panel de inreal Engine y Abra Device Manager en el botón Launch (iniciar ):Go to the top of the Unreal Engine panel and open Device Manager under the Launch button:

Captura de pantalla de las opciones de inicio con el administrador de dispositivos resaltado

  1. En el Device Manager, seleccione Agregar un dispositivo que no está en la lista:In the Device Manager, select Add an Unlisted Device:

Captura de pantalla del administrador de dispositivos abierto en el motor inreal

  1. Haga clic en seleccionar una plataforma y elija HoloLens:Click Select a platform and choose HoloLens:

Captura de pantalla de la lista desplegable Agregar dispositivo no enumerado con HoloLens resaltado

  1. Si utiliza IPoverUSB, escriba 127.0.0.1:10080 como identificador de dispositivo.If you're using IPoverUSB, enter 127.0.0.1:10080 as the Device Identifier. Escriba el usuario y la contraseña de HoloLens en sus respectivos campos y rellene el nombre para mostrar como desee.Enter your HoloLens user and password in their respective fields and fill Display Name as you wish.

Importante

El identificador de dispositivo es la dirección IP de HoloLens, no el equipo que ejecuta información inreal que encontró en el paso 1.The Device Identifier is the IP address of the HoloLens, NOT of the computer running Unreal Insights you found in step 1.

Captura de pantalla de los detalles del dispositivo HoloLens en el administrador de dispositivos

  1. Seleccione Agregar y la HoloLens debe aparecer en la lista de dispositivos del administrador de dispositivos:Select Add and your HoloLens should appear in the device list of the device manager:

Captura de pantalla de HoloLens agregada a la lista de dispositivos

LaunchLaunch

  1. Abra el iniciador del proyecto desde el panel de UE4 en el botón Launch (iniciar ):Open Project Launcher from the UE4 panel under the Launch button:

Captura de pantalla de opciones de inicio con el iniciador de proyecto resaltado

  1. Seleccione el + botón para crear un perfil personalizado en perfiles de inicio personalizados.Select the + button to create a custom profile under Custom Launch Profiles. Una vez creada, siempre puede editar este perfil más adelante:Once created, you can always edit this profile later:

Captura de pantalla del iniciador del proyecto con perfiles de inicio personalizados resaltados

  1. Seleccione el botón Editar perfil en el perfil de inicio personalizado de HoloLens y configure:Select edit profile button on the HoloLens custom launch profile and configure:
    • Seleccione Cook en el libro para habilitar la copia en el dispositivoSelect Cook to By the Book to enable copying to device
    • Es posible que desee comprobar ¿desea archivar? en la sección archivar para conservar el archivo. appxbundle generado en lugar de eliminarlo y ahorrar espacio en disco.You may want to check Do you wish to archive? in the Archive section to retain the generated .appxbundle rather than deleting to save disk space. Especifique una ubicación para el. appxbundle y cambie a una compilación de desarrollo si lo deseaSpecify a location for the .appxbundle and switch to a development build if you wish

Captura de pantalla de las opciones de Cook en configuración de perfil con Cook en el libro y HoloLens resaltados

  1. Establezca Cómo desea implementar la compilación para Copiar en el dispositivo y activar la sección Launch ( iniciar ) de la interfaz de usuario:Set How would you like to deploy the build? to Copy to device to activate the Launch section of the UI:

Captura de pantalla del iniciador del proyecto con opciones de implementación con la opción copiar en el dispositivo resaltada

  1. Establezca parámetros adicionales de la línea de comandos en la sección Launch (iniciar ).Set Additional Command Line Parameters in the Launch section. Los parámetros se escribirán en un archivo ue4commandline.txt, empaquetado en la agrupación y se usarán en el inicio.The parameters will be written into a ue4commandline.txt file, packaged into the bundle, and used at launch.
    • Pruébelos para los iniciadores: -tracehost = IP_OF_YOUR_PC-Trace = registro, marcador, fotograma, CPU, GPU, LoadTime, archivo, redTry these for starters: -tracehost=IP_OF_YOUR_PC -trace=Log,Bookmark,Frame,CPU,GPU,LoadTime,File,Net
    • Puede encontrar una lista completa de los parámetros de inicio disponibles en la documentación de referencia de Insights.You can find a complete list of available launch parameters in the Unreal Insights reference documentation.

Nota

"IP_OF_YOUR_PC" es la dirección IP que encontramos en el paso 1."IP_OF_YOUR_PC" is the IP address we found in step 1. Esta es la dirección IP del equipo que ejecuta información inreal, no la dirección IP de HoloLens.This is the IP address of the computer running Unreal Insights, NOT the IP address of the HoloLens.

Importante

Los seguimientos pueden llegar a ser grandes muy rápidamente.Traces can get large very quickly. Habilite solo los canales que necesita para mantener un tamaño de seguimiento bajo.Enable only those channels you need to keep trace size low.

Captura de pantalla de las opciones de configuración de inicio

  1. Inicie información no real antes del inicio de la aplicación, de lo contrario, la información no real no podrá inicializarse correctamente antes de la aplicación:Launch Unreal Insights BEFORE app launch, otherwise Unreal Insights wont be able to initialize appropriately before the app:
    • El ejecutable de Insights no real se almacena en la carpeta del motor de archivos binarios, normalmente de la siguiente manera: "C:\Archivos de Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"The Unreal Insights executable is stored in the binaries engine folder, usually as follows: "C:\Program Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"

Captura de pantalla del ejecutable inreal de Insights en ejecución

  1. Seleccione atrás para volver a la raíz del cuadro de diálogo del iniciador del proyecto .Select Back to return to the root of the Project Launcher dialog
  2. De nuevo en el editor, haga clic en iniciar en el perfil de inicio personalizado.Back in the editor, Click Launch on your custom launch profile

Captura de pantalla de perfiles de inicio personalizados

  1. Observe que el proyecto está empaquetado, instalado en el dispositivo e iniciadoWatch as your project is packaged up, installed on your device, and launched

Generación de perfilesProfiling

De nuevo en información no real, seleccione la conexión dinámica al dispositivo para iniciar la generación de perfiles.Back in Unreal Insights, select the Live connection to your device to start profiling

El perfil personalizado se comparte entre proyectos.The custom profile is shared between projects. Desde aquí, puede usar el perfil personalizado que creó en lugar de tener que hacerlo cada vez.From here on out, you can use the custom profile you created instead of having to do this every time. Solo tiene que volver a crear la conexión con el dispositivo cada vez que se inicia de un momento dado con los pasos 3 a 6 de la sección de configuración.You only need to recreate the connection to the device every time you start Unreal with steps 3 to 6 in the setup section.

Consulte tambiénSee also