O que há de novo?
A Visão em Árvore permite selecionar as métricas que você deseja medir e obter os resultados rapidamente.
O sistema de sessões permite amostrar várias fontes simultaneamente.
A barra de pesquisa permite que você encontre rapidamente a métrica necessária.
Você pode abrir várias sessões salvas para uma comparação mais fácil, sem precisar fechar a sessão que está em execução no momento.
Você pode capturar métricas simultaneamente de várias fontes.
A visão do histograma permite se aprofundar na distribuição de cada métrica durante o período de amostragem.
Prefixos são adicionados automaticamente aos arquivos salvos para facilitar a identificação das sessões.
O Unreal Editor para Fortnite (UEFN) oferece as ferramentas necessárias para entender e melhorar o desempenho do seu projeto. Como o Fortnite é executado em muitas plataformas, conhecer métricas específicas para o seu projeto significa que você pode fazer os ajustes necessários para garantir um bom desempenho nas suas experiências com o UEFN.
Acesse Iniciar uma sessão de amostragem para ver o fluxo de trabalho ou continue lendo para ver a ferramenta Gerador de Perfil Espacial em detalhe.
Termos úteis
Uma métrica espacial é medida para qualquer propriedade que use uma posição espacial 3D em um mundo. Ela consiste em um certo número de valores espaciais, cada um com um número que corresponde a uma medida, com uma coordenada associada que dá a posição espacial onde o valor foi medido no mundo.
Um valor espacial é uma medida concreta de uma métrica espacial em uma posição 3D. Valores espaciais têm três valores de coordenadas espaciais: X, Y, Z e um valor de resultado de medição. Valores espaciais são agregados em uma amostra de métrica espacial.
Uma amostra de métrica espacial é uma medida de uma métrica espacial concreta durante um período definido. Ela pode conter vários valores espaciais medidos com um resultado associado. Uma amostra também inclui outros dados relevantes, como o delimitador 3D que engloba todos os valores espaciais envolventes, a precisão da distância usada e a data em que foi obtida.
As propriedades de métricas espaciais representam todas as informações incluídas em uma amostra de métricas espaciais:
| Propriedade | Definição |
|---|---|
ID da métrica | Define o identificador exclusivo da métrica, que está diretamente vinculado ao tipo de métrica. |
Valor mínimo | O valor mínimo entre os valores espaciais registrados. |
Valor Máximo | O valor máximo entre os valores espaciais registrados. |
Valor do limiar | O valor máximo esperado para a métrica. |
Precisão espacial | O tamanho da célula 3D usado em unidades mundiais, para que todos os valores contidos contribuam para o mesmo valor espacial. Normalmente, o valor mais alto é selecionado. |
Unidade | A unidade usada pelos valores registrados, por exemplo, milissegundos para tempo ou metros para distância. |
O Gerador de Perfil Espacial é um widget de visualização que fornece um mapa de calor 2D de métricas espaciais. Aqui você também pode registrar, salvar e carregar amostras de métricas espaciais. Ele coleta dados da função de atualização de métricas espaciais, o que significa que os dados são atualizados periodicamente.
O editor do UEFN com a janela acoplada do Gerador de Perfil Espacial.
No momento, o Gerador de Perfil Espacial oferece suporte a sete métricas espaciais:
| Métrica | Definição | Unit |
|---|---|---|
Contagem de draw call | Rastreia o número de draw calls em um único quadro. | Draw calls |
Contagem de primitivas | Rastreia o número de primitivas renderizadas em um único quadro. As primitivas são os componentes básicos de desenho usados para renderizar objetos em 3D. | Primitivas |
Tempo de atualização do jogo | Rastreia o thread de jogo da plataforma, medindo o tempo necessário para atualizar um único quadro. | Microssegundos |
Tempo de renderização | Rastreia o thread de renderização da plataforma, medindo o tempo necessário para atualizar um único quadro. | Microssegundos |
Tempo do quadro | Rastreia o tempo necessário para atualizar um único quadro. Tanto as métricas de tempo de atualização do jogo quanto tempo de renderização estão incluídas nessa métrica. | Microssegundos |
Hora da GPU | Rastreia a hora da GPU da plataforma. | Microssegundos |
Hora do RHI | Rastreia a hora do thread da interface de hardware de renderização da plataforma. | Microssegundos |
Contagem de atores | Rastreia o número de atores no mundo responsáveis por eventos de transmissão. Especialmente útil para mundos com a transmissão World Partition habilitada. Ver contagens inconsistentes de atores no nível pode destacar as áreas mais importantes da jogabilidade. No entanto, contagens realmente elevadas de atores também podem indicar um número excessivo de pequenos atores e um possível ponto de tensão para a experiência. É uma boa ideia avaliar essa métrica junto com Tempo de atualização do jogo para avaliar a complexidade da lógica do jogo ou com Tempo de renderização para avaliar a complexidade da renderização. | Actors |
Contagem de construções | Uma versão especializada da métrica "contagem de atores" que rastreia o número de atores categorizados como construções. Essa categoria também inclui outros tipos de atores de malha estática persistentes. | Actors |
Contagem de contêineres de saque | Uma versão especializada da métrica "contagem de atores" que rastreia o número de atores categorizados como contêineres de saque. Essa categoria inclui atores como baús, caixas de munição e outros geradores de coleta. | Actors |
Contagem de coletas | Uma versão especializada da métrica "contagem de atores" que acompanha o número de atores categorizados como coletas. Essa categoria inclui itens de jogabilidade saqueáveis. | Actors |
Uso de Memória | Rastreia o uso de memória executável da plataforma. Você pode usar isso para avaliar os requisitos de memória de cada plataforma em que a experiência deve ser executada. | Quilobytes |
Memória disponível | Monitora a memória física disponível da plataforma. Você pode usar isso para avaliar os requisitos de memória de cada plataforma em que a experiência deve ser executada. | Quilobytes |
Interface de usuário do Gerador de Perfil Espacial
O Gerador de perfil espacial é um widget independente encaixável dividido em quatro áreas:
Áreas do widget Gerador de Perfil Espacial.
Barra de ferramentas de controle
Visualização do mapa de calor
Visão em árvore de métricas
Visão do histograma
Barra de ferramentas de controle
Essa área contém os principais elementos interativos para operar o Gerador de perfil espacial. Ela fornece os controles para produzir, visualizar e salvar amostras de Métricas espaciais. Você pode usar as amostras capturadas para gerar dados que podem melhorar sua experiência no UEFN.
Elementos da barra de ferramentas de controle do Gerador de Perfil Espacial.
A barra de ferramentas de controle inclui os seguintes elementos:
Iniciar amostragem: inicia a captura do conjunto de métricas selecionadas pelo usuário. Você precisa estar conectado a uma sessão do UEFN para obter uma amostra das métricas. Durante a amostragem, o mapa de calor centraliza automaticamente a visualização na localização do pawn do jogador da sessão e concentra-se nos valores espaciais capturados.
Parar amostragem: interrompe a captura das métricas selecionadas.
Abrir um arquivo de amostra: abre um arquivo de amostra pré-existente, que pode conter várias métricas. Na abertura, todas as métricas são carregadas no navegador de métricas para que você possa avaliar os dados.
Salvar uma amostra em arquivo: você pode usar esse botão para salvar sessões de criação de perfil ativas. Ele abre uma caixa de diálogo para salvar em arquivo e propõe um nome de arquivo com o carimbo de data/hora da amostra por padrão. O Gerador de perfil espacial salva todas as métricas da sessão de amostragem atual no arquivo de destino.
Seletor de sessão do UEFN: você pode ter mais de um cliente conectado a uma sessão. É possível usar o seletor de sessão para escolher qual sessão conectar e executar métricas. O Gerador de perfil espacial se conecta automaticamente ao cliente ao iniciar uma sessão e, em seguida, atualiza o seletor de sessão com o nome do usuário conectado a essa sessão.
Configurações: esse botão exibe as configurações de preferências do Gerador de Perfil Espacial. Você pode usá-lo para alternar a visibilidade de determinados elementos do widget.
Visualização em árvore de métricas
Esta seção permite marcar e desmarcar as métricas desejadas em sua sessão de amostragem clicando nas caixas de seleção à esquerda das métricas.
O campo do menu suspenso superior é usado para escolher entre uma sessão ao vivo e uma sessão salva anteriormente. Você pode alternar entre sua sessão de amostragem atual e uma sessão salva selecionando a sessão que deseja visualizar no menu suspenso.
Com o segundo menu suspenso, você pode alternar entre os alvos de amostragem na sua sessão ao vivo, como clientes ou o servidor. Você pode monitorar as métricas de todos os clientes conectados e amostrar várias fontes ao mesmo tempo.
A barra de pesquisa permite procurar uma métrica específica.
Quando você clica em uma métrica para selecioná-la, a visualização do mapa de calor é atualizada para mostrar todas as amostras de dados, e a visualização de estatísticas é atualizada para exibir as estatísticas agregadas dos dados. Os círculos coloridos ao lado de cada métrica representam seus valores relativos com base nos limites que você define antes da sessão de amostragem, mostrando seus resultados rapidamente.
Visualização do mapa de calor
A Visualização do mapa de calor exibe um mapa térmico da métrica escolhida, com uma sobreposição de todos os valores espaciais na amostra. Cada valor espacial é colorido de acordo com os dados da amostra. Você pode definir valores de corte rapidamente para cada métrica a fim de especificar o intervalo de valores esperados.
Você pode interagir com o mapa de calor e personalizá-lo de acordo com suas preferências usando os quatro botões na parte superior:
Menu de hambúrguer
Mostrar Opções
Jogador em Foco
Limites de foco
Clicar duas vezes em qualquer local na Visualização do mapa de calor coloca a câmera do Editor no local correspondente dentro do projeto. Se uma sessão for iniciada, o pawn de jogador se teletransportará para o local onde você clicar duas vezes.
Menu de hambúrguer
Esse botão dá acesso às opções de visualização do mapa de calor, contendo duas seções:
Configurações de métricas
Configurações de cor do mapa de calor
As opções do menu de hambúrguer do Gerador de Perfil Espacial.
Você pode restaurar as configurações nessas seções clicando no botão de seta de restauração no lado direito de cada campo.
Configurações de métricas
O grupo de configurações de métricas contém todas as configurações que afetam a visualização das métricas.
| Valor | Definição |
|---|---|
Limite | Um valor limite define o valor máximo esperado para uma jogabilidade normal. |
Unidade de exibição | Quando especificada, essa opção define a unidade de visualização preferida para uma métrica. Se não for especificado, a ferramenta selecionará a melhor unidade de ajuste para cada métrica. A unidade de exibição afeta as unidades usadas pela visualização do mapa de calor e pela visualização de resumo. |
Método da célula | Essa configuração especifica o método de redução que a ferramenta usa para calcular cada valor de célula 2D a partir da lista de valores que estão dentro dos limites de cada célula. Os métodos de redução disponíveis são:
|
Tamanho da célula | Essas configurações alteram o tamanho da grade e podem aumentar ou diminuir o nível de detalhe para uma área de amostragem específica. |
Configurações de cor do mapa de calor
As configurações de cores do mapa de calor contêm todas as configurações que afetam a visualização das métricas.
As cores de calor oferecem uma paleta de cores legível com considerações para daltonismo. Você pode definir as cores principais para personalizar a faixa de cores do mapa de calor.
| Valor | Definição |
|---|---|
Baixa | Essa cor representa o espectro baixo da faixa de cores do mapa de calor e é mapeada para o valor mínimo em uma amostra de métrica. |
Ponto médio | Essa cor representa o meio da faixa de cores do mapa de calor definida entre a cor mínima e a limiar. Se um valor limite não for especificado, ele será mapeado para o valor espacial mediano em uma amostra. |
Alta | Essa cor representa todos os valores acima do limite definido. |
Máx | Essa cor representa o valor máximo. Apenas é exibida quando os usuários definem um valor limite para a métrica representada. Quando você especifica um valor limite, o mapa de calor adiciona um intervalo que excede o limite, indo do branco até a cor definida como Máxima. |
Alfa mínimo | O valor inicial dado aos valores espaciais. O valor alfa de todos os valores espaciais em uma amostra aumenta de acordo com seu valor, do valor Mínima (usando Alfa mín.) até os valores Máxima ou Limite com alfa máximo. Usar um valor Alfa mín. baixo destaca os valores espaciais mais próximos dos valores Máxima ou Limite, tornando os valores espaciais baixos menos visíveis. |
Alfa máximo | O valor inicial máximo dado aos valores espaciais. |
As Configurações de alfa mostram valores espaciais fora do intervalo esperado. Ajustar essas opções torna-se especialmente útil ao observar uma amostra de métrica com bolsões de valores espaciais de alta densidade, pois você pode obter uma leitura mais granular das métricas.
Eixos
Essa opção alterna a visualização dos eixos 3D no canto inferior esquerdo correspondente à orientação de cima para baixo da Visualização do mapa de calor. Essa orientação está em paridade com a visualização do minimapa do cliente e não com a do Editor.
Mostrar eixos do mapa de calor
Grade
Alterna a visualização da grade do mapa de calor 2D, subdividindo o espaço visível em múltiplos das extensões do valor da amostra. O tamanho da grade pode ser modificado no menu de hambúrguer
Legenda do mapa de calor
Essa opção ativa ou desativa a visualização da legenda da faixa de cores do mapa de calor no canto inferior direito da Visualização do mapa de calor.
Exibindo a legenda da paleta de cores do mapa de calor
Limites
Essa opção permite alternar a caixa delimitadora 2D, que compreende todos os valores espaciais na amostra.
Mostrando os limites de amostra (branco) no mapa de calor
Jogador em Foco
Esse botão centraliza a visualização em torno do pawn do jogador na sessão conectada. Essa ação requer uma sessão conectada.
Limites de foco
Esse botão centraliza a Visualização do mapa de calor em torno da caixa delimitadora 2D.
Menu contextual
Você pode acessar o menu contextual clicando com o botão direito na área da Visualização do mapa de calor. Esse menu contém as seguintes opções:
teletransportar
Visualização padrão
Limites de foco
Posição do foco da faixa
O menu contextual da visualização do mapa de calor do Gerador de Perfil Espacial
teletransportar
Você pode usar essa opção para trazer a visão da câmera e o pawn do jogador até um local escolhido com o botão direito do mouse na Visualização do mapa de calor. Essa ação requer uma sessão conectada para teletransportar o pawn do jogador. Se nenhuma sessão estiver conectada, isso será equivalente a clicar duas vezes em qualquer local na Visualização do mapa de calor, o que coloca a câmera do Editor no local correspondente dentro do projeto.
Visualização padrão
Essa opção restaura as configurações padrão dos valores de foco e zoom da Visualização do mapa de calor.
Visão do histograma
O histograma ajuda a visualizar os dados enquanto são coletados em tempo real. Você pode voltar no teste do nível e avaliar cada métrica em um ponto específico no seu teste de jogo. Ao percorrer o histograma da sessão aberta, você pode identificar a posição de uma leitura específica que deseja pesquisar.
Ajustar os valores no menu de hambúrguer modificará os vários pontos de corte exibidos no histograma.
Clicando com o botão direito do mouse no histograma permite selecionar Exibir diretrizes de limite, Rolagem automática, Sombrear valores por célula, escolher os valores próximo e anterior, e dimensionar o histograma. Você pode alterar a escala do histograma segurando SHIFT e rolando a roda do mouse.
Você também pode ampliar e reduzir o histograma para obter uma visão mais detalhada das suas métricas.
Quando você passa o mouse sobre um segmento da amostra, uma dica de ferramenta exibirá seu valor.
Clicando no segmento de amostra, a posição do segmento no mapa de calor recebe destaque.
À direita do histograma, você pode ver um resumo das estatísticas da métrica selecionada. Ela exibe as seguintes estatísticas compiladas a partir dos valores espaciais da amostra:
| Estatísticas | Definição |
|---|---|
Valores | O número total de valores espaciais incluídos na amostra. |
Alta | O número de valores espaciais que ultrapassam o valor limite, se definido. |
Valor mínimo | O menor valor espacial. |
Valor máximo | O maior valor espacial. |
Valor médio | O valor espacial médio. |
Valor mediano | O valor espacial mediano. |
Como iniciar uma sessão de amostragem
Essa seção aborda como iniciar uma sessão de amostragem usando a ferramenta Gerador de perfil espacial e mostra como salvar sua amostra de métrica espacial.
Acesse Ferramentas, Métricas espaciais, Gerador de Perfil Espacial. Isso abre o widget Gerador de perfil espacial.
Na Visão em Árvore, selecione as métricas que deseja medir na sessão de amostragem.
Defina seus parâmetros de amostragem no menu de hambúrguer.
Clique em Iniciar Sessão para iniciar um jogo por meio do cliente do Fortnite.
(Opcional) Assim que o cliente for carregado, pressione Fim de Jogo para entrar no modo de edição, que permite que seu pawn voe pelo nível mais rapidamente.
Pressione Iniciar amostragem.
Na sessão de jogo, use seu pawn para correr pela ilha e jogar como planejado. O mapa de calor do Gerador de Perfil Espacial será atualizado conforme você faz isso.
Pressione o botão Parar amostragem para encerrar a sessão de amostragem.
Pressione o ícone Salvar no widget do Gerador de Perfil Espacial e escolha uma posição dentro do diretório local do seu projeto. O Gerador de Perfil fornece acesso de leitura a qualquer amostra salva no projeto. As amostras são organizadas por tipo de métrica e carimbo de data/hora.
Você pode clicar no ícone Abrir para acessar qualquer gravação de amostra de projetos anteriores.
