このチュートリアルでは、Chaos Visual Debugger (CVD) を使用してアプリケーションをリアルタイムにレコーディングし再生する方法について説明します。 ファイルに記録とは異なり、ライブ セッションのレコーディングは、ローカル (マシン) またはリモート (ネットワーク経由) で実行できます。 これは、その場でライブ デバッグを行う際に便利ですが、レコーディングを「.utrace」ファイルとして保存することで、後で確認したり共有したりできるようにもします。
ライブセッションをレコーディングする
このセクションでは、ローカル エディタのターゲット プリセットを使用して PIE セッションをレコーディングする方法と、他のすべてのターゲット タイプをレコーディングするプロセスについて学習します。
ローカル エディタ
ローカルまたはリモート マシンでライブ PIE セッションを録画して再生するには、次の手順に従います:
CVD で、レコーディングするデータ チャンネルを切り替えます。
Unreal Editor で、メインツールバーの「プレイ」ボタンをクリックして、PIE セッションを開始します。 PIE セッションは、CVD でのレコーディングの開始前または開始後に開始できます。
デフォルトでローカル エディタのターゲットが選択されているため、「ライブ セッションをレコーディングする」をクリックすることでレコーディングを開始できます。 レコーディング中は、このボタンが赤いレコーディングアイコンに変わります。
レコーディングを停止するには、レコーディングアイコンをハイライトしてから赤い四角アイコンをクリックします。 このプロセスでは、単一の「
.utrace」ファイルをアウトプットします。レコーディング中の場合は、既存の PIE セッションを終了して、新しいセッションを開始することができます。その場合、CVD がそのセッションに自動的に接続します。
その他すべてのターゲット
ローカルまたはリモートのマシンでゲームクライアント、サーバー、またはパッケージ化されたビルドをレコーディングおよび再生するには、次の手順を実行します:
ターゲットアプリケーションが実行されていることを確認します。
レコーディングするデータ チャンネルを切り替えます。
レコーディングの対象となるターゲットを選択するには、CVD のメイン ツールバーで、セッション ターゲットのドロップダウン メニューをクリックしてターゲットを選択します。
レコーディングを開始するには、CVD のメイン ツールバーで「ライブセッションをレコーディングする」をクリックします。 レコーディング中は、このボタンが赤いレコーディングアイコンに変わります。
レコーディングを停止するには、レコーディングアイコンをハイライトしてから赤い四角アイコンをクリックします。 このプロセスでは 1 つ以上の
.utraceファイルを暗号化します。
ゲームクライアントと CVD では GPU リソースが競合します。 CVD での再生に問題がある場合は、ゲームクライアントのフレームレートを制限するか、グラフィック品質を下げることができます。
(レガシー) コマンド ライン インターフェースでライブセッションをレコーディングする
レコーディングの開始と終了には、CVD の UI を使用することを推奨しますが、コマンドラインを使用して、PIE セッション、ゲームクライアントとサーバー、およびパッケージ化されたビルドをレコーディングすることもできます。 セッションはローカル (同じワークステーション上、または同じ PIE インスタンス内) でも、ネットワーク経由でも可能です。
データ チャンネルを有効にする
データ チャンネルを変更するには、ターゲット アプリケーションでコマンド ラインを開きます。 パッケージ化ビルドでは、バッククォート (`) を押します。
[newstate]を true または false に、[channelname]を目的のデータ チャンネルに置き換える以下のコンソール コマンドを入力します。p.Chaos.VD.SetCVDDataChannelEnabled [newstate] [channelname]次に例を示します:
Enter キーを押してコマンドを実行します。
複数のデータ チャンネルを有効化
複数のチャンネルをカンマで区切ってリストすることで、有効/無効を切り替えることができます。 次の例では、PostIntegrate チャンネルと シーン クエリのチャンネルを有効にしています:
p.Chaos.VD.SetCVDDataChannelEnabled true SceneQueries,PostIntegrate
事前定義データ チャンネルを有効化
事前定義された有効なチャンネルセットを使用してゲームクライアントまたはサーバーを起動する場合は、次のコマンドライン引数を追加します:
CVDDataChannelsOverride=[ChannelName1,ChannelName2]
次の例では、統合チャンネルとシーン クエリのチャンネルを有効にしています:
CVDDataChannelsOverride=SceneQueries,PostIntegrate
コマンドラインでレコーディングを開始する
レコーディングを開始するには、コマンドラインを開きます。
ローカルマシンで作業している場合は、次のコマンドを入力し、Enter キーを押して実行します。
p.Chaos.StartVDRecording サーバーリモートマシンで作業している場合は、次のコマンドを入力し、Enter キーを押して実行します:
p.Chaos.StartVDRecording サーバー [YOURWORKSTATIONIP]CVD メイン ツールバーで、「セッションに接続」をクリックします。 ライブセッションブラウザの選択されているライブセッションの隣で、ローカルトレースストアで実行されている利用可能なライブセッションを選択します。
(オプション) 複数のターゲットに接続する場合は、接続モードのドロップダウンメニューから「マルチソース」を選択します。
(ライブセッションブラウザダイアログで)「セッションに接続」をクリックします。 レコーディングが開始されると、「Chaos Visual Debugger での記録が進行中です...」という文字列が画面に表示されます。
レコーディングを停止するには、コマンドラインを開きます。 ローカルマシンで作業している場合は、次のコマンドを入力してEnter キーを押します。
p.Chaos.StopVDRecording サーバーリモートマシンで作業している場合は、次を入力します:
p.Chaos.StopVDRecording サーバー [YOURWORKSTATIONIP]
次の内容
次のチュートリアルでは .utraceファイルを見つけて、レコーディングを再生する方法を学びます。
Chaos Visual Debugger での再生
Chaos Visual Debugger でレコーディングを再生します。