Language:
Page Info
Tags:
Engine Version:
The translation of this page is out of date. Please see the English version for the latest version of the page.

ブループリントのデバッグ作業

ブループリントのデバッグは、 Play In Editor と Simulate In Editor モードで実行中のゲームを一時停止できる便利な機能です。ブレークポイントを利用してブループリントまたはレベルスクリプトの全てのグラフをステップスルーします。

デバッグ制御

デバッグ制御により Play In Editor や Simulate In Editor モードでのゲームの実行が制御されます。ゲームが実行されると、ブループリント エディタにおいて制御が有効化されます。デバッグ対象のブループリントのタイプや現在のデバッグステートに応じて、 ツールバー 上に表示されるデバッグ専用ボタンが異なります。

debugging_editor.png

ブループリント エディタ の ウィンドウ メニューから開くことができる [Debug] タブと ブループリント デバッガー は両方とも、 Simulate in Editor または Play in Editor モードがアクティブの時にその状況に応じてデバッグボタンが表示されます。

デバッグ制御により Play In Editor や Simulate In Editor モードでのゲームの実行が制御されます。ゲームが実行されると制御が有効化されます。デバッグ対象のブループリントのタイプや現在のデバッグステートに応じて、 [ツールバー] 上に表示されるデバッグ専用ボタンが異なります。ブレークポイント がヒットするなど、関連する場合のみ有効になる制御もあります。

blueprint_debugger.png

ブレークポイント

ブレークポイント は、エディタでのゲーム実行時に、ゲームの実行をあるポイントで一時停止することができます。ブループリントまたは Level ブループリントにグラフのブレークポイントは、すべて [Debug] タブに表示されます。このリストではブレークポイント名にハイパーリンクが付いているので、クリックすると [Graph] タブ内でブレークポイントに関連づいているノードに直接行くことができます。

ブレークポイントは、 Function CallsFlow Control オペレーションなど、実行されるグラフ内の全てのノード上に設定することができます。方法は、ノード上を右クリックして [Add breakpoint (ブレークポイントを追加)] を選びます。ブレークポイントをノード上に設定する時は、ノードの左上隅にグラフィックが表示されます。

Blueprint Debugging - Breakpoint Enabled

ブレークポイントは、ノード上を右クリックして [Disable breakpoint (ブレークポイントを無効にする)] を選ぶか、 [Debug] タブのブレークポイントの隣のアイコンをクリックしてオフに切り替える方法でも無効にできます。[Debug] タブでブレークポイントを右クリックして [Disable breakpoint] を選択しても無効にできます。

Blueprint Debugging - Breakpoint Disable Option

これにより、ノードが実行された時に、ブレークポイントはそのままにしながらゲームが停止されます。無効にされたブレークポイントは、アウトラインとして表示されます。

Blueprint Debugging - Breakpoint Disabled

無効化されたブレークポイントを有効化するには、ノードを右クリックして [Enable breakpoint (ブレークポイントを有効にする)] を選ぶか、 [Debug] タブのブレークポイントの隣のアイコンをクリックしても有効にできます。[Debug] タブでブレークポイントを右クリックして [Enable breakpoint] を選択しても有効にできます。

Blueprint Debugging - Breakpoint Enable Option

ブレークポイントは、ノードを右クリック、または [Debug] タブでブレークポイントを右クリックして [Remove breakpoint (ブレークポイントを取り除く)] を選択すれば取り除くことができます。

ブレークポイントがヒットすると、グラフはブレークポイントを含むノードに焦点を合わせ、ブレークポイントにインジケーターが表示されます。

Blueprint Debugging - Breakpoint Hit Indicator

さらに、デバッグの為ゲームが一時停止されたことをプレイヤーに警告するため、オーバーレイがビューポートに表示されます。

Blueprint Debugging - Viewport overlay

Debug タブとブループリント デバッガー

[Debug] タブはデザイナーが重要とみなした情報を、ブレークポイントとウォッチ値、および実行されたブループリントに属するすべてのノードのスタックのトレース (追跡) という形で表示します。このウィンドウには、ブレークポイント使用時のゲームの実行をコントロールするための制御が表示されます。

ウォッチ値

ウォッチ値 により、実行中の変数値を素早く簡単に確認できます。グラフをステップスル―する時にブレークポイントをヒットし更新すると、選択されたアクタおよび Level ブループリントに対する全てのウォッチ値が [Debug] ウィンドウに表示されます。

Blueprint Debugging - Watch Values

ウォッチされている値は、変数の上にバブルとしてグラフ中に直接表示されることもできます。

Blueprint Debugging - Watch Value Info Bubble

ウォッチ情報バブルの表示は、変数名の隣のメガネ (Blueprint Debugging - Watch Value Button) をクリックするだけで有効になります。

Execution Trace

Execution Trace スタックは、直近に実行されたノードのリストを上部に表示します。

Blueprint Debugging - Execution Trace Stack

このリストは、デバッグ中にグラフをステップスルーすると更新されます。

Tags