Skip to content

Latest commit

 

History

History
181 lines (89 loc) · 4.99 KB

README.md

File metadata and controls

181 lines (89 loc) · 4.99 KB
Raw

Unreal Logger

  1. 一个可跨平台，简单，轻量，易维护的UE日志工具
  2. 解决UE项目打包发行版后，查看项目中手动添加的PrintLog等相关操作，无法轻易查看日志的问题
  3. 基于WebSocket通信，可以本地使用，也可以部署云端

1. 结构介绍

UnrealLogger

  • UE_Logger
    • node_modules
    • logger.js Logger Server
    • package.json
    • package-lock.json
    • websocat.exe Windows Test Websocket Tool
  • UnrealLogger UE Plugin
  • .gitignore
  • README.md

Logger Server：使用nodejs开发

UE Plugin：使用UE 5.2开发，纯源码，需要使用C++项目编译，只用了UE模块，理论上该插件也支持全平台，足够多的UE版本

websocat.exe：启动Logger Server后，在Windows平台，可以简单使用该测试是否启用成功

2. 使用前提

  1. 系统运行环境需要nodejs, npm等
  2. UE项目是C++项目，添加该插件后，项目编译成功

3. 使用方法

部署LoggerServer

  1. 使用控制台进入UE_Logger目录

  2. 运行node logger.js启动 Logger Server

    • 默认启动的是 127.0.0.1:6666, 刷新间隔 16ms
    • 使用带参命令 node logger.js 127.0.0.1 7777 100可以该Logger Server的IP, Port, 刷新间隔
    • node logger.js <IP> <Port> <Interval>

  3. 启动后，在Windows环境下，可以直接使用websocat.exe测试

    • 建议新开一个控制台，同样的目录下websocat.exe ws://127.0.0.1:6666

    • 测试数据：

      • {"level":0, "content":"这是普通日志"}
      • {"level":1, "content":"这是警告日志"}
      • {"level":2, "content":"这是错误日志"}

      image-20241016110715719

UE 插件使用

注意：使用前，先确保 Logger Server已经启动，并测试通过

如果：先启动了UE 客户端，再启动 Logger Server，应该是无法连接的，可以在客户端程序中，可以手动或特定时机触发 MakeLoggerSetting方法

  1. 初始化 Logger System：初始化相关配置和启动WebSocket服务

    image-20241016111135588

  2. 查看PrintLog方法

    image-20241016111241741

  3. Log Type介绍：

    • Normal -> level: 0
    • Warning -> level: 1
    • Error -> level:2

  4. Log Setting：

    image-20241016111441276

  5. Log Screen Color，Log Screen Time和 UE printString同理

  6. 测试蓝图：

    image-20241016111612309

    运行结果：

    image-20241016111743694

    image-20241016111755695

  7. 结束打印

    image-20241016111826499

image-20241016111842718

4. UE客户端可能出现的问题

如果你电脑挂了代理，这个应该是代理的问题，关掉代理再测试

5. 云端部署

  1. 测试了一个Linux服务器，开发防火墙的6666端口
  2. 配置运行环境
  3. node logger.js 0.0.0.0:6666
  4. 在本地主机（windows）: websocat.exe ws://公网IP:6666即可

image-20241017174733239

补充更新

2024-10-16

image-20241016153058664

多了一个 IsUseWorldContextName，目的是方便查看日志打印时，可以看见这条日志打印的所在位置，比如：UI, Actor, Level等等；

优化了Logger Server的打印样式，使用绿色显示连接状态

image-20241016153349930

image-20241016153454816

2024-10-18

发送给Logger Server的日志，默认增加了时间戳 UE 发送日志的时间

image-20241018153952526

完善蓝图的使用体验，默认（WorldContextObject=Self, IsUseWorldContextName=True, LogType=Normal, Setting="Logger", LogScreenColor="0.0f, 0.66f, 1.0f, 1.0f", LogScreenTime=2.0f）

节点默认只显示LogText，LogSetting不再是结构体，而是默认折叠起来，和UE蓝图 printString节点相同

image-20241018173231908

2024-10-28

优化了 PrintLog节点默认的展开参数为：LogType, LogText，方便快速设置打印日志的类型，打印目标默认为Screen, UE_LOG, UnrealLogger 修复了，传入Json字符串，无法正确解析的问题（需要对传入字符内，所有的 ""做转义）

2024-10-29

  1. 修复打印json的相关问题
  2. 新增节点SetGlobalSetting，可以全局控制打印日志到何处

2024-10-31

经过一段时间的使用，发现LogType还是默认UE_Log-Logger比较舒服