> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# デバッグ トレース

> PlayFab Services SDK のデバッグ トレースを有効にします: 詳細度の設定、出力を Visual Studio デバッガーへのルーティング、ゲーム ログへの転送、またはトレースをファイルに書き込みます。

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

## 有効化と詳細度の設定

以下のコード例は、デバッグ トレースを有効にし、デバッグ エラー レベルを **Verbose** に設定します。デバッグ エラー レベルは、失敗した呼び出しのみをトレースする **Error** に設定することも、トレースを無効にする **Off** に設定することもできます。

結果として得られるデバッグ出力は、Visual Studio でプロジェクトを実行しているときに \[出力] ペインに送信されます。

```cpp theme={null}
HCSettingsSetTraceLevel(HCTraceLevel::Verbose);
HCTraceSetTraceToDebugger(true);
```

## ゲーム ログへの接続

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

```cpp theme={null}
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**](/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile) を呼び出し、トレース ファイルを作成するディレクトリを指定します。この関数は初期化後に呼び出してください。

```cpp theme={null}
PFTraceEnableTraceToFile("C:\\GameLogs\\PlayFabTraces");
```

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

## リファレンス

[PlayFab API リファレンス ドキュメント](/services/playfab/api-references/c/pftrace/pftrace_members)
[Trace API リファレンス ドキュメント](/reference/live/httpclient/trace/trace_members)


## Related topics

- [PlayFab 統合 SDK でのデバッグ トレース](/ja-jp/services/playfab/sdks/unified-sdk/debug-trace.md)
- [Game Saves クイックスタート](/ja-jp/services/playfab/player-progression/game-saves/quickstart.md)
- [クイックスタート Win32](/ja-jp/services/playfab/sdks/c/quickstart-win32.md)
- [PlayFab がサポートする言語](/ja-jp/services/playfab/sdks/languages/index.md)
- [クイックスタート iOS](/ja-jp/services/playfab/sdks/c/quickstart-ios.md)