More than 1 year has passed since last update.

[UE4] ブロック崩しを作る #5 Debug (C++)

Last updated at 2022-03-04Posted at 2022-02-01

はじめに

この記事は [UE4] ブロック崩しを作る #4 PlayerController (C++) の続きになります。
第3, 4回では C++ を使いましたが、C++がうまく動かなかった時に、その原因を調べるデバッグ手法についてまとめます。

参考リンク

[UE4] UE_LOGについてあれこれ

ログ出力(コンソール画面)

UE_LOG を使って UE4 Editor の Output log にログを表示させる事ができます

使用例

PlayerController_BB.cpp

void APlayerController_BB::BeginPlay()
{
    :
    UE_LOG(LogTemp, Display, TEXT("Display log"));
    UE_LOG(LogTemp, Warning, TEXT("Warning log"));
    UE_LOG(LogTemp, Error, TEXT("Error log"));

出力例

第一引数に指定している LogTemp はカテゴリーです
第二引数に指定している Display などはVerbosityです
それぞれの引数にどのような値を指定できるかは下記のヒストリア様の記事が詳しいです
また、こちらのログファイルとしても出力されています。
- 出力される場所はプロジェクトフォルダの Saved → Logs の中のです。

ログ出力(ゲーム画面)

AddOnScreenDebugMessage はゲーム画面にログを表示させる事ができます。
（使いどころとしてはログではなくデバッグ出力？）

使用例

PlayerController_BB.cpp

void APlayerController_BB::BeginPlay()
{
    :
    GEngine->AddOnScreenDebugMessage(-1, 10.0f, FColor::Red, "Log");
    GEngine->AddOnScreenDebugMessage(-1, 10.0f, FColor::Blue, "Log2");
    GEngine->AddOnScreenDebugMessage(-1, 10.0f, FColor::Green, "Log3");

出力例

第１引数に指定している -1 は Key です
- 同じ Key の表示は１つしか画面に表示されません (Key = -1 だけは例外で同時にも表示できる)
- 使用例の Key = -1 を全て Key = 0 に変えると、最後の Green しか表示されなくなります
第２引数に指定している 10.0f は 表示時間 です。(10.0f = 10秒)
それぞれの引数にどのような値を指定できるかは公式のドキュメントが詳しいです
- ドキュメントにあるように第５引数、第６引数も指定できます
- 第５引数 bool bNewerOnTop
- 第６引数 const FVector2D & TextScale

Assert

UE4 では Assert というキーワードは使わず check, verify, ensure を使うようです。

使用例

PlayerController_BB.cpp

void APlayerController_BB::BeginPlay()
{
    Super::BeginPlay();
    APawn* pPawn = GetPawn();
    check(pPawn == nullptr); // わざと assert に引っかかるように判定を変更
    :

出力例

なんと check では Editorごと終了してしまいます
- 例外が発生したファイル名やその行数なども表示されるのですが、開発中にはちょっと使いづらそうです
check だけではなく verify もエディタごと終了してしまうのは同様のようです
ensure はエディタは終了しませんが、ゲームも止まることはありません
- Output Log には下記のようなログが出力されます
check, verify, ensure も次に紹介する Visual Studio で Attach している状態であれば発生時にデバッガで捕まるようになります