在 Unreal Engine 中,GEngine->AddOnScreenDebugMessage 是一个常用的调试工具,它允许开发者在游戏的屏幕上直接显示调试消息。这在开发和测试过程中非常有用,尤其是当你想快速检查变量的值或确认代码路径被执行时。
基本用法
GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Red, TEXT("This is a debug message!"));
例子:在beginplay中加入该方法
void ALogTestActor::BeginPlay()
{
Super::BeginPlay();
GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Red, TEXT("This is a debug message!"));
}
显示效果:
在上面的代码中:
- 第一个参数
-1
表示这个消息的键。使用-1
会使消息显示在屏幕上,但不会替换任何现有消息。如果你使用特定的键(例如1
),那么使用该键的任何后续消息都会替换先前的消息。 - 第二个参数
5.f
是消息在屏幕上的持续时间(以秒为单位)。 - 第三个参数
FColor::Red
是消息的颜色。 - 最后一个参数是要显示的实际文本消息。
显示变量
int32 MyValue = 42;
FString Message = FString::Printf(TEXT("The value of MyValue is: %d"), MyValue);
GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Green, Message);
效果如下:
注意事项
- 使用
AddOnScreenDebugMessage
仅作为临时调试手段。在代码最终提交或发布之前,确保移除或注释掉所有此类调试消息。 - 这种方法在编辑器模式和开发构建中都有效,但在发布构建中可能不会显示,因为发布构建通常会禁用调试工具。