ファイルに記録する | Unreal Engine 5.7 ドキュメンテーション

このチュートリアルでは、Chaos Visual Debugger (CVD) でビジュアライゼーションをレコーディングして「.utrace」ファイルとして保存する方法を学びます。ファイルに記録すると、ライブ再生のパフォーマンスオーバーヘッドを避けたい場合に役立ちます。

ビジュアライゼーションをリアルタイムにレコーディングする方法については、「ライブセッションをレコーディングする」を参照してください。

UI を使用してレコーディングを開始する

このセクションでは、ローカルエディタのターゲットプリセットを使用して PIE セッションをレコーディングする方法と、他のすべてのターゲットタイプをレコーディングするプロセスについて学習します。

ローカル PIE セッションをレコーディングおよび再生するには、次の手順に従います：

CVD の データチャンネルメニューで、レコーディングするデータチャンネルを切り替えます。
Unreal Editor で、メインツールバーの「プレイ」ボタンをクリックして、PIE セッションを開始します。 PIE セッションは、CVD でのレコーディングの開始前または開始後を選択できます。
ターゲットのローカルエディタがデフォルトですでに選択されているため、「ファイルに記録」をクリックすることでレコーディングを開始できます。レコーディング中は、このボタンが赤いレコーディングアイコンに変わります。
レコーディングを停止するには、レコーディングアイコンにカーソルを乗せて、赤い四角アイコンをクリックします。
このプロセスでは、単一の「.utrace」ファイルが、ダイアログボックスで「はい」をクリックすることで、レコーディング後直ちに読み込めるようになります。

レコーディング中の場合は、既存の PIE セッションを終了して、新しいセッションを開始することができます。その場合、CVD がそのセッションに自動的に接続します。

他のすべてのターゲットタイプをレコーディングするには、次の手順に従います：

ターゲットアプリケーションが実行されていることを確認します。
CVD で、レコーディングするデータチャンネルを切り替えます。
レコーディングの対象となるターゲットを選択するには、CVD のメインツールバーにあるセッションターゲットのドロップダウンメニューをクリックし、プリセットターゲットまたはカスタムターゲットを選択します。
レコーディングを開始するには、CVD のメインツールバーで「ファイルに記録」をクリックします。レコーディング中は、このボタンが赤いレコーディングアイコンに変わります。
レコーディングを停止するには、レコーディングアイコンをハイライトしてから赤い四角アイコンをクリックします。

単一のターゲットをレコーディングするか複数のターゲットをレコーディングするかに応じて、このプロセスでは 1 つ以上の「.utrace」ファイルを暗号化します。複数のターゲットをレコーディングしている場合は、レコーディングのロードを促すダイアログが表示されません。

レコーディングの開始と終了には、CVD の UI を使用することを推奨しますが、コマンドラインを使用して、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
レコーディングが開始されると、「Chaos Visual Debugger での記録が進行中です...」という文字列が画面に表示されます。
レコーディングを停止するには、コマンドラインを開き、次のコマンドを入力し、Enter キーを押して実行します。
p.Chaos.StopVDRecording