デバッグトレース - XBOX Game Development Documentation

この PlayFab SDK は拡張可能なデバッグトレースをサポートします。エラーに遭遇していて、ゲームがどのような呼び出しを行い、サーバーがどのような結果を返すかを完全に把握したいときは、デバッグトレースを使用します。トレースの詳細度を制御し、ゲーム独自のデバッグログと統合するオプションがあります。また、Visual Studio の [出力] ペインに出力を送ることもできます。

有効化と詳細度の設定

以下のコード例は、デバッグトレースを有効にし、デバッグエラーレベルを Verbose に設定します。デバッグエラーレベルは、失敗した呼び出しのみをトレースする Error に設定することも、トレースを無効にする Off に設定することもできます。結果として得られるデバッグ出力は、Visual Studio でプロジェクトを実行しているときに [出力] ペインに送信されます。

HCSettingsSetTraceLevel(HCTraceLevel::Verbose);
HCTraceSetTraceToDebugger(true);

ゲームログへの接続

PlayFab のトレースデバッグをゲーム独自のデバッグログに接続するには、HCTraceSetClientCallback を使用します。PlayFab のトレース出力を受け取ってゲームログに送るコールバックを指定します。

void CALLBACK TraceCallback(
    _In_z_ char const* areaName,
    enum HCTraceLevel level,
    uint64_t threadId,
    uint64_t timestamp,
    _In_z_ char const* message
)
{
    // Log info
}

HCTraceSetClientCallback(TraceCallback);

トレースをファイルに書き込む

PlayFab のトレース出力をディスク上のログファイルに書き込むには、PFTraceEnableTraceToFile を呼び出し、トレースファイルを作成するディレクトリを指定します。この関数は初期化後に呼び出してください。

PFTraceEnableTraceToFile("C:\\GameLogs\\PlayFabTraces");

この関数は、上記の HCTrace 関数とは独立しています。ファイルトレースをデバッガー出力およびクライアントコールバックと併用できます。

リファレンス

PlayFab API リファレンスドキュメント Trace API リファレンスドキュメント

​有効化と詳細度の設定

​ゲーム ログへの接続

​トレースをファイルに書き込む

​リファレンス

有効化と詳細度の設定

ゲームログへの接続

トレースをファイルに書き込む

リファレンス