Compartilhar via


Exibir o log do Mecanismo Do Unreal no Visual Studio

Use as Ferramentas do Visual Studio para UE (Mecanismo Unreal) 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 log do Unreal Engine a um projeto e ver os resultados no Visual Studio

Depois de concluir o Início Rápido: Ferramentas do Visual Studio para Unreal Engine para baixar e criar o jogo Lyra, siga estas etapas para adicionar o log do Unreal Engine ao exemplo de jogo do 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. Dê ao Editor do Unreal alguns instantes para carregar o jogo Lyra.

  5. No Visual Studio, abra a janela de log da UE escolhendo Exibir>Outras Janelas>Log do Unreal Engine no menu principal do Visual Studio. Ou use o botão da barra de ferramentas 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 Jogar na barra de ferramentas (ou Alt+p) para iniciar o jogo.

  7. No jogo Lyra, use as teclas w, a, s, d para mover o jogador para a 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 aparecerá 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 Log do Mecanismo Unreal mostrando eventos 'disparados' e a lista suspensa Categorias com LogLyra selecionado.

    Os eventos estão na parte inferior do log, portanto, 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>>Ambiente>Fontes e Cores. Altere a lista suspensa Mostrar configurações para: para Log do Unreal Engine. Em Exibir itens: selecione Log e altere a cor de primeiro plano do Item para algo mais que seja mais fá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 log do Unreal Engine

A partir do Visual Studio 2022 17.12, você pode configurar a janela de log do Mecanismo Unreal. Escolha Ferramentas>Opções>Unreal Engine>Janela de Ferramenta de Log para ver as seguintes opções:

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

  • Lembre-se dos filtros: lembre-se dos filtros definidos na janela de log ao fechar o Visual Studio.
  • Limpar na inicialização: desmarque a janela de log quando o jogo for iniciado.
  • Solicitar mensagens JSON: solicite as entradas de log no formato JSON. O JSON fornece um formato estruturado que é fácil de analisar e processar programaticamente. Isso torna mais simples extrair informações específicas de mensagens de log, como detalhes do erro, carimbos de data/hora e outros metadados.
  • Mostrar automaticamente: Mostrar a janela de log automaticamente quando o jogo for iniciado no Visual Studio.

Ferramentas do Visual Studio para Unreal Engine
Adicionar classes, módulos e plug-ins do Mecanismo Unreal no Visual Studio
Exibir Blueprints do Unreal Engine no Visual Studio
Exibir o log do Unreal Engine no Visual Studio
Exibir macros do Unreal Engine no Visual Studio