Compartilhar via

Exibir registro em log do Unreal Engine no Visual Studio

  • Artigo

Use o Visual Studio Tools for Unreal Engine (UE) para ver o registro em log da UE no Visual Studio. Isso é útil porque você pode ver o registro em log da UE sem precisar alternar entre o Editor do Unreal e o Visual Studio.

Pré-requisitos

O seguinte deve ser instalado:

Adicionar o registro em log do Unreal Engine a um exemplo e ver os resultados no Visual Studio

Depois de concluir o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e compilar o jogo Lyra, siga estas etapas para adicionar o registro em log do Unreal Engine ao exemplo de jogo Lyra e ver as mensagens de log no Visual Studio:

  1. No Visual Studio, abra LyraGameplayAbility_RangedWeapon.cpp. Pesquise esse arquivo no painel Pesquisa do Gerenciador de Soluções ou localize-o em Games>LyraStarterGame>Source>LyraGame>Weapons>LyraGameplayAbility_RangedWeapon.cpp.

  2. Em LyraGameplayAbility_RangedWeapon.cpp, vá para a linha 477. Você deverá ver essa função: void ULyraGameplayAbility_RangedWeapon::OnTargetDataReadyCallback

  3. Insira o seguinte código no início da função: UE_LOG(LogLyra, Log, TEXT("shot fired")); Isso cria uma entrada de log, associada à categoria LogLyra, que registra shot fired quando essa função é chamada.

  4. Execute o jogo de exemplo no Visual Studio escolhendo Depurar>Iniciar Depuração. Aguarde o Unreal Editor carregar o jogo Lyra.

  5. No Visual Studio, abra a janela de log da UE escolhendo Exibir>Outro Log>da Unreal Engine do Windows no menu principal do Visual Studio. Ou use o botão da barra de ferramentas da UE para mostrar o log. Para obter mais informações sobre a barra de ferramentas, consulte Barra de ferramentas do Unreal Engine.

  6. No Editor do Unreal, escolha o botão Reproduzir na barra de ferramentas (ou Alt+p) para iniciar o jogo.

  7. No jogo Lyra, use as teclas w,a, s, d para navegar o jogador à esquerda até o portal de Eliminação. Posicione o jogador sobre o portal de entrada para carregar o jogo.

  8. Depois que o jogo estiver em execução, clique no botão do mouse para disparar. Isso cria algumas entradas de log na categoria LogLyra. Agora LogLyra será exibido no filtro Categorias para a próxima etapa.

  9. Reduza o ruído de log filtrando tudo, exceto os eventos de categoria LogLyra na janela de log da UE da seguinte maneira: escolha a lista suspensa Categorias. Escolha (Selecionar Tudo) na parte superior da lista para limpar todas as fontes de log. Em seguida, selecione LogLyra. Na janela de log da UE, você deverá ver a mensagem de log: shot fired

    Uma captura de tela da janela Logs do Unreal Engine mostrando eventos de

    Os eventos ficam na parte inferior do log, então talvez você precise rolar para baixo para vê-los. Você também pode escolher o botão Limpar para limpar o log e, em seguida, disparar novamente para ver a mensagem de log.

Se você achar a cor da fonte difícil de ler, poderá ajustá-la em Ferramentas>Opções>Ambiente>Fontes e Cores. Altere a lista suspensa Mostrar configurações para: para Log da Unreal Engine. Em Exibir itens: selecione Log e altere a corde primeiro plano do Item para algo mais que seja mais fa´cil para você ver.

É conveniente ter a janela de registros em log da UE aberta enquanto você está depurando porque você não precisará alternar para o Editor do Unreal para vê-los.

Opções de registro do Unreal Engine

A partir do Visual Studio 2022 17.12, use Ferramentas>Opções>Unreal Engine para configurar a janela de registros do Unreal Engine. Na guia Geral, as seguintes opções para a janela de registros do Unreal Engine estão disponíveis na Log Tool Window:

Uma captura de tela das opções da janela Unreal Engine Log.

  • Limpar na inicialização: limpa a janela de registros quando o jogo é iniciado.
  • Lembrar filtros: lembra dos filtros definidos na janela de registros ao fechar o Visual Studio.
  • Solicitar mensagens JSON: solicita essas entradas de registro no formato JSON. O JSON oferece um formato estruturado fácil de analisar e processar programaticamente. Isso simplifica a extração de informações específicas de mensagens de log, como detalhes de erro, carimbos de data/hora e outros metadados.
  • Mostrar automaticamente: mostra a janela de log automaticamente quando jogo é iniciado no Visual Studio.

Conteúdo relacionado

Visual Studio Tools for Unreal Engine
Adicionar classes, módulos e plug-ins do Unreal Engine no Visual Studio
Exibir blueprints do Unreal Engine no Visual Studio
Exibir registro em log do Unreal Engine no Visual Studio
Exibir macros do Unreal Engine no Visual Studio