Criação de perfil com Insights do UnrealProfiling with Unreal Insights

Insights inreais é um sistema de criação de perfil que coleta, analisa e visualiza dados de um mecanismo inreal.Unreal Insights is a profiling system that collects, analyzes, and visualizes data from Unreal Engine. O sistema de criação de perfil pode ajudá-lo a encontrar gargalos de otimização e áreas em que o desempenho de aplicativos poderia usar um aumento.The profiling system can help you find optimization bottlenecks and areas where you apps performance could use a boost. Normalmente, você habilita informações inreais diretamente do editor, mas para o HoloLens 2, você precisará usar a linha de comando.Normally, you enable Unreal Insights right from the editor, but for HoloLens 2 you'll need to use the command line.

InstalaçãoSetup

Inreal permite que você crie e configure um "perfil personalizado" no iniciador do HoloLens com os parâmetros de linha de comando que habilitam insights inreais.Unreal lets you to create and configure a "Custom Profile" in the HoloLens launcher with the command line parameters that enable Unreal Insights.

  1. Localize o endereço IP do seu computador usando o comando ipconfig no prompt de comando.Find the IP address of your computer using the ipconfig command on the command prompt. O endereço IP é o endereço IPv4 listado por ipconfig.The IP address is the IPv4 address listed by ipconfig. Tenha isso em mente para mais tarde quando você definir parâmetros de linha de comando.Keep this in mind for later when you set Command Line Parameters.

Importante

Se você estiver atrás de uma VPN, talvez seja necessário fornecer o endereço IP fornecido por meio da VPN.If you're behind a VPN, you may need to provide the IP address provided via the VPN instead.

Captura de tela dos resultados da linha de comando para o comando ipconfig

  1. Vá para a parte superior do painel de mecanismo inreal e abra Device Manager no botão Iniciar :Go to the top of the Unreal Engine panel and open Device Manager under the Launch button:

Captura de tela das opções de inicialização com o Gerenciador de dispositivos realçado

  1. Na Device Manager, selecione Adicionar um dispositivo não listado:In the Device Manager, select Add an Unlisted Device:

Captura de tela do Gerenciador de dispositivos aberta no mecanismo inreal

  1. Clique em selecionar uma plataforma e escolha HoloLens:Click Select a platform and choose HoloLens:

Captura de tela de adicionar lista suspensa de dispositivos não listados com o HoloLens realçado

  1. Se você estiver usando IPoverUSB, digite 127.0.0.1:10080 como o identificador do dispositivo.If you're using IPoverUSB, enter 127.0.0.1:10080 as the Device Identifier. Insira seu usuário e senha do HoloLens em seus respectivos campos e preencha o nome de exibição como desejar.Enter your HoloLens user and password in their respective fields and fill Display Name as you wish.

Importante

O identificador de dispositivo é o endereço IP do HoloLens, não o computador que executa informações invisíveis encontradas na etapa 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 tela dos detalhes do dispositivo do HoloLens no Gerenciador de dispositivos

  1. Selecione Adicionar e seu HoloLens deve aparecer na lista de dispositivos do Gerenciador de dispositivos:Select Add and your HoloLens should appear in the device list of the device manager:

Captura de tela do HoloLens adicionado à lista de dispositivos

InicializarLaunch

  1. Abra o inicializador de projeto no painel UE4 no botão Iniciar :Open Project Launcher from the UE4 panel under the Launch button:

Captura de tela das opções de inicialização com o iniciador do projeto

  1. Selecione o + botão para criar um perfil personalizado em perfis de inicialização personalizados.Select the + button to create a custom profile under Custom Launch Profiles. Depois de criado, você sempre poderá editar este perfil mais tarde:Once created, you can always edit this profile later:

Captura de tela do iniciador de projeto com perfis de inicialização personalizados realçados

  1. Selecione o botão Editar perfil no perfil de inicialização personalizada do HoloLens e configure:Select edit profile button on the HoloLens custom launch profile and configure:
    • Selecione o Cookie para o livro para habilitar a cópia para o dispositivoSelect Cook to By the Book to enable copying to device
    • Convém verificar se deseja arquivar? na seção arquivo morto para manter o. appxbundle gerado em vez de excluir para economizar espaço em 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 um local para o. appxbundle e alterne para uma compilação de desenvolvimento, se desejarSpecify a location for the .appxbundle and switch to a development build if you wish

Captura de tela de opções de Cook na configuração de perfil com o Cook pelo livro e o HoloLens realçado

  1. Defina como você deseja implantar a compilação? para copiar para o dispositivo para ativar a seção de inicialização da interface do usuário:Set How would you like to deploy the build? to Copy to device to activate the Launch section of the UI:

Captura de tela do iniciador de projeto com opções de implantação com cópia para dispositivo realçado

  1. Defina parâmetros de linha de comando adicionais na seção Iniciar .Set Additional Command Line Parameters in the Launch section. Os parâmetros serão gravados em um arquivo ue4commandline.txt, empacotados no pacote e usados na inicialização.The parameters will be written into a ue4commandline.txt file, packaged into the bundle, and used at launch.
    • Tente isso para os iniciantes: -tracehost = IP_OF_YOUR_PC-Trace = log, indicador, quadro, CPU, GPU, loadtime, File, netTry these for starters: -tracehost=IP_OF_YOUR_PC -trace=Log,Bookmark,Frame,CPU,GPU,LoadTime,File,Net
    • Você pode encontrar uma lista completa dos parâmetros de inicialização disponíveis na documentação de referência do insights não reais.You can find a complete list of available launch parameters in the Unreal Insights reference documentation.

Observação

"IP_OF_YOUR_PC" é o endereço IP que encontramos na etapa 1."IP_OF_YOUR_PC" is the IP address we found in step 1. Esse é o endereço IP do computador que está executando insights inreais, não o endereço IP do HoloLens.This is the IP address of the computer running Unreal Insights, NOT the IP address of the HoloLens.

Importante

Os rastreamentos podem ficar grandes muito rapidamente.Traces can get large very quickly. Habilite somente os canais necessários para manter o tamanho do rastreamento baixo.Enable only those channels you need to keep trace size low.

Captura de tela das opções de configuração de inicialização

  1. Inicie informações incorretas antes da inicialização do aplicativo; caso contrário, os insights não poderão ser inicializados adequadamente antes do aplicativo:Launch Unreal Insights BEFORE app launch, otherwise Unreal Insights wont be able to initialize appropriately before the app:
    • O executável insights não reais é armazenado na pasta do mecanismo de binários, geralmente da seguinte maneira: "C:\Program 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 tela de executáveis insights em execução

  1. Selecione voltar para retornar à raiz da caixa de diálogo iniciador do projetoSelect Back to return to the root of the Project Launcher dialog
  2. De volta ao editor, clique em Iniciar em seu perfil de inicialização personalizadoBack in the editor, Click Launch on your custom launch profile

Captura de tela de perfis de inicialização personalizados

  1. Assista à medida que seu projeto é empacotado, instalado em seu dispositivo e iniciadoWatch as your project is packaged up, installed on your device, and launched

Criação de perfilProfiling

De volta às informações inreais, selecione a conexão dinâmica com o dispositivo para iniciar a criação de perfilBack in Unreal Insights, select the Live connection to your device to start profiling

O perfil personalizado é compartilhado entre projetos.The custom profile is shared between projects. Daqui em diante, você pode usar o perfil personalizado criado em vez de ter que fazer isso todas as vezes.From here on out, you can use the custom profile you created instead of having to do this every time. Você só precisa recriar a conexão com o dispositivo toda vez que iniciar inreal com as etapas 3 a 6 na seção de instalação.You only need to recreate the connection to the device every time you start Unreal with steps 3 to 6 in the setup section.

Confira tambémSee also