Kismet ビジュアル デバッガーユーザーガイド

概要

Kismet ビジュアル デバッガーを使用することによって、Kismet のシーケンスの流れをリアルタイムに追跡することができます。そのためには、シーケンスオブジェクト上で ブレークポイント が使用されます。これによって、シーケンスオブジェクトがアクティベートされたときにゲームの実行が一時停止されます。Kismet ビジュアル デバッガーが有効になるのは、エディタの Play In Editor (PIE) 機能が使用されている場合に限ります。

Kismet ビジュアル デバッガー ウインドウ

リアルタイムの Kismet デバッグを有効 / 無効にするには、エディタのメインツールバーにある Toggle Realtime Debugging (リアルタイム デバッグの切り替え) ボタンをクリックします。

PIE がアクティブな間は、リアルタイムデバッグを有効 / 無効にすることができません。

有効になった場合は、PIE が使用されているならば、現在開いているあらゆる Kismet ウインドウが debugger (デバッガー) モードに切り替わります。PIE が終了すると、Kismet ウインドウも通常の状態に戻ります。

PIE がアクティブな状態で Kismet ウインドウを閉じた場合は、エディタのメインツールバーにある Kismet ボタンをクリックするだけで再び開くことができます。

図式パネルの左上隅には情報ボックスがあり、ゲームが一時停止すると、ゲームの現在の実行時間と Execution Paused! (実行中止!) という通知が表示されます。

アクティブなリンクは白で表示されます。アクティブなオブジェクトは白い枠が付き、その上方に情報ボックスが置かれて、これまでアクティベートされた回数、および、このオブジェクトが最後にアクティベートされた時間が表示されます。

オブジェクト左上隅のオレンジの矢印は、どのオブジェクト上で Kismet ウインドウが現在一時停止しているかを示しています。

ブレークポイント

リアルタイムデバッグが有効な場合、Kismet 内のシーケンスオブジェクト上にブレークポイントを設定すると、PIE が有効な間にそのシーケンスアクションがアクティベートされた場合はいつでも、ゲームが一時停止します (また、Kismet ビジュアル デバッガー ウインドウにフォーカスされます)。ブレークポイントの使用目的は、Kismet シーケンス内のイベントの順序に沿って適切に追跡調査できるようにすることにあります。

ブレークポイントは、あらゆるシーケンスアクション、条件、イベントに追加することができるとともに、そこから削除することもできます。そのためには、Kismet の図式パネル内でオブジェクトを右クリックして、Set Breakpoint on selected object(s) (選択されたオブジェクトにブレークポイントをセットする) または Remove Breakpoint on selected object(s) (選択されたオブジェクトのブレークポイントを削除する) を選択します。

複数のシーケンスオブジェクトが選択された場合は、選択されたオブジェクトそれぞれにブレークポイントが追加されます (または、それぞれから削除されます)。

ブレークポイントがあるシーケンスオブジェクトには、オブジェクトの左上隅近くに赤い丸印がつきます。

ブレークポイントは、有効 / 無効を切り替えることもできます。そのためには、Alt キーを押下しながらシーケンスオブジェクトを左クリックします。

また、エディタ内で現在開いているすべてのレベルのブレークポイントをすべて解除するには ツールバーボタンを使用します。

Kismet ウインドウがデバッガーモードにあるか否かにかかわらず、ブレークポイントをシーケンスオブジェクトに追加したり、そこから削除したりすることが可能です。

リアルタイムデバッグが有効になっている場合、PIE がアクティブな状態で、ブレークポイントをともなったシーケンスオブジェクトがアクティベートされると、ゲームの実行が一時停止されて、デバッグモードの Kismet ウインドウが開き (まだ開いていなかった場合)、シーケンスオブジェクトが Kismet ウインドウの図式パネルの中央に来ます。

ツールバーボタン

アイコン	説明
	Pause (一時停止) ゲームの実行を一時停止します。 (Alt+F7)
	Continue (再開) ゲームの実行を再開します。 (Alt+F8)
	Run to next action (次のアクションまで実行) 次のシーケンスオブジェクトまでゲームを実行します。詳細は下記を参照してください。(Alt+F10)
	Step through (ステップ実行) 1 ゲーム時間単位分 / ティック分ゲーム時間をインクリメントします。(Alt+F9)

Run To Next (次まで実行) ボタンには3 つの異なる動作があります。これらはボタンを右クリックすることによって表示されます。

Any を選択すると、次にアクティベートされるシーケンスオブジェクトまで実行されます。Downstream を選択すると、現在一時停止しているオブジェクトのすぐ次に来るシーケンスオブジェクトが次にアクティベートされる時まで実行されます。Selected を選択すると、現在選択されているシーケンスオブジェクトが次にアクティベートされるまで実行されます。

キーボードのショートカット