> ## 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**](/zh-TW/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile)，並傳入應建立追蹤檔案的目錄。請在初始化之後呼叫此函式。

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

此函式與上述 HCTrace 函式彼此獨立。您可以將檔案追蹤與偵錯工具輸出和用戶端回呼搭配使用。

## 參考

[PlayFab API 參考文件](/zh-TW/services/playfab/api-references/c/pftrace/pftrace_members)
[Trace API 參考文件](/zh-TW/reference/live/httpclient/trace/trace_members)


## Related topics

- [PlayFab Unified SDK 中的偵錯追蹤](/zh-TW/services/playfab/sdks/unified-sdk/debug-trace.md)
- [Game Saves 快速入門](/zh-TW/services/playfab/player-progression/game-saves/quickstart.md)
- [Android 快速入門](/zh-TW/services/playfab/sdks/c/quickstart-android.md)
- [GDK 快速入門](/zh-TW/services/playfab/sdks/c/quickstart-gdk.md)
- [iOS 快速入門](/zh-TW/services/playfab/sdks/c/quickstart-ios.md)